配置モデルの変更

Overview

既存のアプリの配置構成を変更して、新しいモデル、リージョン、クラウドプロバイダーに配置できます。 たとえば、アプリをグローバル配置から特定のローカルAmazon Web Servicesリージョンに切り替えたり、米国東部に配置されたアプリをAmazon Web ServicesからAzureに切り替えたりすることができます。 利用可能なすべてのオプションのリストについては、「配置モデルとリージョン 」を参照してください。

既存のアプリを移動するには、配置の移行を開始し、アプリのデータと構成を新しい構成に自動的に移動します。 移行プロセスは可能な限りシームレスになるように設計されていますが、 5から30分のダウンタイムが必要です。 移行ステータスは監視できますが、移行が完了するまでリクエストは処理されません。 詳細については、 配置移行プロセスを参照してください。

配置移行の実行

配置移行はいつでも開始できます。 1 つのアプリで一度に進行できる移行は 1 つだけです。 別の移行が進行中に移行を開始しようとすると、新しい移行は実行されず、エラーとなります。

Realm SDK からアプリに接続する場合は、配置モデルの変更をサポートするバージョンに SDK を更新する必要があります。 アプリの SDK バージョンが配置モデルの変更をサポートしていない場合は、アプリを再インストールする必要があります。 アップグレードする前に配置モデルを変更すると、SDK は接続できなくなり、リクエストは失敗します。

SDK の最小バージョン:

• Realm C++ SDK v0.2.0

• Realm Flutter SDK v1.2.0

• Realm Kotlin SDK v1.10.0

• Realm .NET SDK v11.1.0

• Realm Node.js SDK v12.0.0（保留中のリリース）

• Realm React Native SDK v12.0.0（保留中のリリース）

• Realm Swift SDK v10.40.0

{
  "deployment_model": "GLOBAL",
  "provider_region": "aws-us-east-1"
}

{
  "deployment_model": "LOCAL",
  "provider_region": "azure-westus"
}

curl -X PUT \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/deployment_migration \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>' \
  -d '{
    "deployment_model": "<DeploymentModel>",
    "provider_region": "<RegionID>"
  }'

curl -X GET \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/<groupId>/apps/<appId>/deployment_migration \
  -H 'Authorization: Bearer <AccessToken>'

配置移行プロセス

配置移行により、アプリのデータと構成が一連のステージで 1 つ以上の新しいリージョンに移動されます。 各ステージで、プロセスはアプリの一部を新しいモデルに移行し、前のモデルからのアーティファクトをクリーンアップします。

配置移行では、次のステージを順番に通過します。

1. "started": 移行は開始されました

2. "downtime": 移行の進行中はアプリが利用できません

3. "enabling_event_subscriptions": アプリの trigger と Device Sync トランスレーターが有効になっている

4. "cleanup": 配置アーティファクトがクリーンアップされています

5. 移行は完了し、次の 2 つの状態のいずれかになります。

   • "successful": 移行が正常に完了しました

   • "failed": 移行は失敗しました