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

手順

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

   oc login -u <user_with_cluster_admin_role>

   Copy to Clipboard Toggle word wrap

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

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

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

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

      openssl genrsa -out server.key 2048

      Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

   3. CSR を生成します。

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

      Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

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

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

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

   • Install mode で、Fuse Console Operator を固有の namespace (現在の OpenShift プロジェクト) にインストールします。

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

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

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

7. Subscribe をクリックします。

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

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

9. ターミナルウインドウで以下のコマンドを使用して、OpenShift 4.x で Fuse Console をセキュア化するための証明書の生成 で生成した証明書を使用してシークレットを作成し、Fuse Console にマウントします。コマンドの APP_NAME は、Fuse Console Deployment (例: fuse-console) の名前に置き換えます。

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

   Copy to Clipboard Toggle word wrap

   たとえば、Fuse Console アプリケーションの名前が fuse-console の場合は、以下のコマンドを入力します。

   oc create secret tls fuse-console-tls-proxying --cert server.crt --key server.key

   Copy to Clipboard Toggle word wrap

   コマンドの実行に成功すると、シークレットの作成を確認する以下のような応答が返されます。

   secret/fuse-console-operator-tls-proxying created

   Copy to Clipboard Toggle word wrap

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

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

    2. Provided APIs の Overview ページで、Create Instance をクリックします。新しいカスタムリソース定義 (CRD) ファイルが表示されます。

       デフォルトでは、Fuse Console は現在の namespace にデプロイされます。

    3. Fuse Console をデプロイして現在の namespace でアプリケーションを検出して管理する場合には、次の手順に進んでください。

       オプションで Fuse Console をデプロイしてクラスター上の (またはユーザー認証が済んでいる) 全 namespace でアプリケーションを検出して管理する場合には、namespace から cluster に spec.type フィールドの値を変更して、CRD ファイルを編集します。

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

       Fuse Console のデプロイ後、Fuse Console CRD ページが開き、新しい Fuse Console サービスが表示されます。

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

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

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

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

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

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

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

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

手順

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

   oc get template -n openshift

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   oc process --parameters -f TEMPLATE-FILENAME

   Copy to Clipboard Toggle word wrap

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

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

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-cluster-os4.json

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

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-cluster-rbac.yml

   • namespace テンプレート:

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-namespace-os4.json

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

     https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-namespace-rbac.yml

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

     oc process --parameters -f https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fuse-console-cluster-rbac.yml

     Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

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

     oc new-app -n myproject -f {templates-base-url}/fuse-console-cluster-os4.json  -p ROUTE_HOSTNAME=myhost”

     Copy to Clipboard Toggle word wrap

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

     oc new-app -n myproject -f {templates-base-url}/fuse-console-cluster-rbac.yml -p ROUTE_HOSTNAME=myhost”

     Copy to Clipboard Toggle word wrap

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

     {templates-base-url}/fuse-console-namespace-os4.json

     Copy to Clipboard Toggle word wrap

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

     oc new-app -n myproject -f {templates-base-url}/fuse-console-namespace-rbac.yml

     Copy to Clipboard Toggle word wrap

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}`

   Copy to Clipboard Toggle word wrap

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

   oc status

   Copy to Clipboard Toggle word wrap
8. ブラウザーから Fuse Console にアクセスするには、7. で返される 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"}}'

   Copy to Clipboard Toggle word wrap

   以下に例を示します。

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

   Copy to Clipboard Toggle word wrap

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

    oc get myproject

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

   deployment "example-fuseconsole" successfully rolled out

   Copy to Clipboard Toggle word wrap