Reverter um sistema
Nesta página
Visão geral
Você pode reverter a configuração de um aplicativo para uma versão implantada anteriormente. O App Services pode reimplantar automaticamente qualquer uma das 25 implantações mais recentes de um aplicativo. Para sistemas mais antigos, você deve obter e distribuir manualmente os arquivos de configuração (por exemplo, do controle de origem).
Uma redistribuição reverte a configuração do aplicativo para corresponder à versão anterior.
Antes de começar
Você precisará do seguinte para reverter uma aplicação na UI do Atlas:
Uma conta do MongoDB Atlas com permissões de Proprietário do Projeto. Para saber como se inscrever em uma conta gratuita, consulte Comece a usar o Atlas.
Você precisará do seguinte para reverter um aplicativo com a API de administrador:
Uma conta do MongoDB Atlas com permissões de Proprietário do Projeto. Para saber como criar uma conta gratuita, consulte Comece a usar o Atlas .
Uma admin API do MongoDB Atlas par de chaves pública/privada. A chave da API deve ter permissões do Proprietário do projeto para trabalhar com o App Services Admin API.
A string hexadecimal ObjectId interna do seu aplicativo e o ID do Projeto do Projeto Atlas que contém seu aplicativo. Para saber como encontrá-los, consulte Obter metadados do aplicativo.
Procedimento
Confirmar sucesso do rollback
Após a conclusão do sistema, você verá o banner de sucesso do sistema. O novo sistema aparece em seu Histórico de sistemas.
Se você tiver o sistema Github habilitado, ele também conterá um link para a confirmação no repositório Github.
No repositório vinculado do Github , o autor do commit é o bot mongodb-realm.
Autenticar um usuário do MongoDB Atlas
Chame o endpoint de autenticação do usuário administrador com seu par de chaves da API do MongoDB Atlas:
curl -X POST \ https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -d '{ "username": "<Public API Key>", "apiKey": "<Private API Key>" }'
Se a autenticação for bem-sucedida, o corpo da resposta conterá um objeto JSON com um valor access_token :
{ "access_token": "<access_token>", "refresh_token": "<refresh_token>", "user_id": "<user_id>", "device_id": "<device_id>" }
O access_token concede acesso à App Services Admin API. Você deve incluí-lo como um token do portador no cabeçalho Authorization para todas as solicitações de API Admin.
Encontre o ID da implantação
Você precisa do _id do sistema que deseja reimplantar. Para encontrá-lo, ligue para o endpoint List Deployments , que responde com uma lista dos sistemas mais recentes 25 do aplicativo.
Encontre o sistema que você deseja reimplantar na lista e copie seu _id.
curl -X GET \ https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/deployments \ -H 'Authorization: Bearer <access_token>'
[ { "_id": "638662e881ad88c37dcb7656", "app_id": "63844243ec3f52ed48923213", "draft_id": "638662d6cc4b58e348927a7a", "user_id": "59231005d323af2275135258", "deployed_at": 1669751529, "origin": "UI", "commit": "", "status": "successful", "status_error_message": "", "diff_url": "", "name": "638662e881ad88c37dcb7656", "remote_location": "US-VA" }, { "_id": "638662b2fd660afffb39df01", "app_id": "63844243ec3f52ed48923213", "draft_id": "638662928d19776b743d3b30", "user_id": "593f1105d383ad2275165258", "deployed_at": 1669751475, "origin": "UI", "commit": "", "status": "successful", "status_error_message": "", "diff_url": "", "name": "638662b2fd660afffb39df01", "remote_location": "US-VA" } ]
Redistribuir o aplicativo
Você pode reverter para uma implantação anterior ligando para o endpoint Redeploy a Deployment . Passe o _id do sistema que você deseja reimplantar como o parâmetro deploymentId .
curl -X GET \ https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/deployments/{deploymentId}/redeploy \ -H 'Authorization: Bearer <access_token>'