Procedure

1. Ensure you are running a minishift instance which has at least 4 GB memory to run launcher

   $ minishift config set memory 4096
   $ minishift start

2. Download and install the Fabric8 Launcher add-on.

   $ git clone git@github.com:minishift/minishift-addons.git
   $ minishift addon install minishift-addons/add-ons/fabric8-launcher/
   $ minishift addons apply fabric8-launcher \
          --addon-env GITHUB_USERNAME=GH_USERNAME \
          --addon-env GITHUB_TOKEN=TOKEN 1

   1

   Use your GitHub username and personal access token

   Installing the add-on creates a new project called rhoarpad where the Fabric8 Launcher tool runs.

3. Monitor the status of the Fabric8 Launcher tool until it completes start up.

   $ oc project rhoarpad
   $ oc get pods -w
   NAME                           READY     STATUS              RESTARTS   AGE
   configmapcontroller-1-deploy   1/1       Running             0          46s
   configmapcontroller-1-aaaaa    0/1       ContainerCreating   0          44s
   launcher-backend-1-deploy      1/1       Running             0          46s
   ...
   launcher-backend-2-aaaaa       0/1       Running             0         5s
   launcher-frontend-2-aaaaa      0/1       Running             0         6s

4. Obtain the route of your Fabric8 Launcher tool.

   $ oc get routes
   NAME       HOST/PORT                                PATH      SERVICES            PORT      TERMINATION   WILDCARD
   launcher   launcher-rhoarpad.LOCAL_OPENSHIFT_HOSTNAME             launcher-frontend   <all>                   None

5. Navigate to your Fabric8 Launcher tool and start using your Fabric8 Launcher tool to launch booster applications.

   This is the same service as https://developers.redhat.com/launch but running in a Single-node OpenShift Cluster.

Procedure

1. Open the Single-node OpenShift Cluster Web console and log in.

2. Click New Project to create a new OpenShift project to house the Fabric8 Launcher tool.

   

3. Name the project and optionally provide a description. This example uses my-launcher for the project’s name.

   
4. Click Create to complete the project creation.

5. Click Import YAML/JSON to add services to your new project from a template.

   
6. Copy the contents of the current Fabric8 Launcher template from the GitHub repository and paste it into the text box provided.

7. Click Create, ensure that only the Process the template option is selected, and click Continue.

   

8. Fill out the following fields.

   • Your GitHub username.
   • Your GitHub Mission Control access token is your personal access token for GitHub.
   • The Target OpenShift Console URL is the OpenShift Console URL from your Single-node OpenShift Cluster. This should be the same base URL you are currently using to complete the form, for example https://192.168.42.152:8443.
   • OpenShift username and password from your Single-node OpenShift Cluster, for example developer for the username and password.

   • KeyCloak URL and KeyCloak Realm MUST be cleared out.

     Warning

     You must clear these fields out for the Fabric8 Launcher tool on your Single-node OpenShift Cluster to be configured correctly.

   • Do not modify Catalog Git Repository and Catalog Git Reference unless you are developing against a specific catalog repository.
9. Before proceeding to the next steps, confirm all the fields are correct. Also confirm that KeyCloak URL and KeyCloak Realm have been cleared out.
10. Click Create to complete the setup. You will see a screen confirming that the service has been created. Click Continue to overview.

11. On the overview page, wait and confirm that the four pods for the Fabric8 Launcher tool have completed starting up.

    

12. When all pods are running, click the link at the top of all pods, which typically ends in nip.io.

    A new browser tab opens with the Fabric8 Launcher tool. This is the same service as https://developers.redhat.com/launch but running in a Single-node OpenShift Cluster.

13. Start using your Fabric8 Launcher tool to launch booster applications.