2.4. OpenShift 4.x での Fuse Console の設定

1. Web ブラウザーで、cluster admin 権限を持つユーザーとして OpenShift コンソールにログインします。
2. Operators をクリックした後、OperatorHub をクリックします。
3. 検索フィールドウインドウに Fuse Console と入力し、Operator のリストを絞り込みます。
4. Fuse Console Operator をクリックします。

5. Fuse Console Operator インストールウィンドウで Install をクリックします。

   Create Operator Subscription フォームが表示されます。

   • Update Channel には 7.13.x を選択します。

   • Installation Mode では、デフォルト (クラスターの特定の namespace) を受け入れます。

     operator のインストール後に Fuse Console をデプロイする場合、クラスター上のすべての namespace でアプリケーションを監視するか、Fuse Console operator がインストールされた namespace のみでアプリケーションを監視するかを選択できる点に注意してください。

   • Installed Namespace には、Fuse Console Operator をインストールする namespace を選択します。

   • Update Approval では、Automatic または Manual を選択し、Fuse Console の更新が OpenShift によってどのように対処されるかを設定します。

     • Automatic (自動) 更新を選択した場合、新しいバージョンの Fuse Console Operator が使用できるようになると、人的な介入なしで OpenShfit Operator Lifecycle Manager (OLM) によって、Fuse Console の稼働中のインスタンスが自動的にアップグレードされます。
     • Manual (手動) 更新を選択した場合、Operator の新しいバージョンが使用できるようになると、OLM によって更新リクエストが作成されます。クラスター管理者は、更新リクエストを手動で承認して、Fuse Console Operator を新しいバージョンに更新する必要があります。

6. Install をクリックします。

   OpenShift によって、Fuse Console Operator が現在の namespace にインストールされます。

7. インストールを確認するには、Operators をクリックした後、Installed Operators をクリックします。Operator のリストに Fuse Console が表示されます。

8. OpenShift Web コンソールで Fuse Console をデプロイするには、以下を行います。

   1. Installed Operators のリストで、Name 列の Fuse Console をクリックします。

   2. Provided APIs の Operator Details ページで、Create Instance をクリックします。

      設定のデフォルト値を使用するか、任意でデフォルト値を編集します。

      Fuse Console のパフォーマンスを向上する必要がある場合 (高可用性環境など)、Replicas で Fuse Console に割り当てられた Pod 数を増やすことができます。

      Rbac (ロールベースアクセス制御) では、デフォルトの RBAC 動作をカスタマイズする場合や、Fuse Console Operator をインストールした namespace に ConfigMap ファイルがすでに存在する場合にのみ、config Map フィールドに値を指定します。RBAC の詳細は、OpenShift 4.x 上の Fuse Console のロールベースアクセス制御 を参照してください。

      Nginx については、Fuse Console Operator インストールのパフォーマンスチューニング を参照してください。

   3. Create をクリックします。

      Fuse Console Operator Details ページが開き、デプロイメントの状態が表示されます。

9. Fuse Console を開くには以下を行います。

   1. namespace デプロイメントの場合: OpenShift Web コンソールで、Fuse Console の operator をインストールしたプロジェクトを開き、Overview を選択します。Project Overview ページで Launcher セクションまで下方向にスクロールし、Fuse Console のリンクをクリックします。

      cluster デプロイメントでは、OpenShift Web コンソールのタイトルバーで、グリッドアイコン ( ) をクリックします。ポップアップメニューの Red Hat アプリケーション の下にある、Fuse Console の URL リンクをクリックします。

   2. Fuse Console にログインします。

      ブラウザーに Authorize Access ページが表示され、必要なパーミッションが表示されます。

   3. Allow selected permissions をクリックします。

      Fuse Console がブラウザーで開き、アクセス権限のある Fuse アプリケーション Pod が表示されます。

10. 表示するアプリケーションの Connect をクリックします。

    新しいブラウザーウィンドウが開かれ、Fuse Console にアプリケーションが表示されます。

手順

1. 以下のコマンドを実行してすべてのテンプレートのリストを取得し、Fuse Console イメージストリームがインストールされていることを確認します。

   oc get template -n openshift

2. 任意で、すでにインストールされているイメージストリームを新しいリリースタグで更新する場合は、以下のコマンドを使用して openshift namespace に Fuse Console イメージをインポートします。

   oc import-image fuse7/fuse-console-rhel8:1.10 --from=registry.redhat.io/fuse7/fuse-console-rhel8:1.10 --confirm -n openshift

3. 以下のコマンドを実行して、Fuse Console の APP_NAME の値を取得します。

   oc process --parameters -f TEMPLATE-FILENAME

   ここで、TEMPLATE-FILENAME は以下のテンプレートのいずれかになります。

   • クラスターテンプレート:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-cluster-os4.json

   • 設定可能な RBAC のあるクラスターテンプレート:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-cluster-rbac.yml

   • namespace テンプレート:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-namespace-os4.json

   • 設定可能な RBAC のある namespace テンプレート:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-namespace-rbac.yml

     たとえば、設定可能な RBAC のあるクラスターテンプレートの場合は、以下のコマンドを実行します。

     oc process --parameters -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-cluster-rbac.yml

4. 以下のコマンドを使用して、OpenShift 4.x での Fuse Console のセキュア化 で生成した証明書からシークレットを作成し、Fuse Console にマウントします (APP_NAME は、Fuse Console アプリケーションの名前になります)。

   oc create secret tls APP_NAME-tls-proxying --cert server.crt --key server.key

5. 以下のコマンドを実行して、ローカルにコピーされた Fuse Console テンプレートをベースとした新しいアプリケーションを作成します。コマンドの myproject は OpenShift プロジェクトの名前、mytemp は Fuse Console テンプレートが含まれるローカルディレクトリーへのパス、myhost は Fuse Console にアクセスするホストの名前に置き換えます。

   • クラスターテンプレートの場合:

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-cluster-os4.json  -p ROUTE_HOSTNAME=myhost

   • RBAC テンプレートのあるクラスターの場合:

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-cluster-rbac.yml -p ROUTE_HOSTNAME=myhost

   • Namespace テンプレートの場合:

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-namespace-os4.json

   • RBAC テンプレートのある namespace の場合:

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001/fuse-console-namespace-rbac.yml

6. OpenShift Web コンソールを開くように Fuse Console を設定するには、以下のコマンドを実行して OPENSHIFT_WEB_CONSOLE_URL 環境変数を設定します。

   oc set env dc/${APP_NAME} OPENSHIFT_WEB_CONSOLE_URL=`oc get -n openshift-config-managed cm console-public -o jsonpath={.data.consoleURL}`

7. 以下のコマンドを実行して、Fuse Console デプロイメントの状態と URL を取得します。

   oc status

8. ブラウザーから Fuse Console にアクセスするには、手順 7. で返される URL (例: https://fuse-console.192.168.64.12.nip.io) を使用します。

1. ターミナルウィンドウで、以下のコマンドを使用してアプリケーションカスタムリソース定義の .spec.version フィールドを変更します。

   oc patch -n <project-name> <custom-resource-name> --type='merge' -p '{"spec":{"version":"1.7.1"}}'

   以下に例を示します。

   oc patch -n myproject hawtio/example-fuseconsole --type='merge' -p '{"spec":{"version":"1.7.1"}}'

2. アプリケーションの状態が更新されたことを確認します。

    oc get -n myproject hawtio/example-fuseconsole

   応答には、バージョン番号などのアプリケーションに関する情報が表示されます。

   NAME                  AGE   URL                                        IMAGE
   example-fuseconsole   1m    https://fuseconsole.192.168.64.38.nip.io   docker.io/fuseconsole/online:1.7.1

   .spec.version フィールドの値を変更すると、OpenShift によってアプリケーションが自動的に再デプロイされます。

3. バージョンの変更によってトリガーされた再デプロイの状態をチェックするには、以下を実行します。

   oc rollout status deployment.v1.apps/example-fuseconsole

   正常にデプロイされた場合は以下の応答が表示されます。

   deployment "example-fuseconsole" successfully rolled out

手順

1. OpenShift 4 サーバーを起動します。

2. OpenShift サーバーに管理者としてログインします。

   oc login --user system:admin --token=my-token --server=https://my-cluster.example.com:6443

3. docker-registry シークレットを作成したプロジェクトを使用していることを確認します。

   oc project openshift

4. Samples Operator の現在の設定を表示します。

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

5. Samples Operator が、追加された Fuse テンプレートおよびイメージストリームを無視するよう設定します。

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

6. Fuse imagestreams の Skipped Imagestreams セクションを追加し、Fuse および Spring Boot 2 のテンプレートを Skipped Templates セクションに追加します。

   [...]
   spec:
     architectures:
     - x86_64
     managementState: Managed
     skippedImagestreams:
     - fuse-console-rhel8
     - fuse-eap-openshift-jdk8-rhel7
     - fuse-eap-openshift-jdk11-rhel8
     - fuse-java-openshift-rhel8
     - fuse-java-openshift-jdk11-rhel8
     - fuse-karaf-openshift-rhel8
     - fuse-karaf-openshift-jdk11-rhel8
     - fuse-apicurito-generator-rhel8
     - fuse-apicurito-rhel8
     skippedTemplates:
     - s2i-fuse713-eap-camel-amq
     - s2i-fuse713-eap-camel-cdi
     - s2i-fuse713-eap-camel-cxf-jaxrs
     - s2i-fuse713-eap-camel-cxf-jaxws
     - s2i-fuse713-karaf-camel-amq
     - s2i-fuse713-karaf-camel-log
     - s2i-fuse713-karaf-camel-rest-sql
     - s2i-fuse713-karaf-cxf-rest
     - s2i-fuse713-spring-boot-2-camel-amq
     - s2i-fuse713-spring-boot-2-camel-config
     - s2i-fuse713-spring-boot-2-camel-drools
     - s2i-fuse713-spring-boot-2-camel-infinispan
     - s2i-fuse713-spring-boot-2-camel-rest-3scale
     - s2i-fuse713-spring-boot-2-camel-rest-sql
     - s2i-fuse713-spring-boot-2-camel
     - s2i-fuse713-spring-boot-2-camel-xa
     - s2i-fuse713-spring-boot-2-camel-xml
     - s2i-fuse713-spring-boot-2-cxf-jaxrs
     - s2i-fuse713-spring-boot-2-cxf-jaxws
     - s2i-fuse713-spring-boot-2-cxf-jaxrs-xml
     - s2i-fuse713-spring-boot-2-cxf-jaxws-xml

7. Fuse on OpenShift イメージストリームをアップグレードします。

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-7_13_0-00014-redhat-00001
   
   oc replace -n openshift -f ${BASEURL}/fis-image-streams.json

8. Fuse on OpenShift クイックスタートテンプレートをアップグレードします。

   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 \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json ;
    do
    oc replace -n openshift \
    ${BASEURL}/quickstarts/${template}
    done

9. Spring Boot 2 クイックスタートテンプレートをアップグレードします。

   for template in spring-boot-2-camel-amq-template.json \
    spring-boot-2-camel-config-template.json \
    spring-boot-2-camel-drools-template.json \
    spring-boot-2-camel-infinispan-template.json \
    spring-boot-2-camel-rest-3scale-template.json \
    spring-boot-2-camel-rest-sql-template.json \
    spring-boot-2-camel-template.json \
    spring-boot-2-camel-xa-template.json \
    spring-boot-2-camel-xml-template.json \
    spring-boot-2-cxf-jaxrs-template.json \
    spring-boot-2-cxf-jaxws-template.json \
    spring-boot-2-cxf-jaxrs-xml-template.json \
    spring-boot-2-cxf-jaxws-xml-template.json ;
    do oc replace -n openshift \
    ${BASEURL}/quickstarts/${template}
    done

10. (オプション) アップグレードされた Fuse on OpenShift テンプレートを表示します。

    oc get template -n openshift