3.2. Fuse Online の設定変更に関する一般的な手順
OCP にインストールされる Fuse Online 環境では、syndesis カスタムリソースを更新して設定を変更できます。変更を保存した後、構文が正しい場合は OpenShift によって syndesis-operator が更新されます。構文エラーがある場合は更新されません。
syndesis カスタムリソースの編集中、構文が正しい無効な設定を指定しないようにしてください。構文が正しい設定が無効であっても、更新された syndesis カスタムリソースが syndesis-operator によって使用されます。無効な設定を指定した場合、OpenShift の更新後でのみ判明します。更新中、OpenShift では無効な設定が削除されます。
前提条件
- オンサイトで OCP に Fuse Online がインストールされている。
-
ocクライアントツールがインストール済みであり、Fuse Online がインストールされている OCP クラスターに接続されている。 - Fuse Online の設定を変更するプロジェクトで Fuse Online をインストールする権限がある。
-
Fuse Online の設定に使用するカスタムリソース属性の説明 を読み、インストール後に変更可能な設定と、
syndesisカスタムリソースを更新して設定変更を行う方法について理解する必要があります。
手順
Fuse Online をインストールする権限を持つアカウントで OpenShift にログインします。以下に例を示します。
oc login -u developer -p developer設定を変更する Fuse Online 環境を実行している OpenShift プロジェクトに切り替えます。以下に例を示します。
oc project my-fuse-online-project任意手順:誤った内容を更新および保存した場合に備え、
syndesisカスタムリソースに現在の設定のバックアップコピーを作成します。たとえば、以下のコマンドを実行すると、バックアップがsyndesis_app_backup.ymlファイルに保存されます。oc get syndesis app -o yaml > syndesis_app_backup.yml以下のコマンドを実行して、エディターで syndesis カスタムリソースを開きます。
oc edit syndesis/app注記: この手順では、エディターでカスタムリソースファイルを開き、設定する方法を説明します。この他にも、
oc patchコマンドを使用して、カスタムリソースを編集することもできます。-
必要に応じて
syndesisカスタムリソースを編集します。 リソースを保存します。
編集が適用されるオブジェクトのタイプに応じて、更新により
syndesis-operatorがトリガーされ、リソースの保存時に Fuse Online コンポーネントを再デプロイします。2 - 3 分間待ってから、
syndesisカスタムリソースが正しく更新されていることを確認します。以下のコマンドを実行して、
syndesisカスタムリソースの内容を表示します。oc describe syndesis/app内容を確認します。
syndesisカスタムリソースに必要な設定が含まれていない場合は、これを再度編集して有効な設定を指定します。
結果
syndesis カスタムリソースのほとんどの変更によって syndesis-operator がトリガーされ、Fuse Online syndesis-server が再デプロイされます。これは、OpenShift が新しいサーバー Pod を作成することを意味します。
新しいサーバーの準備が整うまで、最大 1 - 2 分ほどかかります。準備が整うまで Fuse Online コンソールを使用することはできません。新しいサーバーのデプロイ中も、稼働中のインテグレーションは稼働し続けます。新しいデプロイメントの準備が整ったら、新しいサーバーによってインテグレーションの状態がロードされます。以下の場合に、Fuse Online コンソールを再度使用できます。
-
syndesis-serverPod の状態がRunningである場合。 - Fuse Online コンソールを更新すると、インテグレーション、コネクション、メッセージ、および稼働時間の値が表示される場合。
syndesis カスタムリソースの変更によっては、Fuse Online 設定が更新されても syndesis-server の再デプロイメントは必要ないものがあります。以下に例を示します。
-
syndesisカスタムリソースを更新してバックアップを指定する場合、バックアップジョブが利用可能になるまで数秒かかります。
各設定変更の影響については インストール後に変更可能な Fuse Online の設定 を参照してください。