---
schema_version: "1"
id: 450ff47e65d9786abed471bc80058386cef8c3b6aecd57259a0833b3239e3fc9
title: Runtime Fabric でのローカルレジストリの使用
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/runtime-fabric/2.8/configure-local-registry.md
canonical_url: https://docs.mulesoft.com/jp/runtime-fabric/2.8/configure-local-registry
source_site: docs.mulesoft.com
content_type: documentation
content_hash: b3eabe76305d1874102877e6f7a4d4543079a9769a2b1752cae3343ecba5afad
description: MuleSoft Documentation Site
release: "2.8"
latest: false
---
# Runtime Fabric でのローカルレジストリの使用

Runtime Fabric では、独自のレジストリを使用して Runtime Fabric をインストールして管理し、Kubernetes でアプリケーションを実行するために必要な Docker イメージを保存します。セキュリティポリシーで、自分で管理しているレジストリから Docker イメージを取得することが要求されている場合は、これらの Docker イメージを取得して保存するようにローカルレジストリをセットアップできます。

## [](#ローカルレジストリのサポートに関する制限事項)ローカルレジストリのサポートに関する制限事項

Mule Docker イメージ (アプリケーションデプロイメントの管理用) と Runtime Fabric ソフトウェアイメージ (Runtime Fabric ソフトウェアの更新またはインストール用) を保存するために、すべての Runtime Fabric サポート対象プラットフォームベンダーにわたってローカルレジストリを設定できます。次の詳細と制限事項は、Mule Docker イメージと Runtime Fabric ソフトウェアイメージの両方に適用されます。

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">OpenShift 上の Runtime Fabric Operator のインストールまたは管理にローカルレジストリを使用することはできません。</td></tr></tbody></table>

- [Runtime Fabric コマンドラインユーティリティ (​`rtfctl`​)](https://docs.mulesoft.com/jp/runtime-fabric/2.8/install-rtfctl)​ バージョン 0.3.150 以降を使用できます。 `rtfctl`​ を使用すると、デフォルトで最新のバージョンに Runtime Fabric エージェントがインストールされます。
- Runtime Fabric のインストールとローカルレジストリの設定には Helm を使用できます。
- ローカルレジストリを使用できるのは、バージョン 1.12.0 以降の新しい Runtime Fabric インスタンスを作成する場合のみです。
    
    ローカルレジストリをセットアップする場合は、Runtime Fabric を再インストールせずに 1.12.0 より後のバージョンにアップグレードできます。
    
    既存の Runtime Fabric インスタンスにローカルレジストリを追加するには、インストールが Helm ベースの[Helm 管理 Runtime Fabric への移行](https://docs.mulesoft.com/jp/runtime-fabric/2.8/migrate-helm)であることを確認し、次のセクションのステップを実行してローカルレジストリを追加します。
- ローカルレジストリで使用するために Runtime Fabric インスタンスを作成した場合、​`rtf-runtime-registry`​ エンドポイントを使用するように後から再設定することはできません。​`rtf-runtime-registry`​ エンドポイントを使用するには、標準のインストール手順に従って新しい Runtime Fabric インスタンスをインストールする必要があります。
- お客様はローカルレジストリを必要な連動関係と同期する責任を負います。
    
    - [Runtime Fabric コアソフトウェアイメージまたは連動関係の自動同期](#synch-rtf)
    - [Mule Runtime イメージまたは連動関係の手動同期](#synch-runtime)
    - アプリケーションに必要なサードパーティ連動関係を同期します。  
        MuleSoft では、サードパーティの連動関係とイメージを同期するための追加のソフトウェアを提供していません。デプロイメントを始める前に、Mule アプリケーションのすべての連動関係イメージをローカルレジストリにプッシュしてください。
- 認証が必要なローカルレジストリを使用している場合、異なる名前空間の間でのプルシークレットの同期と伝播は各自の責任となります。または、シークレットで次の表示ラベルを使用している場合は、Runtime Fabric により異なる名前空間の間でプルシークレットを同期できます。

  labels:
    rtf.mulesoft.com/synchronized: "true"

- ローカルレジストリへのアクセス権を認証する必要がある場合は、 [対応するログイン情報が ​`rtf`​ 名前空間で Kubernetes シークレットとして設定されていること](https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/#registry-secret-existing-credentials)​を確認してください。Runtime Fabric をインストールするときに設定済みのシークレットの名前が必要になります。

## [](#synch-runtime)ローカルレジストリへの Mule Runtime の連動関係とイメージの同期

アプリケーションのデプロイメントに使用する Mule Runtime バージョンをレジストリ内で同期するには、​[「Mule runtime patch updates for Runtime Fabric Release Notes (Runtime Fabric リリースノートの Mule Runtime パッチ更新)」](https://docs.mulesoft.com/jp/release-notes/runtime-fabric/runtime-fabric-runtimes-release-notes)​を参照してください。イメージの場所は次の形式に従います: `rtf-runtime-registry.kprod.msap.io/mulesoft/`​。

## [](#synch-rtf)ローカルレジストリへの Runtime Fabric コアソフトウェアの連動関係とイメージの同期

Runtime Fabric をインストールするには、まず連動関係イメージをローカルレジストリに同期する必要があります。同期を実行するには自動的にスクリプトを実行するか手動でコマンドを実行します。

- 自動同期
- 手動同期

連動関係イメージを自動的に同期するには、​`docker`​、​`curl`​、​`jq`​ ツールを使用する bash スクリプトを実行します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">自動レジストリ同期は、Runtime Fabric バージョン 2.6.0 以降で使用できます。このスクリプトを使用して以前の連動関係を取得することはできません。</td></tr></tbody></table>

[Runtime Manager のアクセス管理権限](https://docs.mulesoft.com/jp/access-management/permissions-by-product#runtime-manager)​が ​**\[Read Runtime Fabric (Runtime Fabric の読み取り)\]**​ に設定されていることを確認します。この設定により、組織内で Runtime Fabric を照会できます。

1. Unix シェルで、次のスクリプトを実行します。​`agent-version`​、​`authorization-token`​、​`mulesoft-docker-server`​、およびその他のパラメーター値は適宜置き換えます。
    
    OpenShift 以外の環境の場合:
    
    ```copy
    ##!/usr/bin/env bash
    dependencies=$(curl <platform-url>/runtimefabric/api/agentmanifests/<agent-version>         -H 'Authorization: bearer <authorization-token>' | jq -c '.dependencies |.[] | select(.provider | contains("generic")) | "\(.artifact):\(.version)"' | sed 's/"//g')
    for i in $dependencies
    do
        echo "Processing $i"
        docker pull <mulesoft-docker-server>/mulesoft/$i
        docker tag  <mulesoft-docker-server>/mulesoft/$i <local-docker-server>/mulesoft/$i
        docker push <local-docker-server>/mulesoft/$i
    done
    ```
    
    OpenShift 環境の場合:
    
    ```copy
    ##!/usr/bin/env bash
    dependencies=$(curl <platform-url>/runtimefabric/api/agentmanifests/<agent-version>         -H 'Authorization: bearer <authorization-token>' | jq -c '.dependencies |.[] | select(.provider | contains("openshift")) | "\(.artifact):\(.version)"' | sed 's/"//g')
    for i in $dependencies
    do
        echo "Processing $i"
        docker pull <mulesoft-docker-server>/mulesoft/$i
        docker tag  <mulesoft-docker-server>/mulesoft/$i <local-docker-server>/mulesoft/$i
        docker push <local-docker-server>/mulesoft/$i
    done
    ```
    
    <table class="tableblock frame-all grid-all fit-content spread">
<caption class="title">Table 1. スクリプトパラメーター</caption>
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<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>platform-url</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Platform の URL。​<a href="https://anypoint.mulesoft.com" class="bare">https://anypoint.mulesoft.com</a> または <a href="https://eu1.anypoint.mulesoft.com" class="bare">https://eu1.anypoint.mulesoft.com</a> など。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>agent-version</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">同期に必要な Runtime Fabric エージェントのリリースバージョン。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>authorization-token</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">同期を実行するために接続アプリケーションを使用するのに必要な認証トークン。このトークンを使用すると、リンクは接続アプリケーションページにリダイレクトします。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mulesoft-docker-server</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">同期に必要な MuleSoft Docker サーバー。<br>
US コントロールプレーン: <code>rtf-runtime-registry.kprod.msap.io</code><br>
EU コントロールプレーン: <code>rtf-runtime-registry.kprod-eu.msap.io</code></p></td>
</tr>
</tbody>
</table>

連動関係イメージを手動で同期する手順は次のとおりです。

1. 自分の非公開コンテナレジストリにログインして次のコマンドを実行します。​`docker-server`​ は適宜置き換えます。
    
    US コントロールプレーンの場合:
    
    ```copy
    # docker pull rtf-runtime-registry.kprod.msap.io/mulesoft/rtf-agent:v1.12.0
    # docker tag rtf-runtime-registry.kprod.msap.io/mulesoft/rtf-agent:v1.12.0 <docker-server>/mulesoft/rtf-agent:v1.12.0
    # docker push <docker-server>/mulesoft/rtf-agent:v1.12.0
    ```
    
    EU コントロールプレーンの場合:
    
    ```copy
    # docker pull rtf-runtime-registry.kprod-eu.msap.io/mulesoft/rtf-agent:v1.12.0
    # docker tag rtf-runtime-registry.kprod-eu.msap.io/mulesoft/rtf-agent:v1.12.0 <docker-server>/mulesoft/rtf-agent:v1.12.0
    # docker push <docker-server>:5000/mulesoft/rtf-agent:v1.12.0
    ```

## [](#runtime-fabric-向けのローカルレジストリの設定)Runtime Fabric 向けのローカルレジストリの設定

ローカルレジストリをセットアップするには、レジストリを同期するために必要なログイン情報を収集して追加する必要があります。

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

次の作業を必ず実行しておいてください。

1. 非公開の Docker イメージレジストリをセットアップ、設定、およびテストします。
2. Runtime Fabric のインストールに必要なすべての Docker イメージをローカルレジストリに​[同期します](#synch-rtf)​。
    
    ご使用の Runtime Fabric バージョンの必須の連動関係については、​[「Runtime Fabric リリースノート」](https://docs.mulesoft.com/jp/release-notes/runtime-fabric/runtime-fabric-release-notes-2.x.x)​を参照してください。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">連動関係バージョンは Runtime Fabric バージョンに固有です。</td></tr></tbody></table>

`rtfctl`​ または ​`helm`​ とローカルレジストリを使用して Runtime Fabric をインストールするには、次のいずれかのオプションを選択します。

- RTFCTL
- Helm
- OpenShift

1. [`rtfctl`​ コマンドラインユーティリティ](https://docs.mulesoft.com/jp/runtime-fabric/2.8/install-self-managed#step-3-download-the-rtfctl-utility)​バージョン 0.3.150 以降をダウンロードしてインストールします。
2. `rtf-runtime-registry`​ ログイン情報を取得します。
    
    ```copy
    # rtfctl get registry-credentials <activation-data>
    ```
    
    このコマンドにより、現在のシェル環境で ​`RTF_IMAGE_REGISTRY_ENDPOINT`​、​`RTF_IMAGE_REGISTRY_USER`​、​`RTF_IMAGE_REGISTRY_PASSWORD`​ が設定されます。
3. 次のコマンドを実行して、​`rtf-runtime-registry`​ への Docker ログインが成功することを確認します。
    
    ```copy
    # eval $(rtfctl get registry-credentials <activation-data>)
    # docker login $RTF_IMAGE_REGISTRY_ENDPOINT --username $RTF_IMAGE_REGISTRY_USER --password $RTF_IMAGE_REGISTRY_PASSWORD
    ```
    
    ログインが成功したというメッセージが表示されます。
4. ローカルレジストリに​[コンテナイメージを同期します](#synch-rtf)​。
5. Runtime Fabric リリースノートでパブリッシュされているバージョンに基づいて、他のすべての連動関係イメージ (resourceFetcher、clusterOps など) でステップ 3 を繰り返します。
6. レジストリへのアクセスに認証を使用している場合は、rtf 名前空間で必須のシークレットを作成します。
    
    ```copy
    # kubectl create namespace rtf
    # kubectl create secret docker-registry regcred --namespace=rtf --docker-server=<docker_server> --docker-username=<docker_username> --docker-email=<docker_email> --docker-password=<docker_password>
    # kubectl label secret regcred rtf.mulesoft.com/synchronized=true -n rtf
    ```
7. Runtime Fabric インストールを最終処理して、ローカルレジストリから取得するように設定します。
    
    ```copy
    # rtfctl install ‘<activation_data>’ --image-pull-registry <docker-server>
    ```
    
    または、レジストリへのアクセスに認証を使用している場合は、次のコマンドを使用します。
    
    ```copy
    # rtfctl install ‘<activation_data>’ --image-pull-registry <docker-server> --image-pull-secret <your-local-reg-secret>
    ```
    
    このコマンドにより、Runtime Fabric でローカルレジストリ URL と ​`image-pull-secret`​ 値の必要なオーバーライドが作成され、Runtime Fabric がアップグレード後も引き続きローカルレジストリからイメージを取得するようになります。
8. レジストリへのアクセスに認証を使用している場合は、インストールの完了後に、RTF 名前空間とアプリケーションをデプロイする他の名前空間でプルシークレットを再作成する必要があります。
9. Mule ライセンスキーの挿入などの追加の手順については、​[インストール手順](https://docs.mulesoft.com/jp/runtime-fabric/2.8/install-self-managed)​を参照してください。

`rtfctl uninstall`​ コマンドにより、インストール中に指定したプルシークレットが削除されます。

`rtfctl`​ を使用してバックアップと復元の手順を実行するときに、バックアップはローカルレジストリ URL とプルシークレットを参照します。

1. ローカルレジストリに​[コンテナイメージを同期します](#synch-rtf)​。
2. [Runtime Manager を使用して Runtime Fabric を作成します](https://docs.mulesoft.com/jp/runtime-fabric/2.8/install-helm#create-a-runtime-fabric-using-runtime-manager)​。
3. Runtime Manager で、​**Helm**​ パスを選択し、画面プラットフォーム上の手順に従います。
4. 非公開の ​`docker-server`​、​`docker-username`​、​`docker-password`​ を取得します。
5. Runtime Manager で ​**Helm**​ パスの手順に従って Unix シェルで次のコマンドを実行して Docker サーバーの名前、ユーザー名、パスワードを使用したシークレットを作成します。
    
    ```copy
    kubectl create secret docker-registry rtf-pull-secret --namespace <rtf-namespace> --docker-server=<docker-servername> --docker-username=<docker-username --docker-password=<docker-password> --docker-email=<docker-email>
    ```

1. **Helm**​ パスの手順に従って ​`values.yml`​ ファイルをダウンロードし、その値を変更できるようにします。非公開のレジストリ設定の場合、ローカル Docker サーバーを使用して ​`rtfRegistry`​ を更新し、​`pullSecretName`​ パラメーターを更新します。
2. **Helm**​ パスの手順を続行し、Kubernetes クラスターに Runtime Fabric をインストールします。

1. ローカルレジストリに​[コンテナイメージを同期します](#synch-rtf)​。
2. [Runtime Manager を使用して Runtime Fabric を作成します](https://docs.mulesoft.com/jp/runtime-fabric/2.8/install-helm#create-a-runtime-fabric-using-runtime-manager)​。
3. Runtime Manager で、画面プラットフォーム上の手順に従います。
4. 非公開の ​`docker-server`​、​`docker-username`​、​`docker-password`​ を取得します。
5. Runtime Manager で手順に従って Unix シェルで次のコマンドを実行して Docker サーバーの名前、ユーザー名、パスワードを使用したシークレットを作成します。
    
    ```copy
    oc create secret docker-registry rtf-pull-secret --namespace <rtf-namespace> --docker-server=<docker-servername> --docker-username=<docker-username --docker-password=<docker-password> --docker-email=<docker-email>
    ```

1. OpenShift フォームビューで、rtfRegistry 値を設定してローカルレジストリを設定します。
    
    ![rtfRegistry の値を追加する OpenShift フォームビュー](/mulesoft/current/ja-jp/runtime-fabric/2.8/_images/ocp-local-registry.png)

1. OpenShift のインストールを続行します。

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

- [values.yml の設定リファレンス](https://docs.mulesoft.com/jp/runtime-fabric/2.8/install-helm#values-yml-reference)