1.6. Fuse Online のインストール
Fuse Online は、コアインテグレーション機能をサービスとして提供する、柔軟かつカスタマイズ可能なオープンソースプラットフォームです。Fuse Online を OpenShift 開発者ユーザーとしてインストールできます (管理者権限は必要ありません)。
以下は、Operator を使用して Fuse Online をインストールする一般的な手順です。
- OpenShift プロジェクト (namespace) にシークレットを作成し、Fuse Online Operator が必要なインストールテンプレートにアクセスできるように、Red Hat コンテナーレジストリーへの認証を設定します。
- Fuse Online Operator を OpenShift プロジェクト (namespace) にインストールします。Operator はインストール後に、選択された namespace で実行されます。
- インストールされた Operator から Fuse Online のインスタンスを作成します。デフォルト設定でインスタンスを作成するか、インスタンスのカスタムリソースを編集してインスタンスをカスタマイズすることができます。続いて、提供された URL から Fuse Online にアクセスできます。
Operator を使用して OCP 4.x に Fuse Online をインストールする方法の詳細は、以下を参照してください。
1.6.1. Red Hat レジストリーにアクセスするためのシークレットの作成
OCP 4.x では、Fuse Online Operator をインストールする前に、Fuse Online Operator をインストールする OpenShift プロジェクトごとに、シークレットを作成して Red Hat コンテナーレジストリーへの認証を設定する必要があります。
前提条件
- Fuse Online をインストールする OpenShift クラスターにアクセスできる必要があります。
-
oc
クライアントツールがインストール済みであり、Fuse Online をインストールする OCP クラスターに接続されている必要がある。 - Red Hat カスタマーポータルのアカウントまたは Red Hat Developer Program アカウントのログインクレデンシャル (ユーザー名、パスワード、およびメールアドレス) を把握している必要があります。Red Hat アカウントのユーザー名とパスワードを使用して、Docker レジストリーシークレットを作成したくない場合は、registry service account を使用して認証トークンを作成してください。
手順
ターミナルウィンドウで、管理者または開発者として OpenShift サーバーにログインします。
たとえば、管理者は以下を実行します。
oc login -u system:admin
たとえば、開発者は以下を実行します。
oc login -u developer -p developer
Operator をインストールする OpenShift プロジェクトに切り替えます。
oc project fuse-online
Red Hat カスタマーポータルアカウントまたは Red Hat Developer Program アカウントのクレデンシャルを使用して、docker-registry シークレットを作成します。
oc create secret docker-registry syndesis-pull-secret \ --docker-server=registry.redhat.io \ --docker-username=CUSTOMER_PORTAL_USERNAME \ --docker-password=CUSTOMER_PORTAL_PASSWORD \ --docker-email=EMAIL_ADDRESS
コマンドが正常に実行されると、OpenShift は以下の出力を返します。
secret/syndesis-pull-secret created
次のステップ
Operator をインストールした後 (サブスクリプションを作成し、Operator が選択した名前空間で実行された後)、Fuse Online インスタンスを追加する前に、作成したシークレットを Operator サービスアカウントにリンクする必要があります。「OperatorHub からの Fuse Online Operator のインストール」。
1.6.2. OperatorHub からの Fuse Online Operator のインストール
OpenShift Container Platform Web コンソールを使用して、OperatorHub から Fuse Online Operator をインストールできます。Fuse Online をインストールする各 OpenShift プロジェクト (namespace) について、以下の手順を実行します。
前提条件
- OpenShift クラスターの管理者権限または開発者権限を持っている必要があります。
- Red Hat レジストリーにアクセスするためのシークレットの作成 で説明されているように、Red Hat コンテナーレジストリーへの認証が設定されている必要があります。
-
oc
クライアントツールがインストール済みであり、Fuse Online をインストールする OCP クラスターに接続されている必要がある。
手順
- Web ブラウザーで OpenShift コンソールに移動し、管理者または開発者のクレデンシャルを使用してコンソールにログインします。
-
管理者としてログインしている場合には、Operators をクリックした後、OperatorHub をクリックします。
開発者としてログインしている場合は、Add をクリックしてから From Catalog カードをクリックします。 - Filter by keyword フィールドに Fuse Online を入力します。
- Red Hat Integration - Fuse Online カードをクリックします。Fuse Online Operator のインストールページが開きます。
Install をクリックします。Install Operator ページが開きます。
更新チャンネル は Operator の更新ストリームを定義し、サブスクライバーの更新をロールアウトするために使用されます。指定する値は、OCP 4.x のバージョンによって異なります。
- OCP 4.6 (以降) の場合は、チャンネルを fuse-online-7.n と入力します。n は現在のリリース番号になります。たとえば、Fuse 7.8 の場合は fuse-online-7.8 を入力します。
- Installation mode では、クラスターの namespace のリストから namespace (プロジェクト) を 1 つ選択します。Red Hat レジストリーにアクセスするためのシークレットの作成 で、docker レジストリーシークレットを作成したときに使用したものと同じ namespace を選択します。
Approval Strategy では、Automatic または Manual を選択し、Fuse Online Operator の更新が OpenShift によってどのように対処されるかを設定します。
- Automatic (自動) 更新を選択した場合、新しいバージョンの Fuse Online Operator が使用できるようになると、人的な介入なしで OpenShift Operator Lifecycle Manager (OLM) によって、Fuse Online の稼働中のインスタンスが自動的にアップグレードされます。
- Manual (手動) 更新を選択した場合、Operator の新しいバージョンが使用できるようになると、OLM によって更新リクエストが作成されます。クラスター管理者は、更新リクエストを手動で承認して、Fuse Online Operator を新しいバージョンに更新する必要があります。
- Install をクリックし、Fuse Online Operator を指定の namespace (プロジェクト) で利用可能にします。
- Fuse Online がプロジェクトにインストールされていることを確認するには、Operators をクリックした後、Installed Operators をクリックして Red Hat Integration - Fuse Online がリストに表示されることを確認します。
ターミナルウィンドウで以下のコマンドを入力し、(Red Hat レジストリーにアクセスするためのシークレットの作成 で作成した) シークレットを Fuse Online Operator サービスアカウントにリンクします。
oc シークレットリンク syndesis-operator syndesis-pull-secret --for=pull
次の手順
Fuse Online Operator のインストール後に、Fuse Online のインスタンスを OpenShift プロジェクトに追加します。
1.6.3. Fuse Online インスタンスの OpenShift 4.x プロジェクトへの追加
Fuse Online Operator を OpenShift 4.x プロジェクトにインストールした後に、Fuse Online のインスタンスを OpenShift プロジェクトに追加します。Fuse Online インスタンスは、開発者が Fuse Online にアクセスするために使用する URL を提供します。
前提条件
- Fuse Online Operator は現在の OpenShift プロジェクトにインストールされます。
OCP 環境では、Fuse Online が使用できる永続ボリュームが少なくとも 3 つ必要です。すべての永続ボリュームには、以下の設定要件が必要です。
-
capacity.storage:
1Gi
-
accessMode:
ReadWriteOnce
-
capacity.storage:
- デフォルトの Fuse Online インスタンスまたはカスタマイズされたインスタンスのどちらをインストールするかを決定します。指定できるカスタムリソース設定の詳細は、インストール前にデフォルトのカスタムリソースを編集する必要がある場合 を参照してください。
手順
ユーザーロールに応じて Create Syndesis ページにアクセスするには、以下の手順に従います。
管理者としてログインしている場合は、以下を実行します。
- Operators をクリックした後、Installed Operators をクリックします。
- Name 列で、Red Hat Integration - Fuse Online をクリックします。Operator Details ページが開きます。
- Provided APIs の Create Instance をクリックします。
開発者としてログインしている場合は、以下を実行します。
- Add をクリックしてから Operator Backed カードをクリックします。
- Syndesis CRD カードをクリックします。Syndesis CRD ページが開きます。
-
Create をクリックします。
Create Syndesis ページが開きます。
- 名前を入力するか、app をデフォルトのままにします。
- YAML view オプションを選択して、デフォルトのカスタムリソースを表示します。
任意手順:カスタムリソースを編集します。
指定できるカスタムリソース設定の詳細は、インストール前にデフォルトのカスタムリソースを編集する必要がある場合 および Fuse Online の設定に使用するカスタムリソース属性の説明 を参照してください。
Fuse Online のインストールプロセスでは、カスタムリソースで指定した設定を使用して、インストールされた Fuse Online 環境の設定を決定します。
- Create をクリックして Fuse Online インスタンスを作成します。OpenShift は、Fuse Online の Pod、サービス、およびその他のコンポーネントを起動します。
Fuse Online の URL を取得するには、以下を行います。
- Networking > Routes をクリックします。
- 正しいプロジェクトが選択されていることを確認してください。
- syndesis 行の Location 列で、Fuse Online の URL をクリックします。
- OpenShift ログインクレデンシャルを使用して、Fuse Online 環境にログインします。