` を指定する必要はありません。このフラグは rtfctl バージョン 0.4.1 以降のみで導入されています。 ## [](#install-rtfctl)rtfctl のインストール

このセクション内のタスクは、IT 管理者が実行する必要があります。

AKS 用に Runtime Fabric を使用していて、AKS で管理される Azure AD インテグレーションが有効になっている場合、次のコマンドで rtfctl コマンドを実行するために必要なログイン情報が返されます。

az aks get-credentials --name <NAME> --resource-group <RESOURCE_GROUP> --admin

1. `rtfctl` コマンドラインツールをダウンロードします。 `rtfctl` は、Windows、MacOS (Darwin)、および Linux でサポートされています。適切な方法を選択してください。 - Windows curl -L https://anypoint.mulesoft.com/runtimefabric/api/download/rtfctl-windows/latest -o rtfctl.exe - MacOS (Darwin) curl -L https://anypoint.mulesoft.com/runtimefabric/api/download/rtfctl-darwin/latest -o rtfctl - Linux curl -L https://anypoint.mulesoft.com/runtimefabric/api/download/rtfctl/latest -o rtfctl 2. `rtfctl` コマンドラインツールのファイル権限を変更します。 chmod +x rtfctl ### [](#コマンドの実行)コマンドの実行 [「Organizing Cluster Access Using kubeconfig Files (kubeconfig を使用したクラスターアクセスの整理)」](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/)で説明されているように `rtfctl` コマンドラインツールで kubeconfig ファイルがコンシュームされます。この方法を使用して、管理するクラスターを設定します。`rtfctl` バイナリが現在の作業ディレクトリとユーザーの `$PATH` に存在することを確認します。 - 特権ユーザーとして `rtfctl` コマンドを実行します。 - サポートされているすべてのコマンドのリストを表示するには、`rtfctl -h` を実行します。 - 特定のコマンドの詳細については、`rtfctl -h` を実行します。 ### [](#プロキシ設定の確認)プロキシ設定の確認コマンドを実行すると、`rtfctl` は環境にプロキシ設定があるかどうかを確認します。このツールは `NO_PROXY` キー (大文字) を探して、`NO_PROXY` が使用されていない場合は `no_proxy` キー (小文字) を受け入れます。両方のキーがある場合、`rtfctl` は `NO_PROXY` を使用します。`rtfctl` ツールは、プロキシ設定に従うようにローカルの Kubernetes コンテキスト内でキーを設定します。 ## [](#configure-rtfctl)Runtime Fabric を設定するコマンド Runtime Fabric を設定するには次のコマンドを使用します。

コマンド説明

コマンド	説明
`apply`	Runtime Fabric 設定に変更を適用する
`update`	rtfctl を更新する
`wait`	Runtime Fabric コンポーネントが準備完了になるのを待機する
`renew-expired-client-cert`	事前ダウンロード済みパッケージを使用して期限切れのクライアント証明書を更新する

apply

Runtime Fabric 設定に変更を適用する

update

rtfctl を更新する

wait

Runtime Fabric コンポーネントが準備完了になるのを待機する

renew-expired-client-cert

事前ダウンロード済みパッケージを使用して期限切れのクライアント証明書を更新する

### [](#apply)`apply` Runtime Fabric 設定に変更を適用します。

rtfcl apply と一緒に値を使用しても、OpenShift では機能しません。OpenShift コンソールで値を更新する必要があります。

- HTTP プロキシ設定を適用する rtfctl apply http-proxy http://: --namespace - プロキシをバイパスするホスト名を指定して HTTP プロキシ設定を適用する rtfctl apply http-proxy http://: --no-proxy "DOMAIN1.com,DOMAIN2.com" --namespace - 認証を使用して HTTP プロキシ設定を適用する rtfctl apply http-proxy http://:@: --namespace - HTTP プロキシ設定をクリアする rtfctl apply http-proxy "" --no-proxy "" --namespace - セキュアプロパティを適用する rtfctl apply secure-property --key --value --app-namespace --namespace - ホストノードにシステム設定を適用する rtfctl apply system-configuration - 最新のスクリプトをダウンロードせずにホストノードにシステム設定を適用する rtfctl apply system-configuration --skip-download - Mule ライセンスを適用する rtfctl apply mule-license --namespace Runtime Fabric が Helm を介してインストールされている場合、Helm 値の `mule-license` プロパティを更新する必要があります。 - 監視プロキシを適用する rtfctl apply monitoring-proxy http://: --namespace - 監視プロキシ設定をクリアする rtfctl apply monitoring-proxy "" --namespace ### [](#update)`update` `rtfctl` を更新します。 - US コントロールプレーンから更新する rtfctl update - EU コントロールプレーンから `rtfctl` を更新する rtfctl update --host eu1.anypoint.mulesoft.com ### [](#wait)`wait` Runtime Fabric コンポーネントが準備完了になるのを待機する - 待機する秒数を指定する rtfctl wait --namespace - 待機をタイムアウトするまでの秒数を指定する (デフォルトは 600 秒) rtfctl wait --timeout --namespace ### [](#renew)`renew` 事前ダウンロード済みパッケージを使用して期限切れのクライアント証明書を更新する rtfctl renew-expired-client-cert ## [](#runtime-fabric-のインストールとアップグレードを行うコマンド)Runtime Fabric のインストールとアップグレードを行うコマンド Runtime Fabric のインストールやアップグレード、またはバックアップや復元を実行するときには次のコマンドを使用します。

コマンド説明

コマンド	説明
`install`	Runtime Fabric をインストールする
`backup`	ローカルの Runtime Fabric の状態をバックアップする
`restore`	ローカルの Runtime Fabric の状態をバックアップから復元する
`validate`	Runtime Fabric インストールのクラスターを検証する
`version`	Runtime Fabric のバージョン情報を表示する

install

Runtime Fabric をインストールする

backup

ローカルの Runtime Fabric の状態をバックアップする

restore

ローカルの Runtime Fabric の状態をバックアップから復元する

validate

Runtime Fabric インストールのクラスターを検証する

version

Runtime Fabric のバージョン情報を表示する

### [](#install)`install` - Runtime Fabric をインストールする rtfctl install - Docker イメージレジストリ URL およびシークレットを上書きする rtfctl install --image-pull-registry --image-pull-secret ### [](#backup)`backup` ローカルの Runtime Fabric の状態をバックアップします。 rtfctl backup .tar.gz --namespace ### [](#restore)`restore` ローカルの Runtime Fabric の状態をバックアップから復元します。 rtfctl restore .tar.gz --namespace ### [](#validate)`validate` Runtime Fabric インストールのクラスターを検証します。 - 検証チェックを実行する rtfctl validate - 検証チェックを実行し、プロキシ設定を含む `fabric.tf` 設定ファイルを渡す rtfctl validate -f プロキシを使用してインストールを検証するには、`settings` ファイル内でプロキシ設定を指定する必要があります。 MULE\_LICENSE= ACTIVATION\_DATA= HTTP\_PROXY=http://.com: - Docker イメージレジストリ URL およびシークレットを上書きする rtfctl validate --image-pull-registry --image-pull-secret ### [](#version)`version` Runtime Fabric のバージョン情報を表示する rtfctl version --namespace ## [](#manage-rtfctl-apps)Runtime Fabric 上のアプリケーションを管理するコマンド Runtime Fabric にデプロイされたアプリケーションを管理するには次のコマンドを使用します。

コマンド説明

コマンド	説明
`delete`	セキュアプロパティを削除する
`describe`	アプリケーションの詳細を表示する
`disk`	アプリケーションのディスク使用量を表示する
`memory`	ポッド内の JVM メモリ使用量を表示する
`package`	アプリケーションのデバッグ情報パッケージを作成する
`restart`	アプリケーションを再起動する
`heapdump`	JVM ヒープダンプを取得する
`threaddump`	JVM スレッドダンプを取得する

delete

セキュアプロパティを削除する

describe

アプリケーションの詳細を表示する

disk

アプリケーションのディスク使用量を表示する

memory

ポッド内の JVM メモリ使用量を表示する

package

アプリケーションのデバッグ情報パッケージを作成する

restart

アプリケーションを再起動する

heapdump

JVM ヒープダンプを取得する

threaddump

JVM スレッドダンプを取得する

### [](#delete)`delete` セキュアプロパティを削除する rtfctl delete secure-property -n ### [](#describe)`describe` 特定の名前空間でのアプリケーションの詳細を表示する rtfctl describe apps --namespace rtfctl describe apps --app-namespace --namespace ### [](#disk)`disk` アプリケーションのディスク使用量を表示する - デフォルトである最初のレプリカを使用してアプリケーションのディスク使用量を表示する rtfctl disk --app-namespace --namespace - 特定のレプリカを使用してアプリケーションのディスク使用量を表示する rtfctl disk --details --pod --app-namespace --namespace ### [](#memory)`memory` ポッド内の JVM メモリ使用量を表示する - 各レプリカの JVM メモリを取得する rtfctl memory --app-namespace --namespace - 特定のレプリカの JVM メモリを取得する rtfctl memory --pod --app-namespace --namespace ### [](#package)`package` アプリケーションのデバッグ情報パッケージを作成する - デフォルトである最初のポッドを使用してアプリケーションのパッケージを作成する rtfctl package --app-namespace --namespace - アプリケーション、ポリシー、`.mule` ディレクトリを含むアプリケーションのパッケージを作成する rtfctl package --apps --policies --dotmule --app-namespace --namespace - ヒープダンプを含むアプリケーションのパッケージを作成する rtfctl package --heap-dump --app-namespace --namespace ### [](#restart)`restart` アプリケーションを再起動する rtfctl restart --app-namespace --namespace ### [](#heapdump)`heapdump` JVM ヒープダンプをトリガーします。 - デフォルトである最初のレプリカを使用してアプリケーションの JVM ヒープダンプを実行し、`` `/tmp/dump.hprof `` として保存する rtfctl heapdump --app-namespace --namespace - 特定のレプリカを使用してアプリケーションの JVM ヒープダンプを実行し、`/tmp/dump.hprof` として保存する rtfctl heapdump --pod --app-namespace --namespace ### [](#threaddump)`threaddump` JVM スレッドダンプをトリガーします。 - デフォルトである最初のレプリカを使用してアプリケーションの JVM スレッドダンプを実行する rtfctl threaddump --app-namespace --namespace - 特定のレプリカを使用してアプリケーションの JVM スレッドダンプを実行する rtfctl threaddump --pod --app-namespace --namespace ## [](#troubleshooting-rtfctl)Runtime Fabric のトラブルシューティングを行うコマンド Runtime Fabric のトラブルシューティングを行うには次のコマンドを使用します。

コマンド説明

コマンド	説明
`get`	1 つ以上のリソースを表示する
`ping`	ネットワーク接続をテストする
`report`	診断レポートを生成する
`status`	Runtime Fabric の状況を表示する
`test`	Runtime Fabric コントロールプレーンへのアウトバウンドネットワーク接続を検証する

1 つ以上のリソースを表示する

ネットワーク接続をテストする

診断レポートを生成する

Runtime Fabric の状況を表示する

test

Runtime Fabric コントロールプレーンへのアウトバウンドネットワーク接続を検証する

### [](#get)`get` 1 つ以上のリソースを表示する - すべての環境のすべてのアプリケーションのリストを出力する rtfctl get apps --namespace - 特定の環境のすべてのアプリケーションのリストを出力する rtfctl get apps --app-namespace --namespace - HTTP プロキシ設定を表示する rtfctl get http-proxy --namespace - 監視プロキシ設定を表示する rtfctl get monitoring-proxy --namespace - セキュアプロパティを表示する rtfctl get secure-properties --app-namespace --namespace - Mule ライセンスを表示する rtfctl get mule-license --namespace - Runtime Fabric レジストリのログイン情報を表示する rtfctl get registry-credentials ### [](#ping)`ping` ネットワーク接続をテストする - デフォルトである最初のレプリカを使用してアプリケーション内部から example.com に ping する rtfctl ping --app-namespace --namespace - デフォルトである最初のレプリカを使用してアプリケーション内部からポート `12345` 上で example.com への接続を試みる rtfctl ping --port --app-namespace --namespace ### [](#report)`report` `rtf-report.tar.gz` に診断レポートを生成する rtfctl report --namespace 並列で実行されるタスクの数を制御する `workers` フラグを使用して、rtfctl report タスクを並列で実行します。デフォルト値は 10 です。 rtfctl report --workers `rtfctl report` と `--use-fast-compression` フラグによって生成される tarball の圧縮を高速化します。デフォルト値は false です。 rtfctl report --use-fast-compression=true `--namespaces` フラグを使用して、インストールの名前空間の他にレポートに含めるアプリケーションの名前空間を選択します。このフラグにより、レポートに含める内容が制御され、選択した名前空間のみがレポートされる場合は収集が高速化される可能性があります。 # Reports rtf installation default namespace (rtf) rtfctl report # Reports only rtfctl report -n # Reports for and application namespaces that belong to rtfctl report -n --app-namespaces , rtfctl report -n --app-namespaces --app-namespaces # Report for all application namespaces that belong to rtfctl report -n --app-namespaces all カスタムリリース名を使用したインストールをサポートするには、Helm リリースの名前を指定します。 rtfctl report --release-name ### [](#status)`status` Runtime Fabric の状況を表示する - JSON で状況出力を表示する rtfctl status --output json --namespace - Kubernetes DNS の健全性を確認する rtfctl status dns-check --node-label ":" ### [](#test)`test` Runtime Fabric コントロールプレーンへのアウトバウンドネットワーク接続を検証します。 - 任意のノードでのチェックをスケジュールする rtfctl test outbound-network --namespace - `node-label` パラメーターを満たすノードでのチェックをスケジュールする rtfctl test outbound-network --node-label ":" --namespace - すべてのノードでのチェックをスケジュールする rtfctl test outbound-network --all --namespace ## [](#使用方法)使用方法 ### [](#mule-ライセンスのインストール)Mule ライセンスのインストール 1. 必ずライセンスを Base64 でエンコードしてください。 2. 次のコマンドを実行します。 $ sudo ./rtfctl apply mule-license '' --namespace rtf1 Updating rtf namespace... OK ### [](#ヒープダンプの取得)ヒープダンプの取得 $ sudo /usr/local/bin/rtfctl heapdump hello-world /tmp/dump.hprof --app-namespace bed42b62-XXXX --namespace rtf1 Dumping heap for hello-world-f76484d8-l44qv... Heap dump written to /tmp/dump.hprof 追加の情報については、`rtfctl heapdump -h` コマンドを実行します。 ### [](#複数のレプリカとの連携)複数のレプリカとの連携 `--pod` フラグを受け入れるアプリケーション管理コマンドの場合、`describe` コマンドを使用してレプリカのリストを取得できます。 $ sudo ./rtfctl describe apps hello-world --app-namespace bed42b62-XXXX --namespace rtf1 Name: hello-world Namespace: bed42b62-XXXX Status: PROGRESSING Runtime: 2 ID: Version: Organization ID: d30f74c0-XXXX Replicas: 1 desired | 1 updated | 1 total | 0 available | 1 unavailable Name Status ---- ------ hello-world-77f5897949-z54gb Pending ## [](#auditing)rtfctl 操作の監査 `rtfct`l コマンドラインツール (v1.0.29 以降) は、クラスター上の `rtfctl` 操作を監査し、Runtime Fabric コアソフトウェアに影響を与える操作の追跡を支援します。以下の点に留意してください。 - 監査ログは `rtfctl-audit` 名前空間の Kubernetes シークレットに保存されます。 - 監査ログはクラスターにスコープ設定され、Runtime Fabric コアソフトウェアのライフサイクルには添付されません。 - 監査プロセスが操作の監査に失敗しても、コマンド実行は操作可能な状態を維持します。操作を監査するには、次のコマンドを実行します。 $ sudo ./rtfctl audit-logs 出力例: \[{"timestamp":"2023-10-26 00:52:24.446 +0000 UTC","kubeContext":"test-k8scontext","command":\["./rtfctl","restart","test-application","--app-namespace","8456f9c7-2149-4983-b02b-6b18ddd28efe","--namespace","rtf"\]}\]

現在、監査ログのロールオーバーや循環はサポートされていません。

## [](#rtfctl-出力の理解)rtfctl 出力の理解 `rtfctl` コマンドラインツールでは通常、他のアプリケーションやシステムツールを呼び出し、これらの呼び出しの出力は標準出力および標準エラー出力に送信されます。この出力は実行される各操作のコンテキストで記述されます。操作が成功したか失敗したかを明確にするために、`rtfctl` コマンドラインツールには最も詳細なコマンドの最後の出力行が含まれます。通常の操作には、停止しているシステムユニットをもう一度停止しようとした場合など、中間の_失敗_メッセージが含まれる場合があります。メッセージが問題を示しているかどうか疑わしい場合は、システム管理者と話し合うか、MuleSoft サポートにお問い合わせください。 ## [](#以前の-rtfctl-cli-バージョンのダウンロード)以前の rtfctl CLI バージョンのダウンロード次の REST API コールを使用して、さまざまな rtfctl ツールの CLI バージョンをダウンロードできます。 curl -L https://anypoint.mulesoft.com/runtimefabric/api/download/rtfctl/{version} -o rtfctl ## [](#関連情報)関連情報 - [Runtime Fabric で使用されるプロキシの管理](https://docs.mulesoft.com/jp/runtime-fabric/2.6/manage-proxy-self) - [Runtime Fabric でのセキュアプロパティの管理](https://docs.mulesoft.com/jp/runtime-fabric/2.6/manage-secure-properties)