Fazendo upgrade na IU

1. Crie um novo site Databases for Elasticsearch para testar o processo de upgrade.
   Crie a implementação restaurando um backup de sua implementação existente com a mesma versão.

2. Aponte seu aplicativo de preparação para a implantação de teste.
   Atualize seu aplicativo de preparação para apontar para a implantação de teste. Confirme se o aplicativo de teste pode se conectar com êxito à implantação de teste e se o aplicativo funciona conforme o esperado. Realizar todos os testes operacionais e de desempenho necessários do ambiente de preparação.

3. Atualize a versão principal de 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 READ-ONLY enquanto o processo de atualização é concluído. Observe o tempo que o upgrade leva para ser concluído para que você possa usar a configuração de expiração do upgrade para conter os upgrades dentro da janela de manutenção.

4. Confirme se o aplicativo de teste funciona com a nova versão do banco de dados.
   Se o aplicativo funcionar, esta etapa confirma que é seguro fazer o upgrade do banco de dados de produção.

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

   Uma vez iniciado o processo de upgrade no local, ele não pode ser interrompido ou revertido. Portanto, no caso improvável de um erro, a implementação do banco de dados pode se tornar irrecuperável. Portanto, crie um backup que possa ser usado para restaurar em uma nova implementação. Se você selecionar `In-place major version upgrade with backup', o backup criado poderá ser usado para restauração em uma nova implementação.

O site expiration for starting upgrade permite que você configure um período de "tempo limite" dentro do qual o trabalho de upgrade deve ser iniciado antes de ser automaticamente cancelado. Além disso, teste o upgrade na preparação antecipadamente para garantir que o upgrade seja concluído dentro da janela de tempo desejada. Se, por exemplo, você quiser concluir o upgrade em 1 hora, testou o upgrade e sabe que ele leva 30 minutos, então o trabalho de upgrade deve ser iniciado em 30 minutos após a confirmação de que deseja fazer o upgrade. Portanto, defina a expiração para 30 minutos, para que, se não for iniciada dentro desse período, ela não ultrapasse sua janela.

Fazendo upgrade por meio da API

Use o seguinte comando para fazer o upgrade 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": "8.0"}'

O site expiration for starting upgrade permite que você configure um período de "tempo limite" dentro do qual o trabalho de upgrade deve ser iniciado antes de ser automaticamente cancelado. Além disso, teste o upgrade na preparação antecipadamente para garantir que o upgrade seja concluído dentro da janela de tempo desejada. Se, por exemplo, você quiser concluir o upgrade em 1 hora, testou o upgrade e sabe que ele leva 30 minutos, então o trabalho de upgrade deve ser iniciado em 30 minutos após a confirmação de que deseja fazer o upgrade. Portanto, defina a expiração para um carimbo de data/hora de 30 minutos a partir de agora, para que, se não for iniciada dentro desse período, não ultrapasse sua janela. A expiração deve estar entre 5 minutos (padrão) e 24 horas a partir de agora. Para obter mais informações, consulte a API Cloud Databases.

Fazendo upgrade por meio da CLI

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

Para exibir a lista de transições de upgrade e restauração permitidas para a implementação:

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

Para atualizar o comando com os parâmetros necessários:

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

Para ver todos os detalhes dos parâmetros de comando:

ibmcloud cdb deployment-version-upgrade --help

O site expiration for starting upgrade permite que você configure um período de "tempo limite" dentro do qual o trabalho de upgrade deve ser iniciado antes de ser automaticamente cancelado. Além disso, teste o upgrade na preparação antecipadamente para garantir que o upgrade seja concluído dentro da janela de tempo desejada. Se, por exemplo, você quiser concluir o upgrade em 1 hora, testou o upgrade e sabe que ele leva 30 minutos, então o trabalho de upgrade deve ser iniciado em 30 minutos após a confirmação de que deseja fazer o upgrade. Portanto, defina a expiração para 30 minutos, para que, se não for iniciada dentro desse período, ela não ultrapasse sua janela. A expiração deve estar entre 5 minutos (padrão) e 24 horas a partir de agora. Há duas maneiras de definir a expiração 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 version em sua configuração. Há também um sinalizador bool opcional, version_upgrade_skip_backup, que você pode definir para ignorar o backup.

Não é recomendável pular um backup. Ignorar um backup antes de uma atualização de versão é perigoso e pode resultar em perda de dados. Se o upgrade falhar em qualquer estágio, não haverá backup imediato para restauração.

O banco de dados será colocado no modo READ-ONLY durante a atualização. É altamente recomendável testar antes de fazer o upgrade.

A atualização pode exigir mais tempo do que o tempo limite padrão. Um valor de tempo limite mais longo pode ser definido com o uso do atributo timeouts.

O Terraform tem timeouts em vez de carimbos de data/hora de expiração. Portanto, aumente o tempo limite, pois o valor de atualização do tempo limite é usado como expiração. Por exemplo, se você definir um tempo limite de 20 minutos, a expiração será definida para 20 minutos e, se o upgrade não for iniciado nesse período, ela expirará e o upgrade não será iniciado. Observe que a expiração máxima é de 24 horas, portanto, mesmo que você defina um tempo limite de 36 horas, o upgrade expirará se não for iniciado 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 da versão seja concluída.

Fazendo upgrade na IU

Para 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 fazer upgrade para uma nova versão restaurando um backup na página Backups e restauração da sua implementação no console IBM Cloud. Clique em Restaurar backup em um backup para abrir uma página em uma nova guia, onde você pode 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-elasticsearch enterprise us-south \
-p \ '{
  "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version":"8.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-elasticsearch-enterprise",
    "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
    "version":"8.0"
  }'

Atualização por meio do Terraform

Use o Terraform para restaurar um backup de uma versão mais antiga para uma nova versão.

1. Defina seu backup_id. Para obter mais informações, consulte backup_id.
2. Defina seu version no atributo de versão. Para obter mais informações, consulte version.

O código é parecido com o seguinte:

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

Para obter mais informações, consulte o Cloud Databases Terraform Registry. Como alternativa, você pode usar o Terraform IBM Modules(TIM) para criar uma nova instância de banco de dados a partir de uma instância de backup. Para obter mais informações, consulte Exemplo de restauração a partir de backup.