Chapter 2. Get Started for Administrators

If you are an OpenShift administrator, you can prepare an OpenShift cluster for Fuse on OpenShift deployments by installing the Fuse on OpenShift images and templates as described here.

2.1. Configure Authentication to the Red Hat Container Registry

You must configure authentication to Red Hat container registry before you can import and use the Red Hat Fuse OpenShift Image Streams. Follow instruction given below to configure the registration to container registry.

  1. Log in to the OpenShift Server as an administrator, as follows:

    oc login -u system:admin
  2. Log in to the OpenShift project where you will be installing the image streams. We recommend that you use the openshift project for the Fuse on OpenShift image streams.

    oc project openshift
  3. Create a docker-registry secret using either Red Hat Customer Portal account or Red Hat Developer Program account credentials.

    oc create secret docker-registry imagestreamsecret \
      --docker-server=registry.redhat.io \
      --docker-username=CUSTOMER_PORTAL_USERNAME \
      --docker-password=CUSTOMER_PORTAL_PASSWORD \
      --docker-email=EMAIL_ADDRESS
Note

You need to create a docker-registry secret in every new namespace where the image streams reside and which use registry.redhat.io.

If you do not wish to use your Red Hat account username and password to create the secret, it is recommended to create an authentication token using a registry service account.

For more information see:

2.2. Prepare the OpenShift Server

When preparing the OpenShift Server, you must create a docker-registry secret before installing Fuse on OpenShift image streams. It is recommended to use openshift namespace to create a docker-registry secret and to install Fuse on OpenShift image streams and templates. For more information, see Section 2.1, “Configure Authentication to the Red Hat Container Registry”

  1. Start the OpenShift Server.
  2. Log in to the OpenShift Server as an administrator, as follows:

    oc login -u system:admin
  3. Install the Fuse on OpenShift image streams. Enter the following commands at a command prompt:

    BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-730065-redhat-00002
    oc create -n openshift -f ${BASEURL}/fis-image-streams.json
  4. Install the quickstart templates. Enter the following commands at a command prompt:

    for template in eap-camel-amq-template.json \
     eap-camel-cdi-template.json \
     eap-camel-cxf-jaxrs-template.json \
     eap-camel-cxf-jaxws-template.json \
     eap-camel-jpa-template.json \
     karaf-camel-amq-template.json \
     karaf-camel-log-template.json \
     karaf-camel-rest-sql-template.json \
     karaf-cxf-rest-template.json \
     spring-boot-camel-amq-template.json \
     spring-boot-camel-config-template.json \
     spring-boot-camel-drools-template.json \
     spring-boot-camel-infinispan-template.json \
     spring-boot-camel-rest-sql-template.json \
     spring-boot-camel-teiid-template.json \
     spring-boot-camel-template.json \
     spring-boot-camel-xa-template.json \
     spring-boot-camel-xml-template.json \
     spring-boot-cxf-jaxrs-template.json \
     spring-boot-cxf-jaxws-template.json ;
     do
     oc create -n openshift -f \
     https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-730065-redhat-00002/quickstarts/${template}
     done
  5. Install the templates for Fuse Console (Hawtio). Enter the following commands at a command prompt:

    oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-730065-redhat-00002/fis-console-cluster-template.json
    oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-730065-redhat-00002/fis-console-namespace-template.json
    Note

    For information on deploying the Fuse Console, see Managing Fuse.

  6. Install the Apicurito template. Enter the following command at a command prompt:

    oc create -n openshift -f ${BASEURL}/fuse-apicurito.yml
  7. (Optional) Run the following command to view the installed Fuse on OpenShift images and templates.

    oc get template -n openshift