1. Homepage
  2. Runtime Fabric (1.13)
  3. 自己管理型 Kubernetes

  4. 自己管理型 Kubernetes の Runtime Fabric のインストール (rtfctl)

自己管理型 Kubernetes の Runtime Fabric のインストール

Runtime Fabric のコマンドラインツールである ​rtfctl​ を使用して、管理している Amazon Elastic Kubernetes Service (Amazon EKS)、Azure Kubernetes Service (AKS)、または Google Kubernetes Engine (GKE) 環境に Anypoint Runtime Fabric をインストールできます。

始める前に

自己管理型 Kubernetes 環境に Anypoint Runtime Fabric をインストールする前に、次のことを確認してください。

Runtime Fabric でローカルレジストリを使用する場合は、​「自己管理型 Kubernetes の Runtime Fabric でのローカルレジストリの使用」​のインストール手順に従ってください。インストール中にローカルレジストリをセットアップする必要があります。

Runtime Manager を使用して Runtime Fabric を作成する

自己管理型 Kubernetes の Runtime Fabric をインストールする前に、Runtime Manager を使用して Runtime Fabric を作成します。これは、インストール中に必要なアクティベーションデータを取得するために必要です。

  1. Anypoint Platform から [Runtime Manager] を選択します。

  2. [Runtime Fabric]​ をクリックします。

  3. [Create Runtime Fabric (Runtime Fabric を作成)]​ をクリックします。

  4. 新しい Runtime Fabric の名前を入力し、次のいずれかのオプションを選択します。

    • Amazon Elastic Kubernetes Service

    • Azure Kubernetes Service

    • Google Kubernetes Engine

  5. [Next (次へ)]​ をクリックします。

  6. [rtfctl]​ をクリックします。

  7. サポート責任​の免責事項を確認し、同意する場合は ​[Accept (同意)]​ をクリックします。

    Runtime Manager で Runtime Fabric を作成し、[Activation State (アクティベーション状態)] ページを表示します。このページには、Kubernetes サービスの Runtime Fabric をインストールするために使用されるアクティベーションデータが表示されます。次のセクションで使用するために、このデータをクリップボードにコピーします。

rtfctl ユーティリティをダウンロードする

自己管理型 Kubernetes の Runtime Fabric は、インストールおよび管理タスクに ​rtfctl​ コマンドラインユーティリティを使用します。​「Runtime Fabric コマンドラインツールのインストール」​を参照してください。

  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​ コマンドラインユーティリティのファイル権限を変更します。

    sudo chmod +x rtfctl

Runtime Fabric のインストール

Runtime Manager で Runtime Fabric を作成し、アクティベーションデータを取得したら、​rtfctl​ コマンドラインユーティリティを使用して Runtime Fabric を Kubernetes サービスにインストールします。

Kubernetes 設定が ​\~/.kube/config​ ディレクトリにない場合は、​rtfctl​ を実行する前に ​KUBECONFIG​ 環境変数を設定します。

export KUBECONFIG=<path-to-kubeconfig>

  1. Kubernetes 環境のインストールの準備が整っていることを確認します。

    rtfctl validate <activation_data>

    validate​ オプションで次のことを確認します。

    • Kubernetes 環境が実行中。

    • すべての必須コンポーネントが存在する。

    • すべての必須サービスが使用可能。

      rtfctl​ コマンドラインユーティリティは、Kubernetes 環境との非互換性を出力します。

  2. Runtime Fabric をインストールします。

    rtfctl install <activation_data>

    <activation_data>​ は、Runtime Manager を使用して Runtime Fabric を作成した後に取得されたアクティベーションデータです。インストール中、​rtfctl​ ユーティリティには発生したエラーが表示されます。

Mule ライセンスキーを挿入する

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

インストールが正常に完了したら、Mule ライセンスキーを挿入します。

  1. MuleSoft から提供された新しい Mule ​.lic​ ライセンスファイルを Base64 でエンコードします。

    • MacOS では、次のコマンドを実行します。

      BASE64_ENCODED_LICENSE=$(base64 -b0 license.lic)

    • Unix では、次のコマンドを実行します。

      BASE64_ENCODED_LICENSE=$(base64 -w0 license.lic)

    • 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))

  2. インストール中にリーダーとして機能するコントローラーノード (インストーラーノード) で、​rtfctl​ ユーティリティをライセンスキーの Base64 値と共に使用します。

    rtfctl apply mule-license $BASE64_ENCODED_LICENSE

  3. Mule ライセンスキーが適切に適用されていることを確認するには、次のコマンドを実行します。

    rtfctl get mule-license

イングレスリソーステンプレートの設定

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

イングレスコントローラーにカスタムアノテーションとイングレスクラス定義が必要な場合は、​「カスタムイングレス設定の定義」​の手順に従います。

GKE のお客様の場合、デフォルトで GKE と一緒に含まれているイングレスコントローラーによってアプリケーションごとに個別の HTTP ロードバランサーがプロビジョニングされます。詳細は、こちらの KB 記事​を参照してください。

Runtime Fabric を検証する

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

インストールが完了したら、Anypoint 組織内で Runtime Fabric をアクティブ化する必要があります。インストールを検証するには、Anypoint Runtime Manager に移動し、Runtime Fabric の状況が ​[Active (アクティブ)]​ であることを確認します。

アプリケーションを Runtime Fabric にデプロイする前に、次の手順を実行します。

  1. Runtime Fabric を少なくとも 1 つの Anypoint 環境に関連付けます。

  2. Kubernetes 環境に基づいてインバウンドトラフィック設定を確認および更新します。

  3. アプリケーションをデプロイして、Runtime Fabric が正しくインストールおよび設定されていることを確認します。

関連情報