Welcome to the JBoss Fuse on OpenShift workshop!
The labs for this workshop will guide you through using JBoss Fuse integration components on a docker-based PaaS – OpenShift v3 This getting started guide will walk you through setting up the following components
- JBoss Developer Studio
- OpenShift v3 client tools
- Github.com account
- Docker and OpenShift on your local machine (optional)
To install JBoss Developer Studio (JBDS), first download the distribution appropriate for your operating system. You can select either the full installation (bundled with EAP) or the stand-alone installer (an executable Java JAR). Navigate to the download page
Once you’ve downloaded the distribution, you can run the installer by either double-clicking the jar in your file-system explorer, or you can run from the command line (make sure
JAVA_HOME environment variable is set):
java -jar jboss-devstudio-8.1.0.GA-installer-standalone.jar
Follow the on-screen instructions to complete the installations.
Fire up JBDS
Click the icon that was just installed on your system to fire up JBDS. You will first be greeted with a screen to select the location for your workspace. Choose a location on your system for where our Java projects will go:
Install the integration pack
The Fuse tools are part of the integration pack, that you can install by selecting the “Software/Update” tab and choose “JBoss Fuse Development”. Then follow the on-screen instructions to install the tools.
Smoke test the installation
To verify you that you have properly installed the tools, click “File-»New->Other” and do a search for “fuse”.
If you have the option to create a new “Fuse” project, you’ve installed things correctly! WooHoo! If not, yell and kick the instructor (if live) or file an issue in this git repository
You will be interacting with a public-facing OpenShift environment that is installed on top of cloud infrastructure. The OpenShift environment for the workshop consists of the following:
- One OpenShift Master (which includes the API, router, and registry)
- Five OpenShift Nodes providing the “workshop” region
The OpenShift Master provides both the API endpoint for the CLI as well as the OpenShift web console. It is essentially the only system you will directly interact with.
The “infra(structure)” region is also running on the master, where OpenShift’s internal Docker registry and OpenShift’s router are running. The “workshop” region is where all of your builds and application instances will run.
This topology of “infra” and “workshop” is completely configurable and very advanced topologies can be crafted to suit the needs of your organization.
Command Line Interface
OpenShift 3 ships with a feature rich web console as well as command line tools to provide users with a nice interface to work with applications deployed to the platform. The OpenShift tools are a single executable written in the Go programming language and is available for the following operating systems:
- Microsoft Windows
- Apple OS X
Downloading the tools
During this lab, we are going to download the client tool and add them to our operating system $PATH environment variables so the executable is accessible from any directory on the command line.
The first thing we want to do is download the correct executable for your operating system as linked below:
Once the file has been download, you will need to extract the contents as it is a compressed archive. I would suggest saving this file to the following directories:
Extracting the tools
Once you have the tools downloaded, you will need to extract the contents:
Windows: In order to extract a zip archive on windows, you will need a zip utility installed on your system. With newer versions of windows (greater than XP), this is provided by the operating system. Just right click on the downloaded file using file explorer and select to extract the contents.
OS X: Open up a terminal window and change to the directory where you downloaded the file. Once you are in the directory, enter in the following command:
$ tar zxvf oc-220.127.116.11-macosx.tar.gz
Linux: Open up a terminal window and change to the directory where you downloaded the file. Once you are in the directory, enter in the following command:
$ tar zxvf oc-18.104.22.168-linux.tar.gz
Adding oc to your PATH
Windows: Because changing your PATH on windows varies by version of the operating system, we will not list each operating system here. However, the general workflow is right click on your computer name inside of the file explorer. Select Advanced system settings. I guess changing your PATH is considered an advanced task? :) Click on the advanced tab, and then finally click on Environment variables. Once the new dialog opens, select the Path variable and add “;C:\OpenShift” at the end. For an easy way out, you could always just copy it to C:\Windows or a directory you know is already on your path. For more detailed instructions:
Windows 10 - Follow the directions above.
$ export PATH=$PATH:~/OpenShift
$ export PATH=$PATH:~/OpenShift
At this point, we should have the oc tool available for use. Let’s test this out by printing the version of the oc command:
$ oc version
You should see the following:
oc v1.0.4 kubernetes v1.0.0
If you get an error message, you have not updated your path correctly. If you need help, raise your hand and the instructor will assist.
Parts of this lab will use the PaaS which can use git repos from which to build source code on demand. In this workshop, we’ll rely on github.com but for a more realistic usage, you’d use your own internal git repos (eg, Stash, Gitlab, gogs, etc)
If you navigate over to http://github.com/join, you will be greated with a signup form. Complete the form and create your repo/account: