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.
Log in to the OpenShift Server as an administrator, as follows:
oc login -u system:admin
Log in to the OpenShift project where you will be installing the image streams. We recommend that you use the
openshiftproject for the Fuse on OpenShift image streams.oc project openshift
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
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”
- Start the OpenShift Server.
Log in to the OpenShift Server as an administrator, as follows:
oc login -u system:admin
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-720018-redhat-00001 oc create -n openshift -f ${BASEURL}/fis-image-streams.jsonInstall 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-720018-redhat-00001/quickstarts/${template} doneInstall 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-720018-redhat-00001/fis-console-cluster-template.json oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-720018-redhat-00001/fis-console-namespace-template.json
NoteFor information on deploying the Fuse Console, see Managing Fuse.
Install the Apicurito template. Enter the following command at a command prompt:
oc create -n openshift -f ${BASEURL}/fuse-apicurito.yml(Optional) Run the following command to view the installed Fuse on OpenShift images and templates.
oc get template -n openshift
