---
schema_version: "1"
id: a5ee5fd0affec2588eebc794a000b42a960af9bef1bc27429588021d382174f7
title: Helm を使用した自己管理型 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-helm.md
canonical_url: https://docs.mulesoft.com/jp/runtime-fabric/1.13/install-helm
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 907fa2ba0db4c09b81438d4dea9095a0d591f4780217900d4a367717b83728ac
description: MuleSoft Documentation Site
release: "1.13"
latest: false
---
# Helm を使用した自己管理型 Kubernetes の Runtime Fabric のインストール

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<div class="paragraph">
<p>自己管理型 Kubernetes の Runtime Fabric のインストールでは、IT 管理者と MuleSoft 組織システム管理者の両方が必須タスクを実行する必要があります。</p>
</div>
</td>
</tr>
</tbody></table>

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

## [](#helm-を使用して-runtime-fabric-をインストールする手順)Helm を使用して Runtime Fabric をインストールする手順

Helm を使用して Runtime Fabric をインストールする手順は次のとおりです。

1. Runtime Manager を使用して Runtime Fabric を作成します。
2. Runtime Fabric 用の ​`rtf`​ 名前空間を作成します。
3. Runtime Fabric コンポーネントイメージを取得するための Docker プルシークレットを作成します。
4. Runtime Fabric Helm リポジトリを追加します。
5. `values.yml`​ ファイルをダウンロードして Runtime Fabric をインストールします。
6. インストール手順を完了します。

## [](#始める前に)始める前に

自己管理型 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)​を実行している。
    - イングレスコントローラーを実行して外部要求をアプリケーションに送信している。
- Helm 3 以降をインストールして、特権ユーザー権限を持っている。

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Helm を使用して Runtime Fabric のインストールを管理する場合は、後で ​<code>rtfctl</code>​ コマンドラインユーティリティを使用して Mule ライセンスキーとプロキシを管理できます。ただし、​<a href="https://docs.mulesoft.com/jp/runtime-fabric/1.13/upgrade-helm" class="xref page">更新ドキュメント</a>​に説明されているように、インストール後の変更をすべて追跡する必要があります。</p>
</div>
</td>
</tr>
</tbody></table>

### [](#helm-のサポート)Helm のサポート

Runtime Fabric は、Helm バージョン 1.13 以降を使用したインストール、アップグレード、ロールバックをサポートしています。

## [](#runtime-manager-を使用して-runtime-fabric-を作成する)Runtime Manager を使用して Runtime Fabric を作成する

Helm を使用して自己管理型 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. サポート責任の免責事項を確認し、同意する場合は ​**\[Accept (同意)\]**​ をクリックします。
6. \[Helm\] をクリックします。

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Helm を使用したインストールプロセスの残りの手順では、プレースホルダー値を参照します。実際の値は、Runtime Fabric インスタンスを作成するときに Runtime Manager から取得できます。</p>
</div>
</td>
</tr>
</tbody></table>

## [](#runtime-fabric-用の-rtf-名前空間を作成する)Runtime Fabric 用の rtf 名前空間を作成する

Kubernetes のクラスターで、​`rtf`​ という名前の名前空間を作成する必要があります。この名前空間に Runtime Fabric コンポーネントをインストールします。

名前空間を作成するには、次のコマンドを実行します。

kubectl create ns rtf

## [](#docker-プルシークレットを作成する)Docker プルシークレットを作成する

名前空間を作成したら、Runtime Fabric のインストールと実行に必要な Docker イメージを取得できるように、プルシークレットを作成します。

デフォルトのレジストリ URL は ​`rtf-runtime-registry.kprod.msap.io`​ です。ローカルレジストリを使用している場合は、ここで値を指定してください。

プルシークレットを作成するには、次のコマンドを実行します。

kubectl create secret docker-registry <pull\_secret> --namespace rtf --docker-server=<docker\_registry\_url> --docker-username=<docker\_registry\_username> --docker-password=<docker\_ registry\_password>

## [](#runtime-fabric-helm-リポジトリを追加する)Runtime Fabric Helm リポジトリを追加する

作成した名前空間に Runtime Fabric Helm リポジトリを追加する必要があります。Runtime Fabric Helm リポジトリには、Runtime Fabric をインストールするのに必要なチャートが入っています。

Helm リポジトリを追加するには、次のコマンドを実行します。

helm repo add <name> <helm\_repo\_url> --username <your\_username> --password <your\_password>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>すでに Helm リポジトリが追加されていて、Runtime Fabric がリポジトリの追加をスキップしたという結果が返された場合は、新しい Runtime Fabric バージョンをインストール (またはそのバージョンにアップグレード) する前に ​<code>helm repo update</code>​ を実行してください。</p>
</div>
</td>
</tr>
</tbody></table>

## [](#runtime-fabric-のインストール)Runtime Fabric のインストール

Runtime Fabric をインストールするには、Runtime Manager から供給された ​`values.yml`​ ファイルを使用してください。

1. `values.yml`​ ファイルをダウンロードします。
2. 必要に応じて省略可能なパラメーターを追加します。
3. 次のコマンドを実行します。
    
    helm install runtime-fabric rtf/rtf-agent --version <VERSION\_FROM\_UI> -f values.yaml -n <namespace>

## [](#values-yml-reference)values.yml リファレンス

次に ​`values.yml`​ ファイルの例を示します。

activationData: <activation data>
  proxy:
    http\_proxy:
    http\_no\_proxy:
    monitoring\_proxy:
customLog4jEnabled: true
muleLicense: <mule license key>
global:
  image:
    rtfRegistry: rtf-runtime-registry.kprod.msap.io
    pullSecretName: rtf-pull-secret
  containerLogPaths:
  - /var/lib/docker/containers
  - /var/log/containers
  - /var/log/pods

### [](#必須パラメーター)必須パラメーター

Runtime Manager で Runtime Fabric を作成すると、次の必須パラメーターが作成されて ​`values.yml`​ に追加されます。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">キー</th>
<th class="tableblock halign-left valign-top">値</th>
<th class="tableblock halign-left valign-top">例</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>activationData</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アクティベーションデータ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">YW55cG9pbnQubXVsZXNvZnQuY29tOjBmODdmYzYzLTM3MWUtNDU2Yy1iODg5LTU5NTkyNjYyZjUxZQ==</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>rtfRegistry</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">レジストリ URL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>rtf-runtime-registry.kprod.msap.io</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>pullSecretName</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">レジストリシークレット</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&lt;pull_secret&gt;</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>muleLicense</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションの Mule ライセンス</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&lt;mule_license_key&gt;</code>​。Base64 エンコードである必要があります。</p></td>
</tr>
</tbody>
</table>

### [](#省略可能なパラメーター)省略可能なパラメーター

Runtime Fabric をインストールする前に、必要に応じて次の省略可能なパラメーターを ​`values.yml`​ で設定します。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">キー</th>
<th class="tableblock halign-left valign-top">値</th>
<th class="tableblock halign-left valign-top">例</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>customLog4jEnabled</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">カスタム Log4j 設定を有効化または無効化</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>customLog4jEnabled: false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><code>proxy.http_proxy</code>​</p>
</li>
<li>
<p><code>proxy.http_no_proxy</code></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">プロキシ値と no_proxy 値</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><code><a href="http://<user>:<pass>@<10.0.0.1>:<8080>" class="bare">http://&lt;user&gt;:&lt;pass&gt;@&lt;10.0.0.1&gt;:&lt;8080&gt;</a>;</code>​</p>
</li>
<li>
<p><code>&lt;1.1.1.1:8888,2.2.2.2:9999&gt;</code></p>
</li>
</ul>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>proxy.monitoring_proxy</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Monitoring のプロキシ値</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>socks5://&lt;user&gt;:&lt;pass&gt;@&lt;10.0.0.2&gt;:&lt;8080&gt;</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>global.containerLogPaths</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Filebeat の読み取りパス</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><code>/var/lib/docker/</code>​</p>
</li>
<li>
<p><code>/var/log/containers</code>​</p>
</li>
<li>
<p><code>/var/log/pods</code></p>
</li>
</ul>
</div></div></td>
</tr>
</tbody>
</table>

## [](#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/custom-ingress-configuration)
- [Runtime Fabric に Mule アプリケーションをデプロイする](https://docs.mulesoft.com/jp/runtime-fabric/1.13/deploy-to-runtime-fabric)