2.6. Fuse Online での重要事項
Fuse Online ディストリビューションの Fuse 7.11 リリースにおける重要事項
- Fuse 7 が現在メンテナンスサポート中であるため、Fuse Online のサポートは非推奨になりました。Fuse 7 のサポートが終了すると、Fuse Online の今後の開発は行われません。
- Fuse Online のインストールは、OCP 3.11 ではサポート対象外となります。
- Fuse Online は Camel K ランタイムまたは KNative コネクターをサポートしなくなりました。
- Fuse Online が Red Hat インフラストラクチャーにインストールされ、プロビジョニングされる場合、アカウントは同時に実行可能な特定数のインテグレーションに制限されます。詳細は、価格プランを参照してください。
- Fuse Online にアップロードする OpenAPI スキーマに出入力タイプが定義されていないことがあります。Fuse Online が出入力タイプを指定しない OpenAPI からカスタム API クライアントを作成した場合、API クライアントが処理できるフィールドにインテグレーションデータをマップするインテグレーションや、API クライアントが処理したフィールドから統合データをマップするインテグレーションを作成できません。インテグレーションにカスタム API をマップ先またはマップ元とするマッピングが必要な場合、OpenAPI スキーマをアップロードするときに Review/Edit をクリックして API 編集ツールの API Designer を開き、出入力タイプの指定を追加します。
- Fuse 7.8 以降、カスタム API クライアントコネクターまたは API プロバイダーインテグレーションに使用する OpenAPI ドキュメントは、循環スキーマ参照を持つことができません。たとえば、リクエストまたは応答ボディーを指定する JSON スキーマは、そのスキーマ自体を全体的に参照することはできず、任意数の中間スキーマを介してそれ自体を部分的に参照することもできません。
OCP 4.9 (またはそれ以降) では、
application-monitoringプロジェクトは機能しなくなりました。これは、Prometheus および Grafana で Fuse Online インテグレーションおよびインフラストラクチャーコンポーネントを監視するための前提条件です。この問題を回避するには、(
openshift-monitoringnamespace で) ビルトインのモニタリングスタック を使用してopenshift-user-workload-monitoring機能およびgrafana-operatorを使用し、以下の OCP 4.9 (またはそれ以降) に Fuse Online 監視リソース (Prometheus および Grafana) を追加する の手順の説明にあるように、ops addonを使用します。
2.6.1. OCP 4.9 (またはそれ以降) に Fuse Online 監視リソース (Prometheus および Grafana) を追加する リンクのコピーリンクがクリップボードにコピーされました!
前提条件
- Fuse Online は、オンサイトで OCP 4.9 (またはそれ以降) にインストールされ、実行されている。
-
ocクライアントツールがインストール済みであり、Fuse Online がインストールされている OCP クラスターに接続されている。 -
OCP クラスターへの
adminアクセスがある。 Fuse Online インストールが
ops addonが有効になっている状態で設定されている。必要に応じて、以下のコマンドで有効にすることができます。oc patch syndesis/app --type=merge -p '{"spec": {"addons": {"ops": {"enabled": true}}}}'oc patch syndesis/app --type=merge -p '{"spec": {"addons": {"ops": {"enabled": true}}}}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow
手順
既存の
openshift-monitoring設定がある場合は、手順 2 に進みます。それ以外の場合には、ユーザーワークロードモニタリングオプションを
trueに設定するopenshift-monitoring設定を作成し、手順 3 に進みます。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 既存の
openshift-monitoring設定がある場合:既存の
openshift-monitoring設定をチェックして、ユーザーワークロードモニタリング オプションが true に設定されるかどうかを判別します。oc get -n openshift-monitoring cm/cluster-monitoring-config -ojsonpath='{.data.config\.yaml}'oc get -n openshift-monitoring cm/cluster-monitoring-config -ojsonpath='{.data.config\.yaml}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 結果が
enableUserWorkload: trueの場合、ユーザーワークロードモニタリング オプションは true に設定されます。ステップ 3 に進みます。結果に他の設定が表示される場合には、次の手順に進み、ConfigMap を編集してユーザーワークロードの監視を有効にします。
以下のようにエディターで ConfigMap ファイルを開きます。
oc -n openshift-monitoring edit cm/cluster-monitoring-config
oc -n openshift-monitoring edit cm/cluster-monitoring-configCopy to Clipboard Copied! Toggle word wrap Toggle overflow enableUserWorkload を true に設定します。以下に例を示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ConfigMap ファイルを保存します。
以下のコマンドを使用して、
openshift-user-workload-monitoringnamespace の Pod のステータスを確認します。oc -n openshift-user-workload-monitoring get pods -w
oc -n openshift-user-workload-monitoring get pods -wCopy to Clipboard Copied! Toggle word wrap Toggle overflow Pod のステータスが Running になるまで待機します。以下に例を示します。
prometheus-operator-5d989f48fd-2qbzd 2/2 Running prometheus-user-workload-0 5/5 Running prometheus-user-workload-1 5/5 Running thanos-ruler-user-workload-0 3/3 Running thanos-ruler-user-workload-1 3/3 Running
prometheus-operator-5d989f48fd-2qbzd 2/2 Running prometheus-user-workload-0 5/5 Running prometheus-user-workload-1 5/5 Running thanos-ruler-user-workload-0 3/3 Running thanos-ruler-user-workload-1 3/3 RunningCopy to Clipboard Copied! Toggle word wrap Toggle overflow Prometheus で Fuse Online のアラートルールが有効になっていることを確認します。
内部 prometheus インスタンスにアクセスします。
oc port-forward -n openshift-user-workload-monitoring pod/prometheus-user-workload-0 9090
oc port-forward -n openshift-user-workload-monitoring pod/prometheus-user-workload-0 9090Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
ブラウザーを開いて
localhost:9090にアクセスします。 -
Status> Targets の順に選択します。3 つの
syndesisエンドポイントが表示されるはずです。 -
CTRL-C を押して、
port-forwardプロセスを終了します。
-
OperatorHub から、Grafana Operator 4.1.0 を選択した namespace(例:
grafana-middlewarenamespace) にインストールします。 クラスターロールとクラスターロールのバインディングを追加して、
grafana-operatorがノードおよび namespace をリスト表示できるようにします。grafana-operatorWeb サイトからクラスターロール YAML ファイルをダウンロードします。curl https://raw.githubusercontent.com/grafana-operator/grafana-operator/master/deploy/cluster_roles/cluster_role_grafana_operator.yaml > tmp_role.yaml
curl https://raw.githubusercontent.com/grafana-operator/grafana-operator/master/deploy/cluster_roles/cluster_role_grafana_operator.yaml > tmp_role.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow grafana-operatorのクラスターパーミッションを追加して、他の namespace およびノードを読み取ります。Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc apply -f tmp_role.yaml
oc apply -f tmp_role.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow Copy to Clipboard Copied! Toggle word wrap Toggle overflow
DASHBOARD_NAMESPACES_ALL環境変数を使用して namespace を制限することで、grafana-operatorが他の namespace から Grafana ダッシュボードを読み取れるようにします。oc -n grafana-middleware patch subs/grafana-operator --type=merge -p '{"spec":{"config":{"env":[{"name":"DASHBOARD_NAMESPACES_ALL","value":"true"}]}}}'oc -n grafana-middleware patch subs/grafana-operator --type=merge -p '{"spec":{"config":{"env":[{"name":"DASHBOARD_NAMESPACES_ALL","value":"true"}]}}}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow grafanaPod が再作成されていることを確認します。oc -n grafana-middleware get pods -w
oc -n grafana-middleware get pods -wCopy to Clipboard Copied! Toggle word wrap Toggle overflow 必要に応じて、
grafana-operatorログを表示します。oc -n grafana-middleware logs -f `oc -n grafana-middleware get pods -oname|grep grafana-operator-controller-manager` -c manager
oc -n grafana-middleware logs -f `oc -n grafana-middleware get pods -oname|grep grafana-operator-controller-manager` -c managerCopy to Clipboard Copied! Toggle word wrap Toggle overflow Grafana カスタムリソース を追加して、以下のように Grafana サーバー Pod を起動します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow grafana-operatorがモニタリング情報を読み取ることを許可します。oc -n grafana-middleware adm policy add-cluster-role-to-user cluster-monitoring-view -z grafana-serviceaccount
oc -n grafana-middleware adm policy add-cluster-role-to-user cluster-monitoring-view -z grafana-serviceaccountCopy to Clipboard Copied! Toggle word wrap Toggle overflow GrafanaDatasourceを追加して、thanos-querierをクエリーします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow grafana サーバーログを表示します。
oc logs -f `oc get pods -l app=grafana -oname`
oc logs -f `oc get pods -l app=grafana -oname`Copy to Clipboard Copied! Toggle word wrap Toggle overflow grafana URL にアクセスし、Fuse Online ダッシュボードを表示します。
echo "https://"$(oc -n grafana-middleware get route/grafana-route -ojsonpath='{.spec.host}')echo "https://"$(oc -n grafana-middleware get route/grafana-route -ojsonpath='{.spec.host}')Copy to Clipboard Copied! Toggle word wrap Toggle overflow