Fazendo upgrade na IU

1. Crie um novo Databases for MongoDB para testar o processo de atualização.
   Crie a implantação restaurando um backup da sua implantação existente com a mesma versão.

2. Direcione seu aplicativo de teste para a implantação de teste.
   Atualize seu aplicativo de teste para que ele aponte para a implantação de teste. Verifique se seu aplicativo de teste consegue se conectar com sucesso à implantação de teste e se o aplicativo funciona conforme o esperado. Realizar todos os testes de desempenho e operacionais necessários no ambiente de teste.

3. Atualize a versão principal da sua implantação de teste clicando no botão “Atualizar versão principal ” na página “Visão geral ”.
   Isso colocará seu banco de dados no modo SOMENTE LEITURA enquanto o processo de atualização é concluído. Observe quanto tempo a atualização leva para ser concluída, para que você possa usar a configuração de validade da atualização para mantê-la dentro do seu horário de manutenção.

4. Verifique se o seu aplicativo de teste funciona com a nova versão do banco de dados.
   Se o seu aplicativo estiver funcionando, esta etapa confirma que é seguro atualizar seu banco de dados de produção.

5. Atualize a implantação do banco de dados de produção para a nova versão.
   Depois de confirmar que seu aplicativo funciona corretamente com a nova versão do banco de dados, você pode retornar ao console de gerenciamento e iniciar o processo de atualização da sua implantação em produção. Na seção “Detalhes da implantação ” da página “Visão geral ”, clique no botão “Atualizar versão principal” e siga as etapas.

   Uma vez iniciado o processo de atualização no local, ele não pode ser interrompido nem revertido. Portanto, na improvável hipótese de ocorrer um erro, a implantação do seu banco de dados poderia se tornar irrecuperável. Portanto, crie um backup que você possa usar posteriormente para restaurar em uma nova implantação. Se você selecionar “Atualização de versão principal no local com backup”, o backup criado poderá ser usado para restaurar em uma nova implantação.

O expiration for starting upgrade permite que você configure um período de “timeout” dentro do qual a tarefa de atualização deve ser iniciada, caso contrário ela será cancelada automaticamente. Além disso, teste a atualização no ambiente de teste com antecedência para garantir que ela seja concluída dentro do intervalo de tempo desejado. Se, por exemplo, você quiser concluir a atualização em até 1 hora e já tiver testado a atualização e souber que ela leva 30 minutos, então sua tarefa de atualização deverá ser iniciada no prazo de 30 minutos após você confirmar que deseja realizar a atualização. Portanto, defina o prazo de validade para 30 minutos, de modo que, se não iniciar dentro desse prazo, não ultrapasse o seu intervalo de tempo.

Fazendo upgrade por meio da API

Use o comando a seguir para atualizar no local:

curl -X PATCH https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version -H 'Authorization: Bearer <>' -H 'Content-Type: application/json' -d '{"version": "7.0"}'

O expiration for starting upgrade permite que você configure um período de “timeout” dentro do qual a tarefa de atualização deve ser iniciada, caso contrário ela será cancelada automaticamente. Além disso, teste a atualização no ambiente de teste com antecedência para garantir que ela seja concluída dentro do intervalo de tempo desejado. Se, por exemplo, você quiser concluir a atualização em até 1 hora e já tiver testado a atualização e souber que ela leva 30 minutos, então sua tarefa de atualização deverá ser iniciada no prazo de 30 minutos após você confirmar que deseja realizar a atualização. Portanto, defina o prazo de validade para um carimbo de data e hora de 30 minutos a partir de agora, de modo que, se não começar dentro desse prazo, não ultrapasse o seu intervalo de tempo. O prazo de validade deve estar entre 5 minutos (padrão) e 24 horas a partir de agora. Para obter mais informações, consulte a API do Cloud Databases.

Fazendo upgrade por meio da CLI

Disponível na versão do plug-in CDB >= 0.20.0

Para visualizar a lista de transições permitidas de atualização e restauração para a implantação:

ibmcloud cdb deployment-capability-show <NAME|CRN> versions

Para executar o comando de atualização com os parâmetros necessários:

ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION>

Para visualizar todos os detalhes dos parâmetros do comando:

ibmcloud cdb deployment-version-upgrade --help

O expiration for starting upgrade permite que você configure um período de “timeout” dentro do qual a tarefa de atualização deve ser iniciada, caso contrário ela será cancelada automaticamente. Além disso, teste a atualização no ambiente de teste com antecedência para garantir que ela seja concluída dentro do intervalo de tempo desejado. Se, por exemplo, você quiser concluir a atualização em até 1 hora e já tiver testado a atualização e souber que ela leva 30 minutos, então sua tarefa de atualização deverá ser iniciada no prazo de 30 minutos após você confirmar que deseja realizar a atualização. Portanto, defina o prazo de validade para 30 minutos, de modo que, se não iniciar dentro desse prazo, não ultrapasse o seu intervalo de tempo. O prazo de validade deve estar entre 5 minutos (padrão) e 24 horas a partir de agora. Existem duas maneiras de definir o prazo de validade usando a CLI: --expire-in ou --expire-at. Para obter mais informações, consulte a ajuda do comando.

Atualização por meio do Terraform

Disponível na versão do provedor Terraform >= 1.79.2

Para atualizar, basta adicionar ou alterar o valor de version na sua configuração. Há também um sinalizador booleano opcional, version_upgrade_skip_backup``, que você pode definir para ignorar o backup.

Não é recomendável pular um backup. Deixar de fazer um backup antes de uma atualização de versão é perigoso e pode resultar em perda de dados caso a atualização falhe em qualquer etapa — não haverá um backup imediato a partir do qual se possa restaurar os dados.

O banco de dados será colocado no modo SOMENTE LEITURA durante a atualização. É altamente recomendável realizar testes antes de atualizar.

A atualização pode levar mais tempo do que o tempo limite padrão. É possível definir um tempo limite mais longo usando o atributo timeouts.

O Terraform utiliza limites de tempo em vez de carimbos de data e hora de validade. Portanto, aumente o tempo de espera, pois o valor de atualização do tempo de espera é usado como prazo de validade. Por exemplo, se você definir um tempo limite de 20 minutos, o prazo de validade será fixado em 20 minutos e, se a atualização não for iniciada nesse período, ela expirará e a atualização não será iniciada. Observe que o prazo máximo de validade é de 24 horas — portanto, mesmo que você defina um tempo limite de 36 horas, a atualização expirará se não tiver sido iniciada nas primeiras 24 horas.

Se uma atualização estiver em andamento, observe que algumas tarefas podem estar na fila e não serão executadas até que a atualização de versão seja concluída.

Fazendo upgrade na IU

Para os novos modelos de hospedagem (computação isolada e computação compartilhada), a atualização para uma nova versão principal está disponível por meio da CLI e da API.

Você pode atualizar para uma nova versão restaurando um backup a partir da página “Backups e restauração” da sua implantação no console IBM Cloud. Clique em “Restaurar backup” em um backup para abrir uma página em uma nova aba, onde você poderá alterar algumas opções para a nova implantação. Uma delas é a versão do banco de dados, que é preenchida automaticamente com as versões disponíveis para as quais você fará upgrade. Selecione uma versão e clique em “Restaurar backup” para iniciar o processo de provisionamento e restauração.

Fazendo upgrade por meio da CLI

Ao fazer upgrade e restauração do backup por meio da CLI da IBM Cloud, use o comando de fornecimento do controlador de recurso.

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_ID> <SERVICE_PLAN_ID> <REGION>

Os parâmetros instance_name, service_id, service_plan_id e region são todos obrigatórios. Você também fornece o -p com a versão e os parâmetros de ID de backup em um objeto JSON. A nova implementação é dimensionada automaticamente com o mesmo disco e a memória que a implementação de origem no momento do backup.

ibmcloud resource service-instance-create example-upgrade databases-for-mongodb standard us-south \
-p \ '{
  "backup_id": "crn:v1:bluemix:public:databases-for-mongodb:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version":"7.0"
}'

Fazendo upgrade por meio da API

Assim como no provisionamento por meio da API, é necessário concluir as etapas necessárias para usar a API do controlador de recursos antes de poder utilizá-la para atualizar a partir de um backup. Em seguida, envie à API uma solicitação de POST. Os parâmetros name, target, resource_group e resource_plan_id são todos necessários. Informe também a versão e o ID do backup. A nova implementação tem a mesma alocação de memória e de disco que a implementação de origem no momento do backup.

curl -X POST   https://resource-controller.cloud.ibm.com/v2/resource_instances   -H 'Authorization: Bearer <>'   -H 'Content-Type: application/json'     -d '{
    "name": "my-instance",
    "target": "us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-mongodb-standard",
    "backup_id": "crn:v1:bluemix:public:databases-for-mongodb:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
    "version":"7.0"
  }'

Atualização por meio do Terraform

Use o Terraform para restaurar a partir de um backup de uma versão anterior para uma versão mais recente.

1. Defina seu backup_id. Para obter mais informações, consulte backup_id.
2. Defina seu version no atributo “version”. Para obter mais informações, consulte version.

O código é o seguinte:

resource "ibm_database" "<your-instance>" {
  name                                 = "<your_database_name>"
  service                              = "<service>"
  plan                                 = "<plan>"
  location                             = "<region>"
  version                              = "<version>"
  backup_id                            = "<backup_id>"
}

Para obter mais informações, consulte o Registro do Terraform da Cloud Databases.