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
    Copy to Clipboard
  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
    Copy to Clipboard
  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
    Copy to Clipboard
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
    Copy to Clipboard
  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
    Copy to Clipboard
  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
    Copy to Clipboard
  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
    Copy to Clipboard
    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
    Copy to Clipboard
  7. (Optional) Run the following command to view the installed Fuse on OpenShift images and templates.

    oc get template -n openshift
    Copy to Clipboard
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat