---
schema_version: "1"
id: 489aa4e89ec610672f451a8b095bbcc1445a23c9e50695d6c18d3fd046b7054d
title: Helm 管理 Runtime Fabric への移行
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/runtime-fabric/2.8/migrate-helm.md
canonical_url: https://docs.mulesoft.com/jp/runtime-fabric/2.8/migrate-helm
source_site: docs.mulesoft.com
content_type: documentation
content_hash: d308af42e105c001308e613a868acfd6959325c4f7cd5ed7459366863ff1cf57
description: MuleSoft Documentation Site
release: "2.8"
latest: false
---
# Helm 管理 Runtime Fabric への移行

[rtfctl](https://docs.mulesoft.com/runtime-fabric/latest/install-self-managed)​ を使用してインストールされた Runtime Fabric を ​[Helm](https://docs.mulesoft.com/runtime-fabric/latest/install-helm)​ ネイティブに移行できます。

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

移行を実施する前に、次の点を考慮する必要があります。

- この移行は、​`rtfctl`​ を使用してインストールされ、Helm 管理に移行する BYOK クラスターに適用されます。
- クラスターは ​`rtf-agent`​ v2.2.5 以上で構築されている必要があります。移行を開始する前に、エージェントを必要なバージョンにアップグレードしておく必要があります。

さらに、次の詳細が必要です。

- organizationId
- fabricId
- **ファブリックの管理**​権限を持つ Anypoint ユーザーアカウント用のベアラートークン
- ダウンロード済みの rtfctl バージョン v1.0.10 以降

## [](#rtfctl-から-helm-に移行する)rtfctl から Helm に移行する

Runtime Fabric を rtfctl から Helm に移行するには、次のコマンドを実行します。

```copy
rtfctl migrate previous-rtf-bkp.tar.gz --organizationId <orgId value> --fabricId <fabricId value> --token <bearer token> --host anypoint.mulesoft.com  --confirm
```

このコマンドを実行すると、次のアクションが実行されます。

- 現在の Runtime Fabric のインストールをバックアップし、入力ファイル名で tarball を作成します。
- 現在の Runtime Fabric のインストールをアンインストールします。このコマンドを実行しても、Mule アプリケーションのデプロイメントは更新されず、rtf 名前空間に適用された設定や rtf 名前空間は削除されず、rtf 名前空間以外の名前空間には影響しません。古い Runtime Fabric Helm チャートのみをアンインストールします。
- 指定された fabricId のアクティベーションデータを再生成します。
- Helm 管理 rtf は Helm チャートの値を使用してシークレットを再作成するため、rtf 名前空間の custom-properties シークレットを削除します。
- Helm のコマンドで Runtime Fabric をインストールし、Runtime Fabric の Helm チャートを再レンダリングします。

コマンドを実行しても、Runtime Fabric は既存のインストールバージョン以外のバージョンにはアップグレードされません。

### [](#コマンドの成功)コマンドの成功

コマンドの実行に成功した場合は:

- Runtime Fabric が Anypoint Runtime Manager UI で Helm 管理されていることを確認できます。
- 移行前に適用したイングレステンプレート、永続性ゲートウェイ、カスタムリソース、プロキシ値などの構成が変更されていないことを確認できます。

### [](#コマンドの失敗)コマンドの失敗

コマンドの実行に失敗した場合は:

1. バックアップを使用して ​`rftctl restore`​ コマンドを実行します。
    
    ```copy
    rtfctl restore <path_to_backup_file>
    ```
2. `rfctl migrate`​ コマンドを再実行します。
    
    ```copy
    rtfctl migrate previous-rtf-bkp.tar.gz --organizationId <orgId value> --fabricId <fabricId value> --token <bearer token> --host anypoint.mulesoft.com  --confirm
    ```

## [](#コマンドのヘルプ)コマンドのヘルプ

コマンドのヘルプを表示するには、次のコマンドを実行します。

```copy
rtfctl migrate –help
```

## [](#アノテーションや表示ラベルを追加する)アノテーションや表示ラベルを追加する

移行後にアノテーションまたは表示ラベルを追加するには、次のコマンドを実行します。

アノテーションの場合:

```copy
kubectl annotate secret rtf-muleruntime-license -n rtf \

meta.helm.sh/release-name=runtime-fabric \

meta.helm.sh/release-namespace=rtf --overwrite
```

表示ラベルの場合:

```copy
kubectl label secret rtf-muleruntime-license -n rtf \

app.kubernetes.io/managed-by=Helm --overwrite
```