---
schema_version: "1"
id: 3dba73f8e4056e50be238cc17a63617e54ec5b5e20bad3eac36d95b76cdd066e
title: 自己管理型 Kubernetes の Runtime Fabric のインストール
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/runtime-fabric/1.13/install-self-managed.md
canonical_url: https://docs.mulesoft.com/jp/runtime-fabric/1.13/install-self-managed
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 9e977e7d2f754801de5540f1f6ffde3fee7f62c03bcdcc3e8a367bce32261074
description: MuleSoft Documentation Site
release: "1.13"
latest: false
---
# 自己管理型 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 をインストールする前に、次のことを確認してください。

- [「自己管理型 Kubernetes の Runtime Fabric」](https://docs.mulesoft.com/jp/runtime-fabric/1.13/index-self-managed)​で説明されているアーキテクチャと要件を確認した
- [自己管理型 Kubernetes の Runtime Fabric をサポートするようにネットワークを設定してある](https://docs.mulesoft.com/jp/runtime-fabric/1.13/install-self-managed-network-configuration)
- Kubernetes 環境を次のようにインストールして設定している:
    
    - EKS、AKS、または GKE Kubernetes 環境。その他の Kubernetes 環境はサポートされていません。
    - [サポートされている Kubernetes バージョン](https://docs.mulesoft.com/jp/runtime-fabric/1.13/index-self-managed#kubernetes-support)
    - 外部要求をアプリケーションに送信するためのイングレスコントローラー。
- 利用可能な最新の Runtime Fabric エージェントバージョンを使用してクラスターを作成します。最新バージョンを使用できない場合は、 [「How to Specify the RTF Agent Version in Upgrades^ (アップグレード時に RTF エージェントバージョンを指定する方法)」](https://help.mulesoft.com/s/article/RTF-Agent-upgrade-path)​を参照してください。

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-warning" title="Warning"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Runtime Fabric でローカルレジストリを使用する場合は、​<a href="https://docs.mulesoft.com/jp/runtime-fabric/1.13/configure-local-registry" class="xref page">「自己管理型 Kubernetes の Runtime Fabric でのローカルレジストリの使用」</a>​のインストール手順に従ってください。インストール中にローカルレジストリをセットアップする必要があります。</p>
</div>
</td>
</tr>
</tbody></table>

## [](#runtime-manager-を使用して-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-ユーティリティをダウンロードする)rtfctl ユーティリティをダウンロードする

自己管理型 Kubernetes の Runtime Fabric は、インストールおよび管理タスクに ​`rtfctl`​ コマンドラインユーティリティを使用します。​[「Runtime Fabric コマンドラインツールのインストール」](https://docs.mulesoft.com/jp/runtime-fabric/1.13/install-rtfctl)​を参照してください。

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 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-ライセンスキーを挿入する)Mule ライセンスキーを挿入する

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<div class="paragraph">
<p>このセクション内の手順は、IT 管理者が実行する必要があります。</p>
</div>
</td>
</tr>
</tbody></table>

インストールが正常に完了したら、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

## [](#イングレスリソーステンプレートの設定)イングレスリソーステンプレートの設定

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<div class="paragraph">
<p>このセクション内の手順は、IT 管理者が実行する必要があります。</p>
</div>
</td>
</tr>
</tbody></table>

イングレスコントローラーにカスタムアノテーションとイングレスクラス定義が必要な場合は、​[「カスタムイングレス設定の定義」](https://docs.mulesoft.com/jp/runtime-fabric/1.13/custom-ingress-configuration)​の手順に従います。

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>GKE のお客様の場合、デフォルトで GKE と一緒に含まれているイングレスコントローラーによってアプリケーションごとに個別の HTTP ロードバランサーがプロビジョニングされます。詳細は、こちらの <a href="https://help.mulesoft.com/s/article/Default-Ingress-Controller-Behavior-with-Runtime-Fabric-on-GKE">KB 記事</a>​を参照してください。</p>
</div>
</td>
</tr>
</tbody></table>

## [](#runtime-fabric-を検証する)Runtime Fabric を検証する

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<div class="paragraph">
<p>このセクション内の手順は、IT 管理者が実行する必要があります。</p>
</div>
</td>
</tr>
</tbody></table>

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

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

1. Runtime Fabric を少なくとも 1 つの Anypoint 環境に関連付けます。
2. Kubernetes 環境に基づいてインバウンドトラフィック設定を確認および更新します。
3. アプリケーションをデプロイして、Runtime Fabric が正しくインストールおよび設定されていることを確認します。

## [](#関連情報)関連情報

- [自己管理型 Kubernetes の Runtime Fabric](https://docs.mulesoft.com/jp/runtime-fabric/1.13/index-self-managed)
- [自己管理型 Kubernetes の Runtime Fabric のイングレスの設定](https://docs.mulesoft.com/jp/runtime-fabric/1.13/custom-ingress-configuration)
- [Runtime Fabric に Mule アプリケーションをデプロイする](https://docs.mulesoft.com/jp/runtime-fabric/1.13/deploy-to-runtime-fabric)