Chapter 2. Installing AMQ Broker on OpenShift Container Platform

Procedure

1. At the command line, log in to OpenShift as a cluster administrator (or as a user that has project administrator access to the global openshift project), for example:

   $ oc login -u system:admin

   Copy to Clipboard Toggle word wrap
   Note

   Using the openshift project makes the image stream and application templates that you install later in this procedure globally available to all projects in your OpenShift cluster.

   As an alternative to using the openshift project (e.g., if a cluster administrator is unavailable), you can log in to a specific OpenShift project to which you have administrator access and in which you want to create a broker deployment, for example:

   $ oc login -u <USERNAME>
   $ oc project <PROJECT_NAME>

   Copy to Clipboard Toggle word wrap

   Logging into a specific project means that the image stream and templates that you install later in this procedure are available only in that project’s namespace.

2. In your web browser, navigate to the Red Hat Container Catalog.
3. In the search box, enter AMQ Broker. Click Search.
4. In the search results, click Red Hat AMQ Broker 7.3. The amq-broker-7/amq-broker-73-openshift repository opens with the most recent image version automatically selected. If you want to change to an earlier image version, click the Tags tab and choose another version tag.
5. Click the Get This Image tab.

6. Under Authentication with registry tokens, follow the on-page instructions in the Using OpenShift secrets section. This section describes how to add references to your OpenShift secret name and the AMQ Broker 7.3 image repository to your pod configuration file.

   Note

   If Podman or Docker is installed in your OpenShift cluster, you can also follow the instructions in the Using Podaman Login or Using Docker Login sections, with equivalent results.

7. At the command line, run the following commands to import the AMQ Broker on OpenShift Container Platform image streams and latest image version to your project namespace. Using the --force option with the oc replace command updates the resources or creates them if they don’t already exist.

   $ oc replace --force  -f \
   https://raw.githubusercontent.com/jboss-container-images/jboss-amq-7-broker-openshift-image/73-7.3.0.GA/amq-broker-7-image-streams.yaml
   $ oc import-image amq-broker-7/amq-broker-73-openshift --from=registry.redhat.io/amq-broker-7/amq-broker-73-openshift --confirm

   Copy to Clipboard Toggle word wrap

8. Run the following command to update the AMQ Broker application templates.

   $ for template in amq-broker-73-basic.yaml \
   amq-broker-73-ssl.yaml \
   amq-broker-73-custom.yaml \
   amq-broker-73-persistence.yaml \
   amq-broker-73-persistence-ssl.yaml \
   amq-broker-73-persistence-clustered.yaml \
   amq-broker-73-persistence-clustered-ssl.yaml;
    do
    oc replace --force -f \
   https://raw.githubusercontent.com/jboss-container-images/jboss-amq-7-broker-openshift-image/73-7.3.0.GA/templates/${template}
    done

   Copy to Clipboard Toggle word wrap