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

手順

1. cluster admin 権限を持つユーザーとして OpenShift にログインします。

   oc login -u <user_with_cluster_admin_role>

2. 以下のコマンドを実行して、サービス署名認証局のキーを取得します。

   • 以下を実行して、証明書を取得します。

     oc get secrets/signing-key -n openshift-service-ca -o "jsonpath={.data['tls\.crt']}" | base64 --decode > ca.crt

   • 以下を実行して、秘密鍵を取得します。

     oc get secrets/signing-key -n openshift-service-ca -o "jsonpath={.data['tls\.key']}" | base64 --decode > ca.key

3. Kubernetes certificates administration の説明にしたがって、easyrsa、openssl、または cfssl を使用して、クライアント証明書を生成します。

   以下に、openssl を使用したコマンドの例を示します。

   1. 秘密鍵を生成します。

      openssl genrsa -out server.key 2048

   2. CSR 設定ファイルを作成します。

      cat <<EOT >> csr.conf
        [ req ]
        default_bits = 2048
        prompt = no
        default_md = sha256
        distinguished_name = dn
      
        [ dn ]
        CN = fuse-console.fuse.svc
      
        [ v3_ext ]
        authorityKeyIdentifier=keyid,issuer:always
        keyUsage=keyEncipherment,dataEncipherment,digitalSignature
        extendedKeyUsage=serverAuth,clientAuth
      EOT

   3. CSR を生成します。

      openssl req -new -key server.key -out server.csr -config csr.conf

   4. 署名済みの証明書を発行します。

      openssl x509 -req -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out server.crt -days 10000 -extensions v3_ext -extfile csr.conf

手順

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

   oc get template -n openshift

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

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

3. 以下の Fuse Console テンプレートの 1 つを、raw 形式の https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-750056-redhat-00006 から任意のローカルディレクトリーにダウンロードします（例： mytemp）。

   • クラスターテンプレート: fuse-console-cluster-os4.json
   • namespace テンプレート: fuse-console-namespace-os4.json

4. namespace テンプレートの場合は、次のステップに進みます。

   クラスターテンプレートの場合、任意のエディターで fuse-console-cluster-os4.json ファイルのローカルコピーを編集し、"grantMethod": "auto" 属性を OAuthClient セクションに追加します。

   {
         "kind": "OAuthClient",
         "apiVersion": "v1",
         "metadata": {
           "name": "${APP_NAME}-oauth-client"
         },
         "grantMethod": "auto",
         "redirectURIs": [
           "https://${ROUTE_HOSTNAME}"
         ]
   }

5. 以下のコマンドを実行して、Fuse Console の APP_NAME の値を取得します。コマンドの mytemp は、Fuse Console テンプレートが含まれるローカルディレクトリーのパスに置き換えます。

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

     oc process --parameters -f mytemp/fuse-console-cluster-os4.json

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

     oc process --parameters -f mytemp/fuse-console-namespace-os4.json

6. 以下のコマンドを使用して、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

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

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

     oc new-app -n myproject -f mytemp/fuse-console-cluster-os4.json -p ROUTE_HOSTNAME=myhost

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

     oc new-app -n myproject -f mytemp/fuse-console-namespace-os4.json

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

   oc status

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

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

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

   以下に例を示します。

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

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

    oc get myproject

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

   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