Chapter 2. Deploying a booster to OpenShift Online

You can quickly create, build, and deploy a booster to OpenShift Online using developers.redhat.com/launch. developers.redhat.com/launch creates a new repository in your GitHub account containing the booster’s code and deploys it to your OpenShift Online account. It can also create a ZIP of the booster for you to download and run on your localhost.

Prerequisites

Procedure

  1. Navigate to developers.redhat.com/launch using your browser.

  2. Select Launch your Project.

    • You may be prompted to log in to your Red Hat Developers account. If you are, click Log in or register and complete the authentication steps.

  3. You may be prompted to grant developers.redhat.com/launch access to your GitHub and OpenShift Online accounts. This is a one-time action.

    Important

    developers.redhat.com/launch uses the rh-developers-launch SSO realm to connect your Red Hat Developers account, your GitHub account, and your OpenShift Online account together. When you add these connections, developers.redhat.com/launch is granted access to those accounts and is allowed to use those accounts when creating and deploying boosters.

    When connecting these three accounts together in rh-developers-launch, they may only be used with each other within the rh-developers-launch SSO realm. For example, if your GitHub account is associated with a different Red Hat Developers account within the rh-developers-launch SSO realm, you must deauthorize it from the other Red Hat Developers account or add a different GitHub account.

    At this time, you cannot use the us-east-2 OpenShift Starter cluster with developers.redhat.com/launch. This cluster is used with OpenShift.io and is configured differently.

    1. Click Grant Access.
    2. Click the Add button next to the GitHub field and authorize developers.redhat.com/launch to access your GitHub account.
    3. Click the Add button next to the OpenShift Online cluster you use.
  4. Follow the instructions to create a booster based on a mission, runtime, and target environment.
  5. Open the README.adoc file in your booster’s project and follow the instructions for building, deploying, and interacting with your booster.
Important

When you are done interacting with and updating your booster, it is recommended to delete your project because the resources allocated to your OpenShift Online account are limited. For instructions, see the Deleting a Project chapter of the OpenShift Online documentation. You can redeploy the booster later using the instructions in the relevant runtime guide.

You have quotas for your OpenShift Online account. If you exceed your account quota, you will not be able to launch new boosters using developers.redhat.com/launch. The quota for your account varies depending on your subscription.