Alterar modelos de implementação

Visão geral

Você pode alterar a configuração de implantação de uma aplicação existente para implantá-la em um novo modelo, região e/ou fornecedor de cloud. Por exemplo, você pode mudar sua aplicação de uma implantação global para uma região local específica da AWS ou mudar uma aplicação implantada no leste dos EUA da AWS para o Azure. Para obter uma lista de todas as opções disponíveis, consulte Modelos e regiões de implantação.

Para mover uma aplicação existente, você inicia uma Migração de sistema que move automaticamente os dados e a configuração da aplicação para a nova configuração. O processo de migração foi projetado para ser o mais fácil possível, mas requer de 5 a 30 minutos de inatividade. Você pode monitorar o status da migração, mas nenhuma solicitação será processada até que a migração seja concluída. Para obter mais informações, consulte Processo de migração de sistema.

Executar uma migração de sistema

Você pode iniciar uma migração de implantação a qualquer momento. Somente uma migração pode estar em andamento por vez para uma única aplicação. Se você tentar iniciar uma migração enquanto outra estiver em andamento, a nova migração não será executada e falhará com um erro.

Se você se conectar à sua aplicação a partir de um Realm SDK, deverá atualizar o SDK para uma versão que ofereça suporte à alteração dos modelos de implantação. Se a versão do SDK do seu aplicativo não permitir a alteração dos modelos de sistema, você precisará reinstalar o aplicativo. Se você alterar os modelos de implantação antes de atualizar, o SDK não poderá se conectar e as solicitações falharão.

Versão mínima do 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 (versão pendente)

• Realm React Native SDK v12.0.0 (versão pendente)

• 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>'

Processo de migração de sistema

As migrações de implantação movem os dados e a configuração do seu aplicativo para um ou mais novas regiões em uma série de estágios. Em cada estágio, o processo migra uma parte do seu aplicativo para o novo modelo e limpa quaisquer artefatos do modelo anterior.

Uma migração de sistema passa pelos seguintes estágios em ordem:

1. "started": a migração foi iniciada

2. "downtime": a aplicação não está disponível enquanto a migração está em andamento

3. "enabling_event_subscriptions": os triggers da aplicação e os tradutores de sincronização de dispositivos estão sendo habilitados

4. "cleanup": os artefatos da implantação estão sendo limpos

5. A migração foi concluída e pode estar em um dos dois estados:

   • "successful": a migração foi concluída com sucesso

   • "failed": a migração falhou