Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerRuntime Fabric をローカルで管理するには、rtfctl
コマンドラインツールをインストールして使用します。rtfctl
ツールでは次のアクションがサポートされています。
Runtime Fabric の状況を取得する。
実行中のアプリケーションのヒープダンプまたはスレッドダンプを実行する。
実行中のアプリケーションのメモリ使用量を表示する。
プロキシ設定を管理する。
セキュアプロパティを管理する。
Mule ライセンスを管理する。
アラート送信者メールアドレスを管理します。
このセクション内のタスクは、IT 管理者が実行する必要があります。 AKS 用に Runtime Fabric を使用していて、AKS で管理される Azure AD インテグレーションが有効になっている場合、次のコマンドで rtfctl コマンドを実行するために必要なログイン情報が返されます。
|
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
rtfctl
コマンドラインツールのファイル権限を変更します。
sudo chmod +x rtfctl
「Organizing Cluster Access Using kubeconfig Files (kubeconfig を使用したクラスターアクセスの整理)」で説明されているように rtfctl
コマンドラインツールで kubeconfig ファイルがコンシュームされます。この方法を使用して、管理するクラスターを設定します。rtfctl
バイナリが現在の作業ディレクトリとユーザーの $PATH
に存在することを確認します。
特権ユーザーとして rtfctl
コマンドを実行します。
サポートされているすべてのコマンドのリストを表示するには、rtfctl -h
を実行します。
特定のコマンドの詳細については、rtfctl <command> -h
を実行します。
Runtime Fabric を設定するには次のコマンドを使用します。
コマンド | 説明 |
---|---|
Runtime Fabric 設定に変更を適用する |
|
rtfctl を更新する |
|
Runtime Fabric コンポーネントが準備完了になるのを待機する |
apply
Runtime Fabric 設定に変更を適用します。
HTTP プロキシ設定を適用する
rtfctl apply http-proxy http://<domain>:<port>
プロキシをバイパスするホスト名を指定して HTTP プロキシ設定を適用する
rtfctl apply http-proxy http://<domain>:<port> --no-proxy "DOMAIN.com,DOMAIN2.com"
認証を使用して HTTP プロキシ設定を適用する
rtfctl apply http-proxy http://username:password@<domain>.com:<port>
HTTP プロキシ設定をクリアする
rtfctl apply http-proxy "" --no-proxy ""
特定のポッドにイングレス configMap を適用する
自己管理型 Kubernetes の Runtime Fabric バージョン 1.8 および 1.9 のみ |
rtfctl apply ingress-configmap "/<pod>/<path-to-configMap.yaml>"`
セキュアプロパティを適用する
rtfctl apply secure-property --key <key> --value <value> -n <environment>
ホストノードにシステム設定を適用する
rtfctl apply system-configuration
最新のスクリプトをダウンロードせずにホストノードにシステム設定を適用する
rtfctl apply system-configuration --skip-download
Mule ライセンスを適用する
rtfctl apply mule-license '<BASE64-encoded-license>'
監視プロキシを適用する
rtfctl apply monitoring-proxy "socks5://<username>:<password>@<monitoring-URL>:<PORT>"`
監視プロキシ設定をクリアする
rtfctl apply monitoring-proxy ""
Runtime Fabric のインストールやアップグレード、またはバックアップや復元を実行するときには次のコマンドを使用します。
コマンド | 説明 |
---|---|
Runtime Fabric をインストールする |
|
ローカルの Runtime Fabric の状態をバックアップする |
|
ローカルの Runtime Fabric の状態をバックアップから復元する |
|
Runtime Fabric インストールのクラスターを検証する |
|
Runtime Fabric のバージョン情報を表示する |
install
Runtime Fabric をインストールする
rtfctl install <activation data>
Docker イメージレジストリ URL およびシークレットを上書きする
rtfctl install <activation data> --image-pull-registry <string> --image-pull-secret <string>
validate
Runtime Fabric インストールのクラスターを検証する
検証チェックを実行する
rtfctl validate <activation-data>
検証チェックを実行し、プロキシ設定を含む fabric.tf
設定ファイルを渡す
rtfctl validate -f <path-to-settings-file>
プロキシを使用してインストールを検証するには、settings
ファイル内でプロキシ設定を指定する必要があります。
MULE_LICENSE=<your-mule-license> ACTIVATION_DATA=<activation-data> HTTP_PROXY=http://proxy-domain.com:<port>
Runtime Fabric にデプロイされたアプリケーションを管理するには次のコマンドを使用します。
コマンド | 説明 |
---|---|
セキュアプロパティを削除する |
|
アプリケーションの詳細を表示する |
|
アプリケーションのディスク使用量を表示する |
|
ポッド内の JVM メモリ使用量を表示する |
|
アプリケーションのデバッグ情報パッケージを作成する |
|
アプリケーションを再起動する |
|
JVM ヒープダンプを取得する |
|
JVM スレッドダンプを取得する |
disk
アプリケーションのディスク使用量を表示する
デフォルトである最初のレプリカを使用してアプリケーションのディスク使用量を表示する
rtfctl disk <app-name>
特定のレプリカを使用してアプリケーションのディスク使用量を表示する
rtfctl disk <app-name> --details --pod <replica-name>
memory
ポッド内の JVM メモリ使用量を表示する
各レプリカの JVM メモリを取得する
rtfctl memory <app-name>
特定のレプリカの JVM メモリを取得する
rtfctl memory <app-name> --pod <app-name>-pod-1
package
アプリケーションのデバッグ情報パッケージを作成する
デフォルトである最初のポッドを使用してアプリケーションのパッケージを作成する
rtfctl package <app-name> <path-to-file>
アプリケーション、ポリシー、.mule
ディレクトリを含むアプリケーションのパッケージを作成する
rtfctl package <app-name> <path-to-file> --apps --policies --dotmule
ヒープダンプを含むアプリケーションのパッケージを作成する
rtfctl package <app-name> <path-to-file> --heap-dump
Runtime Fabric のトラブルシューティングを行うには次のコマンドを使用します。
コマンド | 説明 |
---|---|
1 つ以上のリソースを表示する |
|
ネットワーク接続をテストする |
|
診断レポートを生成する |
|
Runtime Fabric の状況を表示する |
|
Runtime Fabric コントロールプレーンへのアウトバウンドネットワーク接続を検証する |
get
1 つ以上のリソースを表示する
すべての環境のすべてのアプリケーションのリストを出力する
rtfctl get apps
特定の環境のすべてのアプリケーションのリストを出力する
rtfctl get apps --namespace <environment>
HTTP プロキシ設定を表示する
rtfctl get http-proxy
監視プロキシ設定を表示する
rtfctl get monitoring-proxy
セキュアプロパティを表示する
rtfctl get secure-properties
Mule ライセンスを表示する
rtfctl get mule-license
Runtime Fabric レジストリのログイン情報を表示する
rtfctl get registry-credentials <activation data>
ping
ネットワーク接続をテストする
デフォルトである最初のレプリカを使用してアプリケーション内部から example.com に ping する
rtfctl ping <app-name> example.com
デフォルトである最初のレプリカを使用してアプリケーション内部からポート 12345
上で example.com への接続を試みる
rtfctl ping <app-name> --port 12345
必ずライセンスを Base64 でエンコードしてください。
次のコマンドを実行します。
$ sudo ./rtfctl apply mule-license '<license-key-information>' Updating rtf namespace... OK
$ sudo /usr/local/bin/rtfctl heapdump hello-world /tmp/dump.hprof 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 --namespace bed42b62-XXXX 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
rtfctl
コマンドラインツールでは通常、他のアプリケーションやシステムツールを呼び出し、これらの呼び出しの出力は標準出力および標準エラー出力に送信されます。この出力は実行される各操作のコンテキストで記述されます。
操作が成功したか失敗したかを明確にするために、rtfctl
コマンドラインツールには最も詳細なコマンドの最後の出力行が含まれます。通常の操作には、停止しているシステムユニットをもう一度停止しようとした場合など、中間の失敗メッセージが含まれる場合があります。
メッセージが問題を示しているかどうか疑わしい場合は、システム管理者と話し合うか、MuleSoft サポートにお問い合わせください。