Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerRuntime Fabric のコマンドラインツールである rtfctl
を使用して、管理している Amazon Elastic Kubernetes Service (Amazon EKS)、Amazon Elastic Kubernetes Service Anywhere (Amazon EKS-A)、Azure Kubernetes Service (AKS)、Alibaba Cloud Container Service for Kubernetes (ACK)、Google Kubernetes Engine (GKE)、Rancher Kubernetes Engine (RKE)、または VMware Tanzu Kubernetes Grid 環境に Anypoint Runtime Fabric をインストールできます。
複数のインスタンスをサポートする Runtime Fabric バージョン 2.2.5 以降には rtfctl バージョン 0.4.1 以降が必要です。
|
rtfctl は常に最新バージョンの Runtime Fabric エージェントをインストールします。
|
Kubernetes 環境に Anypoint Runtime Fabric をインストールする前に、次のことを確認してください。
「Runtime Fabric」で説明されているアーキテクチャと要件を確認した
Kubernetes 環境を次のようにインストールして設定している:
EKS、AKS、または GKE Kubernetes 環境。その他の Kubernetes 環境はサポートされていません。
サポートされている Kubernetes バージョン。
外部要求をアプリケーションに送信するためのイングレスコントローラー。
利用可能な最新の Runtime Fabric エージェントバージョンを使用してクラスターを作成します。最新バージョンを使用できない場合は、 「How to Specify the RTF Agent Version in Upgrades^ (アップグレード時に RTF エージェントバージョンを指定する方法)」を参照してください。
|
Runtime Fabric アプライアンス 1.x.x エージェントバージョンおよび Runtime Fabric 自己管理型 2.x.x エージェントバージョンとの rtfctl
バージョンの互換性を次の表に示します。
Runtime Fabric をインストールする前に、Runtime Manager を使用して Runtime Fabric を作成します。これは、インストール中に必要なアクティベーションデータを取得するために必要です。
Anypoint Platform から [Runtime Manager] を選択します。
[Runtime Fabric] をクリックします。
[Create Runtime Fabric (Runtime Fabric を作成)] をクリックします。
新しい Runtime Fabric の名前を入力し、次のいずれかのオプションを選択します。
Amazon Elastic Kubernetes Service
Azure Kubernetes Service
Google Kubernetes Engine
[Next (次へ)] をクリックします。
[rtfctl] をクリックします。
サポート責任の免責事項を確認し、同意する場合は [Accept (同意)] をクリックします。
Runtime Manager で Runtime Fabric を作成し、[Activation State (アクティベーション状態)] ページを表示します。このページには、Kubernetes サービスの Runtime Fabric をインストールするために使用されるアクティベーションデータが表示されます。次のセクションで使用するために、このデータをクリップボードにコピーします。
Runtime Fabric は、インストールおよび管理タスクに rtfctl
コマンドラインユーティリティを使用します。「Runtime Fabric コマンドラインツールのインストール」を参照してください。
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
Runtime Manager で Runtime Fabric を作成し、アクティベーションデータを取得したら、rtfctl
コマンドラインユーティリティを使用して Runtime Fabric を Kubernetes サービスにインストールします。
Kubernetes 設定が \~/.kube/config
ディレクトリにない場合は、rtfctl
を実行する前に KUBECONFIG
環境変数を設定します。
export KUBECONFIG=<path-to-kubeconfig>
Kubernetes 環境のインストールの準備が整っていることを確認します。
rtfctl validate <activation_data>
validate
オプションで次のことを確認します。
Kubernetes 環境が実行中。
すべての必須コンポーネントが存在する。
すべての必須サービスが使用可能。
rtfctl
コマンドラインユーティリティは、Kubernetes 環境との非互換性を出力します。
Runtime Fabric をインストールします。
rtfctl install <activation_data>
<activation_data>
は、Runtime Manager を使用して Runtime Fabric を作成した後に取得されたアクティベーションデータです。インストール中、rtfctl
ユーティリティには発生したエラーが表示されます。
プライベートレジストリのインストールでは、--cluster-ops-image
フラグを追加して、インストールするエージェントバージョンのリリースノートの説明に従ってイメージバージョンを選択します。
rtfctl install <ACTIVATION_DATA> --cluster-ops-image <local-reg-host>/mulesoft/rtf-cluster-ops:<version-here>
インストール中に Mule ライセンスキーを追加しなかった場合は、rtfctl
コマンドラインユーティリティまたは Helm を使用して追加できます。
ライセンスキーをインストールする前に Base64 形式にエンコードしてください。
MacOS では、次のコマンドを実行します。
base64 -b 0 -i <license-file>
Unix では、次のコマンドを実行します。
base64 -w0 <license-file>
Windows では、次のいずれかを選択します。
base64 ツールが含まれる WSL または Cygwin シェルを使用し、上記の Unix コマンドを使用します。
Windows git (C:\Program Files\Git\usr\bin) と一緒に含まれている base64.exe プログラムを使用します。
次の Powershell コマンドを使用します。
$BASE64_ENCODED_LICENSE=[convert]::ToBase64String((Get-Content -path "license.lic" -Encoding byte))
インストール中にリーダーとして機能するコントローラーノード (インストーラーノード) で、次のコマンドを実行します。
rtfctl apply mule-license $BASE64_ENCODED_LICENSE
ファイルパスを直接指定する Mule ライセンスを適用することもできます。
rtfctl apply mule-license --file /path/to/license.lic
rtfcl apply と一緒に値を使用しても、OpenShift では機能しません。OpenShift コンソールで値を更新する必要があります。
|
Mule ライセンスキーが適切に適用されていることを確認するには、次のコマンドを実行します。
rtfctl get mule-license
イングレスコントローラーにカスタムアノテーションとイングレスクラス定義が必要な場合は、「カスタムイングレス設定の定義」の手順に従います。
GKE のお客様の場合、デフォルトで GKE と一緒に含まれているイングレスコントローラーによってアプリケーションごとに個別の HTTP ロードバランサーがプロビジョニングされます。詳細は、こちらの KB 記事を参照してください。 |
インストールが完了したら、Anypoint 組織内で Runtime Fabric をアクティブ化する必要があります。インストールを検証するには、Anypoint Runtime Manager に移動し、Runtime Fabric の状況が [Active (アクティブ)]
であることを確認します。
アプリケーションを Runtime Fabric にデプロイする前に、次の手順を実行します。
Runtime Fabric を少なくとも 1 つの Anypoint 環境に関連付けます。
Kubernetes 環境に基づいてインバウンドトラフィック設定を確認および更新します。
アプリケーションをデプロイして、Runtime Fabric が正しくインストールおよび設定されていることを確認します。
アップグレードが失敗した場合に、自動的にトリガーされた以前のバージョンの Runtime Fabric にロールバックするには、ナレッジベース記事の 「How to Specify the RTF Agent Version in Upgrades (アップグレード時に RTF エージェントバージョンを指定する方法)^」ナレッジベース記事を参照してください。