Chapter 2. Getting Started for Administrators

Procedure

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

   oc login -u system:admin

2. Log in to the OpenShift project where you want to install 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 your Red Hat Customer Portal account or your Red Hat Developer Program account credentials. Replace <pull_secret_name> with the name of the secret that you wish to create.

   oc create secret docker-registry <pull_secret_name> \
     --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 in every namespace that uses registry.redhat.io.

4. To use the secret for pulling images for pods, add the secret to your service account. The name of the service account must match the name of the service account pod uses. Following example uses default which is the default service account.

   oc secrets link default <pull_secret_name> --for=pull

5. To use the secret for pushing and pulling build images, the secret must be mountable inside of a pod. To mount the secret, use following command:

   oc secrets link builder <pull_secret_name>

Procedure

1. Start the OpenShift 4 Server.

2. Log in to the OpenShift Server as an administrator.

   oc login -u system:admin

3. Verify that you are using the project for which you created a docker-registry secret.

   oc project openshift

4. View the current configuration of Samples operator.

   oc get configs.samples.operator.openshift.io -n openshift-cluster-samples-operator -o yaml

5. Configure Samples operator to ignore the fuse templates and image streams that are added.

   oc edit configs.samples.operator.openshift.io -n openshift-cluster-samples-operator

6. Add the Fuse imagestreams and templates to Skipped Imagestreams and Skipped Templates section respectively.

   [...]
   spec:
     architectures:
     - x86_64
     managementState: Managed
     skippedImagestreams:
     - fis-java-openshift
     - fis-karaf-openshift
     - fuse7-console
     - fuse7-eap-openshift
     - fuse7-java-openshift
     - fuse7-karaf-openshift
     - jboss-fuse70-console
     - jboss-fuse70-eap-openshift
     - jboss-fuse70-java-openshift
     - jboss-fuse70-karaf-openshift
     - fuse-apicurito-generator
     - apicurito-ui
     skippedTemplates:
     - s2i-fuse74-eap-camel-amq
     - s2i-fuse74-eap-camel-cdi
     - s2i-fuse74-eap-camel-cxf-jaxrs
     - s2i-fuse74-eap-camel-cxf-jaxws
     - s2i-fuse74-eap-camel-jpa
     - s2i-fuse74-karaf-camel-amq
     - s2i-fuse74-karaf-camel-log
     - s2i-fuse74-karaf-camel-rest-sql
     - s2i-fuse74-karaf-cxf-rest
     - s2i-fuse74-spring-boot-camel
     - s2i-fuse74-spring-boot-camel-amq
     - s2i-fuse74-spring-boot-camel-config
     - s2i-fuse74-spring-boot-camel-drools
     - s2i-fuse74-spring-boot-camel-infinispan
     - s2i-fuse74-spring-boot-camel-rest-sql
     - s2i-fuse74-spring-boot-camel-xa
     - s2i-fuse74-spring-boot-camel-xml
     - s2i-fuse74-spring-boot-cxf-jaxrs

7. Install Fuse on OpenShift image streams.

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003
   
   oc create -n openshift -f ${BASEURL}/fis-image-streams.json

8. Install the quickstart templates:

   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-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-740025-redhat-00003/quickstarts/${template}
    done

9. Install the templates for the Fuse Console.

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

   Note

   For information on deploying the Fuse Console, see Set up Fuse Console on OpenShift.

10. (Optional) View the installed Fuse on OpenShift images and templates:

    oc get template -n openshift

Procedure

1. Start the OpenShift 4.x Server.
2. Navigate to the OpenShift console in your browser. Log in to the console with your credentials.
3. Click Catalog and then Click OperatorHub.
4. Enter Apicurito in the search field window and press Enter key. You can see the Apicurito Operator in the right hand side panel.
5. Click Apicurito Operator. The Apicurito Operator install window is displayed.

6. Click Install. The Create Operator Subscription form is displayed. The form has options for:

   • Installation mode
   • Update Channel

   • Approval Strategy.

     Select as per you preferences or you can keep the default values.

7. Click Subscribe. The Apicurito Operator is now installed in the selected namespace.
8. To verify, click Catalog and then click Installed Operator. You can see the Apicurito Operator in the list.

9. Click Apicurito Operator in the Name column. Click Create New under Provided APIs. A new Custom Resource Definition (CRD) is created with the default values. Following fields are supported as part of the CR:

   • size: how many pods your the apicurito operator will have.
   • image: the apicurito image. Changing this image in an existing installation will trigger an upgrade of the operator.
10. Click Create. This will create a new apicurito-service.

Procedure

1. Start the OpenShift Server.

2. Log in to the OpenShift Server as an administrator.

   oc login -u system:admin

3. Verify that you are using the project for which you created a docker-registry secret.

   oc project openshift

4. Install the Fuse on OpenShift image streams.

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003
   
   oc create -n openshift -f ${BASEURL}/fis-image-streams.json

5. Install the quickstart templates:

   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-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-740025-redhat-00003/quickstarts/${template}
    done

6. Install the templates for the Fuse Console.

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

   Note

   For information on deploying the Fuse Console, see Set up Fuse Console on OpenShift.

7. Install the Apicurito template:

   oc create -n openshift -f ${BASEURL}/fuse-apicurito.yml

8. (Optional) View the installed Fuse on OpenShift images and templates:

   oc get template -n openshift