OpenShift Container Platform での Fuse Online のインストールと操作

手順

1. 以下の場所から Fuse Online インストールスクリプトが含まれるパッケージをダウンロードします。

   https://github.com/syndesisio/fuse-online-install/releases/tag/1.8

   ファイルシステムの任意の場所で、ダウンロードしたアーカイブを展開します。fuse-online-install-1.8 ディレクトリーには、Fuse Online をインストールするためのスクリプトとサポートファイルが含まれます。

2. 適切に接続され、カスタムリソース定義を一覧表示できることを確認するには、以下のコマンドを実行します。

   $ oc get crd

3. クラスターレベルでカスタムリソース定義を登録するには、fuse-online-install-1.8 ディレクトリーに移動し、以下のコマンドを実行します。

   $ bash install_ocp.sh --setup

4. Fuse Online をインストールする必要のある各ユーザーにインストールパーミッションを付与します。たとえば、ユーザー名 developer を持つアカウントにパーミッションを付与するとします。以下のコマンドを実行すると、developer アカウントが現在接続されているクラスターでアクセス可能なプロジェクトに Fuse Online をインストールするためのパーミッションが developer に付与されます。

   $ bash install_ocp.sh --grant developer --cluster

   Fuse Online をインストールするパーミッションが必要な各ユーザーアカウントに対して、このコマンドを繰り返します。

手順

1. Fuse Online インストールスクリプトが含まれるパッケージをダウンロードしていない場合は、以下の場所からダウンロードします。

   https://github.com/syndesisio/fuse-online-install/releases/tag/1.8

2. ファイルシステムの任意の場所で、ダウンロードしたアーカイブを展開します。fuse-online-install-1.8 ディレクトリーには、Fuse Online をインストールするためのスクリプトとサポートファイルが含まれます。

3. Fuse Online をインストールする権限を持つアカウントで OpenShift にログインします。以下に例を示します。

   $ oc login -u developer -p developer

4. 現在のプロジェクトが Fuse Online をインストールするプロジェクトであることを確認します。現在のプロジェクトを表示するには、以下を実行します。

   $ oc project

   または、インストールスクリプトの実行時にインストールプロジェクトを指定することもできます。

5. インストールスクリプトをダウンロードしたディレクトリーで、インストールスクリプトを実行します。

   • デフォルトのインストールを実行するには、以下を実行します。

     Copy to Clipboard Toggle word wrap

     $ bash install_ocp.sh

   • デフォルトのインストールを実行し、データ仮想化ユーザーインターフェイスも有効にするには、以下を実行します。

     Copy to Clipboard Toggle word wrap

     $ bash install_ocp.sh --datavirt

     開発環境のみでデータ仮想化ユーザーインターフェイスを有効にします。データ仮想化により、Fuse Online の開発者は複数の異なるソースからのデータを統合し、OpenShift でデプロイできる仮想データベースイメージを作成できます。アプリケーションは、SQL 以外のソースを含む仮想データベースで SQL クエリーを実行できます。詳細は、Red Hat Integration の Data Virtualization に関するドキュメント を参照してください。

     重要

     データ仮想化はテクノロジープレビューの機能です。テクノロジープレビュー機能は、Red Hat の本番環境のサービスレベルアグリーメント (SLA) ではサポートされず、機能的に完全ではないことがあるため、Red Hat は本番環境での使用は推奨しません。Red Hat は実稼働環境でこれらを使用することを推奨していません。これらの機能により、近日発表予定の製品機能をリリースに先駆けてご提供でき、お客様は開発プロセス時に機能をテストして、フィードバックをお寄せいただくことができます。Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、https://access.redhat.com/ja/support/offerings/techpreview を参照してください。

   • 複数のインストールオプションを指定するには、以下のようなコマンドを実行します。

     Copy to Clipboard Toggle word wrap

     $ bash install_ocp.sh \
         --project my-project \
         --route my-project.6a63.fuse-online.openshiftapps.com \
         --console https://console.fuse-online.openshift.com/console
         --datavirt

     • --project は、Fuse Online をインストールする OpenShift プロジェクトの名前を指定します。このオプションは、現在の OpenShift プロジェクト以外の OpenShift プロジェクトに Fuse Online をインストールする場合のみ指定する必要があります。

     • --route は、Fuse Online 環境の URL を指定します。この URL で Fuse Online 環境にアクセスします。URL の形式は、Fuse Online をインストールするプロジェクトの名前の後に、OpenShift クラスターに固有のドメインが続きます。

       つまり、プロジェクト名の後に Fuse Online にアクセスするために使用される OpenShift ルートに関連するホスト名を指定します。指定したホスト名の DNS 解決は OpenShift ルーターを参照する必要があります。

     • --console は、OpenShift コンソールの完全な URL を指定します。
     • --datavirt は、データ仮想化ユーザーインターフェイスを有効にします。これは、開発環境でのみ使用するテクノロジープレビュー機能です。

   インストールスクリプトのオプションの詳細については $ bash install_ocp.sh --help コマンドを実行してください。

6. インストールが成功したことを確認します。

   1. https://openshift-route で OpenShift OAuth プロキシーログインページを表示します。

      インストールスクリプトの実行時に --route オプションを指定した場合は、openshift-route を指定したルート名に置き換えます。インストールスクリプトによる OpenShift ルートの算出を選択した場合、実行の最後あたりで算出されたルートが表示されます。openshift-route をスクリプトが提供する値に置き換えます。

   2. OpenShift コンソールにログインしていない場合は、ログインページが表示されます。OpenShift ユーザー名およびパスワードを入力してログインします。

   Fuse Online のホームページが、すぐに、もしくは OpenShift コンソールへのログイン後に表示されます。

手順

1. Fuse Online をインストールする権限を持つアカウントで OpenShift にログインします。以下に例を示します。

   Copy to Clipboard Toggle word wrap

   $ oc login -u developer -p developer

2. 現在のプロジェクトが Fuse Online で稼働しているプロジェクトであることを確認します。現在のプロジェクトを表示するには、以下のコマンドを実行します。

   Copy to Clipboard Toggle word wrap

   $ oc project

3. syndesis カスタムリソースを編集します。

   1. 以下のコマンドを実行します。通常、エディターでリソースが開かれます。

      Copy to Clipboard Toggle word wrap

      oc edit syndesis

   2. リソースに以下が含まれていることを確認します。

      Copy to Clipboard Toggle word wrap

      spec:
        addons:
          komodo:
            enabled: "true"

   3. 必要な場合は、リソースを更新して保存します。

4. データ仮想化が正常に有効化されたことを確認します。

   1. https://openshift-route で OpenShift OAuth プロキシーログインページを表示します。

      openshift-route を Fuse Online 環境の URL に置き換えます。

   2. OpenShift コンソールにログインしていない場合は、ログインページが表示されます。OpenShift ユーザー名およびパスワードを入力してログインします。

      Fuse Online のホームページが、すぐに、もしくは OpenShift コンソールへのログイン後に表示されます。

   3. 左側のパネルで Data をクリックします。
   4. Data Virtualizations ページで、データビューを追加できるはずです。

手順

1. Fuse Online をインストールする権限を持つアカウントで OpenShift にログインします。以下に例を示します。

   Copy to Clipboard Toggle word wrap

   $ oc login -u developer -p developer

2. Fuse Online が稼働している OpenShift プロジェクトに切り替えます。このプロジェクトのみで検出を有効にします。以下に例を示します。

   Copy to Clipboard Toggle word wrap

   $ oc project my-fuse-online-project

3. syndesis カスタムリソースで oc patch コマンドを実行し、3scale ユーザーインターフェイスの URL を提供します。以下のサンプルコマンドの 3scale-url-here を 3scale ユーザーインターフェイスの実際の URL に置き換えます。

   Copy to Clipboard Toggle word wrap

   oc patch syndesis app --type='merge' -p '{"spec":{"components":{"server":{"features":{"managementUrlFor3scale":"3scale-url-here"}}}}}'

4. 任意手順:切り替え先のプロジェクトで検出が有効になっていることを確認するには、以下のコマンドを実行します。

   Copy to Clipboard Toggle word wrap

   oc describe dc/syndesis-server

   検出が有効な場合、このコマンドからの出力は、OPENSHIFT_MANAGEMENT_URL_FOR3SCALE 環境変数が oc patch コマンドで指定した URL に設定されていることを示しています。

手順

1. Fuse Online をインストールする権限を持つアカウントで OpenShift にログインします。以下に例を示します。

   Copy to Clipboard Toggle word wrap

   $ oc login -u developer -p developer

2. 3scale の検出が有効になっている OpenShift プロジェクトに切り替えます。以下に例を示します。

   Copy to Clipboard Toggle word wrap

   $ oc project my-fuse-online-project

3. syndesis カスタムリソースで oc patch コマンドを実行し、3scale ユーザーインターフェイスの URL を空の値に設定します。

   Copy to Clipboard Toggle word wrap

   oc patch syndesis app --type='merge' -p '{"spec":{"components":{"server":{"features":{"managementUrlFor3scale":""}}}}}'

   このコマンドによって、syndesis カスタムリソースが更新されます。更新により、OPENSHIFT_MANAGEMENT_URL_FOR3SCALE 環境変数が無効になります。syndesis カスタムリソースに対するこの変更により、Fuse Online のインストールを担う syndesis-operator が syndesis-server を再デプロイするようトリガーされます。新しいデフォルト動作では、API が 3scale で検出の対象ではなくなります。

   syndesis-server DeploymentConfig オブジェクトを編集して OPENSHIFT_MANAGEMENT_URL_FOR3SCALE 環境変数を設定しないでください。syndesis-operator により変更が元に戻るため、これは動作しません。syndesis-operator は、常に syndesis カスタムリソースのみに従って Fuse Online がデプロイされるようにします。

4. 先ほど検出を無効化したプロジェクトで作成された API プロバイダーインテグレーションで、検出が有効化されていたものがあれば、そのインテグレーションを再パブリッシュします。

   言い換えると、API プロバイダーインテグレーションが作成されたプロジェクトの検出が有効であるときに、そのインテグレーションの API の検出を無効にした場合は、この API プロバイダーインテグレーションを再パブリッシュする必要はありません。

手順

1. Fuse Online をインストールする権限を持つアカウントで OpenShift にログインします。以下に例を示します。

   $ oc login -u developer -p developer

2. 現在のプロジェクトが Fuse Online で稼働しているプロジェクトであることを確認します。現在のプロジェクトを表示するには、以下を実行します。

   $ oc project

3. syndesis カスタムリソースを編集します。

   1. 以下のコマンドを実行します。通常、エディターでリソースが開かれます。

      Copy to Clipboard Toggle word wrap

      oc edit syndesis

   2. 以下の行をリソースの最後に追加します。

      Copy to Clipboard Toggle word wrap

      spec:
        demoData: true
        addons:
          todo:
            enabled: true

   3. リソースを保存します。

      syndesis カスタムリソースに対するこの変更を保存することにより、Fuse Online のインストールを担う syndesis-operator が syndesis-server を再デプロイするようトリガーされます。

4. 再デプロイされたサーバーがサンプルデータを提供することを確認します。

   1. ブラウザーで Fuse Online コンソールを表示します。
   2. 左側のナビゲーションパネルで Connections をクリックします。
   3. PostgresDB コネクションが表示されることを確認します。

手順

1. 以下の場所から Fuse Online インストールスクリプトが含まれるパッケージをダウンロードします。

   https://github.com/syndesisio/fuse-online-install/releases/tag/1.8

   ファイルシステムの任意の場所で、ダウンロードしたアーカイブを展開します。fuse-online-install-1.8 ディレクトリーには、Fuse Online のアップグレード用のスクリプトとサポートファイルが含まれます。

2. 展開したアーカイブが含まれるディレクトリーに移動します。以下に例を示します。

   $ cd fuse-online-install-1.8

3. Fuse Online をアップグレードする権限を持つアカウントで OpenShift にログインします。以下に例を示します。

   $ oc login -u developer

4. 現在のプロジェクトの名前を返す以下のコマンドを実行し、現在のプロジェクトに Fuse Online がインストールされていることを確認します。

   $ oc project

   Fuse Online がインストールされているプロジェクトに切り替える必要がある場合は、Fuse Online が含まれる OpenShift プロジェクトの名前を指定して以下のコマンドを実行します。

   $ oc project project-name

5. アップグレードするバージョンを確認するには、以下のように --version オプションを指定して更新スクリプトを実行します。

   $ bash update_ocp.sh --version

6. 以下のような更新スクリプトを実行します。

   $ bash update_ocp.sh

   このスクリプトの詳細を確認するには、$ bash update_ocp.sh --help を実行します。

   インフラストラクチャーのアップグレード中およびアップグレード後も、既存のインテグレーションは引き続き Fuse Online ライブラリーおよび依存関係の古いバージョンで実行されます。

7. 次のように稼働中の Fuse Online インテグレーションをアップグレードします。

   1. Fuse Online で、アップグレードするインテグレーションを選択します。
   2. Edit を選択します。
   3. Publish を選択してインテグレーションを再パブリッシュします。

   インテグレーションの再パブリッシュを行うと、最新の Fuse Online 依存関係を使用して再ビルドが強制されます。

手順

1. Fuse Online インストールスクリプトが含まれるパッケージをダウンロードしていない場合は、以下の場所からダウンロードします。

   https://github.com/syndesisio/fuse-online-install/releases/tag/1.8

2. ファイルシステムの任意の場所で、ダウンロードしたアーカイブを展開します。fuse-online-install-1.8 ディレクトリーには、Fuse Online をインストールするためのスクリプトとサポートファイルが含まれます。

3. Fuse Online をインストールする権限を持つアカウントで OpenShift にログインします。以下に例を示します。

   Copy to Clipboard Toggle word wrap

   $ oc login -u developer -p developer

4. 現在のプロジェクトが Fuse Online をインストールするプロジェクトであることを確認します。現在のプロジェクトを表示するには、以下を実行します。

   Copy to Clipboard Toggle word wrap

   $ oc project

5. インストールスクリプトをダウンロードしたディレクトリーで、そのスクリプトを実行して syndesis リソースを取得します。これを後のステップで編集します。

   Copy to Clipboard Toggle word wrap

   $ bash install_ocp.sh

6. syndesis カスタムリソースを YAML ファイルとして取得します。

   Copy to Clipboard Toggle word wrap

   oc get syndesis app -o yaml > syndesis.yaml

7. syndesis.yaml を編集して、volumeCapacity パラメーター設定を増やします。以下に例を示します。

   Copy to Clipboard Toggle word wrap

   apiVersion: "syndesis.io/v1alpha1"
   kind: "Syndesis"
   metadata:
     name: "app"
   spec:
     components:
       db:
         resources:
           volumeCapacity: 10Gi

8. 編集した syndesis リソースを新しい名前 (例: custom-syndesis.yaml) で保存します。

   OpenShift は、新しい volumeCapacity の値を PersistentVolumeClaim オブジェクトにコピーします。

   警告

   削除しないコネクションやインテグレーションなどのデータがある Fuse Online 環境で、次のコマンドを実行しないでください。次の手順のコマンドを実行すると、この Fuse Online 環境にあるすべての Fuse Online オブジェクトのデータが削除されます。

9. 以下を実行して Fuse Online データを削除します。

   Copy to Clipboard Toggle word wrap

   oc delete syndesis app

10. ボリュームの容量を増やして設定する新しい syndesis カスタムリソースを作成します。コマンドラインで、volumeCapacity 設定を更新した .yaml ファイルを指定します。以下に例を示します。

    Copy to Clipboard Toggle word wrap

    oc create -f custom-syndesis.yaml

手順

1. 指定する名前を持つ OpenShift サービスアカウントを作成します。たとえば、次のコマンドを実行すると cicd-client サービスアカウントが作成されます。

   Copy to Clipboard Toggle word wrap

   $ oc create serviceaccount cicd-client

2. Fuse Online のパブリック API にアクセスするためのパーミッションを新しいサービスアカウントに付与します。たとえば、syndesis が Fuse Online がインストールされている OpenShift プロジェクトの名前である場合や、cicd-client が新しいサービスアカウントの名前である場合、以下のコマンドを実行します。

   Copy to Clipboard Toggle word wrap

   $ oc policy add-role-to-user edit system:serviceaccount:syndesis:cicd-client

3. 以下のコマンドを実行して、Fuse Online のパブリック REST API エンドポイントを公開する OpenShift テンプレートを作成します。

   Copy to Clipboard Toggle word wrap

   $ oc create -f https://raw.githubusercontent.com/syndesisio/syndesis/1.8.x/install/support/syndesis-public-oauth-proxy.yml

   注記

   テンプレートでは、リソースの名前は syndesis-public-oauth-proxy で、テンプレート自体の名前は syndesis-public-oauthproxy です。ご覧のとおり、リソース名は oauth と proxy がハイフンでつながっていますが、テンプレートファイル名はハイフンでつながっていません。

4. 以下のコマンドを実行して、Fuse Online のパブリック OAuth プロキシープロセスを実行する OpenShift アプリケーションを作成します。

   OpenShift Container Platform 4.2 の場合は、-p OAUTH_PROXY_TAG=4.2 も指定します。

   Copy to Clipboard Toggle word wrap

   $ oc new-app --template=syndesis-public-oauthproxy \
       -p PUBLIC_API_ROUTE_HOSTNAME=EXTERNAL_HOSTNAME \
       -p OPENSHIFT_PROJECT=$(oc project -q) \
       -p OPENSHIFT_OAUTH_CLIENT_SECRET=$(oc sa get-token syndesis-oauth-client) \
       -p SAR_PROJECT=$(oc project -q)

   EXTERNAL_HOSTNAME は、Fuse Online 環境のパブリックアドレスに置き換えます。たとえば、アドレスは public-fuse-online.127.0.0.1.nip.io のようになります。

   このコマンドは、前のステップで作成した syndesis-public-oauthproxy テンプレートを使用して、Fuse Online のパブリック REST API を公開する OAuth プロキシープロセスを作成します。この OAuth プロキシーは、OpenShift サービスアカウントトークンを使用して、外部ツールが新規のパブリックネットワークアドレスで Fuse Online パブリック API にアクセスできるようにします。

手順

1. この Fuse Online 環境のパブリック REST API を公開したときに作成したサービスアカウントのシークレットトークンの名前を取得します。たとえば、cicd-client がサービスアカウントの名前である場合、以下のコマンドを実行します。

   $ oc describe serviceaccount cicd-client

   これにより、以下のような 2 つのトークンの名前が含まれる、cicd-client サービスアカウントの情報の一覧が表示されます。

   Copy to Clipboard Toggle word wrap

   Tokens:      cicd-client-token-gxb25
                cicd-client-token-gxdnv

2. いずれかのトークンの内容を表示します。以下に例を示します。

   $ oc describe secret cicd-client-token-gxb25

   これにより、token: とそれに続く長いランダムな文字を表示する Data セクションなど、情報の一覧が表示されます。これはサービスアカウントの 2 つのシークレットトークンの 1 つです。

3. シークレットトークンをコピーし、ファイルに貼り付けて保存します。

手順

1. 左側の Fuse Online ナビゲーションパネルで Integrations をクリックします。
2. インテグレーションのリストで、マーク付けするインテグレーションのエントリーの右側で をクリックし、ポップアップメニューを表示し、Manage CI/CD をクリックします。

3. 表示されるダイアログで、以下のいずれかを行います。

   • このインテグレーションをマーク付けする環境が表示されている場合、その環境の左側にあるチェックボックスを選択します。
   • このインテグレーションをマーク付けする環境がすでに選択されている場合は、その環境を選択したままにしておきます。
   • 環境のラベルを作成する必要がある場合、Manage CI/CD をクリックすると、新しい環境ラベルを作成するダイアログが表示されます。必要なラベルを作成してから、この手順に戻り、インテグレーションをマーク付けします。

   Fuse Online によって、選択した環境ラベルがインテグレーションに適用されます。任意の数の環境ラベルをインテグレーションに適用できます。

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

手順

1. Fuse Online の左側のナビゲーションパネルで Integrations をクリックします。
2. 右上の Manage CI/CD をクリックします。

3. Manage CI/CD ページで以下を行います。

   • CI/CD 環境ラベルを作成するには、以下を実行します。

     1. Add New をクリックします。
     2. Add Tag Name ダイアログで、Tag Name 入力フィールドに新しい環境ラベルの名前を入力します (例: test1)。
     3. Save をクリックします。Manage CI/CD ページに、追加した環境ラベルの新しいエントリーがあります。

   • CI/CD 環境ラベルを変更するには、以下を実行します。

     1. CI/CD 環境ラベルの一覧内の、変更するラベルのエントリーで、Edit をクリックします。
     2. Edit Tag ダイアログで、必要に応じて名前を変更します。
     3. Save をクリックすると、環境ラベルのリストに更新された名前が表示されます。Fuse Online は、変更した環境ラベルですでにマーク付けされているすべてのインテグレーションに対し、更新された名前を適用します。

   • CI/CD 環境ラベルを削除するには、以下を実行します。

     1. CI/CD 環境ラベルの一覧内の、削除するラベルのエントリーで、Remove をクリックします。
     2. 確認ダイアログで、Yes をクリックします。Fuse Online は環境ラベルを削除し、削除される環境ラベルでマーク付けされたインテグレーションからもラベルを削除します。

手順

1. 最新の Fuse Online 1.8.x リリース (https://github.com/syndesisio/fuse-online-install/releases/tag/1.8) をダウンロードし、展開します。

2. Camel K を使用するよう Fuse Online を設定します。

   Copy to Clipboard Toggle word wrap

   $ bash install_ocp.sh --setup --camel-k

   これにより、Fuse Online と Camel K オペレーターがクラスターにインストールされます。

3. Fuse Online および Camel K をクラスターにインストールします。

   Copy to Clipboard Toggle word wrap

   $ bash install_ocp.sh --camel-k

   デフォルトでは、これにより現在の OCP プロジェクトに Fuse Online および Camel K ランタイムエンジンがインストールされ、スクリプトで Fuse Online にアクセスするルートが計算されます。Fuse Online がすでにインストールされている場合は、Camel K のみがインストールされます。

   注記

   camel-k がランタイムエンジンとしてインストールされると、spring-boot の従来の Camel インテグレーションランタイムが置き換えられます。