Fazer upgrade para uma nova versão principal

À medida que as principais versões do banco de dados chegam ao fim da vida útil (EOL), a atualização para a próxima versão disponível garante suporte contínuo e desempenho ideal. Redis os detalhes da versão podem ser encontrados no catálogo, com o plug-in Cloud Databases CLI ou por meio da API Cloud Databases.

Caminho de upgrade simples

Como a maioria dos usos do Databases for Redis serve como um cache em que os dados tendem a ser transitórios, é melhor criar uma nova implantação. Neste método simples, provisione uma nova implementação usando a versão mais recente do Databases for Redis e, em seguida, aponte o seu aplicativo para a nova implementação. Isso cria o cache diretamente por meio do uso inicial.

Como fazer upgrade para uma nova versão principal

Prepare-se para executar e, em seguida, migrar para a versão mais recente antes da data EOL. Para obter mais informações, consulte Política de controle de versão.

O retrocesso de versões não é suportado

Faça upgrade para a versão mais recente do Redis disponível para Databases for Redis. Localize a versão mais recente da página de catálogos, do comando de plug-in da CLI Cloud Databases ibmcloud cdb deployables-showou do terminal da API Cloud Databases /deployables.

A atualização é feita restaurando um backup de seus dados em uma nova implementação. A restauração de um backup tem várias vantagens:

  • O banco de dados original permanece em execução e o trabalho de produção pode ficar sem interrupção.
  • É possível testar o novo banco de dados fora de produção e tomar ações com relação a quaisquer incompatibilidades do aplicativo.
  • O processo inteiro pode ser executado novamente em qualquer ponto.
  • Uma nova restauração reduz a probabilidade de que artefatos desnecessários da versão mais antiga do banco de dados sejam transportados para o novo banco de dados.

Caminhos de upgrade

Caminhos de atualização de versões principais
Versão atual Caminho de upgrade da versão principal
Databases for Redis V7.2 -> Databases for Redis V8.2

Fazendo upgrade usando a UI

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

Atualize para uma nova versão ao restaurar um backup na guia Backups e restauração na página Visão geral da sua implantação. Clique em Restaurar backup no menu de estouro ou na linha da tabela expandida do backup escolhido. Isso abre a página de provisionamento de restauração, na qual você pode selecionar opções para a nova implementação. Uma das opções é a Versão do banco de dados, que é preenchida automaticamente com as versões disponíveis para você. Selecione uma versão e clique em Restaurar backup para iniciar o processo de provisionamento e restauração.

Fazendo upgrade usando a 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 service-name, service-id, service-plan-id e region são todos necessá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.

A lista de backups e IDs de backup de uma implantação pode ser recuperada com o seguinte comando.

ibmcloud cdb deployment-backups-list <INSTANCE_NAME_OR_CRN> --json

Use o ID do backup escolhido como um parâmetro no comando do controlador de recursos, conforme mostrado abaixo.

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

Fazendo upgrade usando a API.

Da mesma forma que o provisionamento por meio da API, você precisa concluir as etapas necessárias para usar a API do controlador de recursos antes de poder usá-la para fazer upgrade de um backup. Em seguida, envie à API uma solicitação de POST. Os parâmetros name, target, resource_group, resource_plan_id, backup_id, service_endpoints, e version são todos obrigatórios. 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.

A lista de backups e IDs de backup para uma implantação pode ser recuperada usando a seguinte solicitação de API.

curl -X GET  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/backups  
-H 'Authorization: Bearer <token>' \

Use a ID do backup escolhido na solicitação da API do controlador de recursos, como no exemplo a seguir.

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

Backup e restauração: exemplo

Conclua as etapas de backup e restauração on demand a seguir para fazer upgrade Este exemplo define as etapas para atualizar para a versão mais recente.

Para criar um backup manual na interface do usuário:

  1. Acesse a guia Backups e restauração de sua instância do Databases for Redis
  2. Clique em Create backup: é exibida uma mensagem informando que um backup está em andamento e um backup sob demanda é adicionado à lista de backups disponíveis. O backup sob demanda pode ser visto na página de visão geral, no painel de tarefas recentes.

Para restaurar um backup para uma nova instância de serviço:

  1. Acesse a guia Backups e restauração

  2. Clique na linha correspondente para expandir as opções do backup sob demanda que você deseja restaurar

  3. Clique em Restore backup (Restaurar backup), que o redirecionará para a página da instância de restauração.

  4. Na página Restore (Restaurar ), você pode modificar o nome do serviço da nova instância, a região e os valores de alocação de recursos. Por padrão, a nova instância é dimensionada automaticamente para a mesma alocação de disco e memória que a instância de origem no momento do backup do qual você está restaurando. Em Configuração do serviço, selecione a versão mais recente disponível como Versão do banco de dados.

  5. Clique em Restore backup (Restaurar backup).

    Mantenha "appendonly=yes" durante a restauração do backup. Alterne para o modo de cache somente após a conclusão da restauração para evitar a perda de dados.

    Após a conclusão do provisionamento da nova instância, seus dados no arquivo de backup serão restaurados na nova instância. A nova instância atualizada pode ser acessada na lista de recursos.

Não exclua a instância de origem enquanto o backup estiver sendo restaurado. Antes de excluir a instância antiga, aguarde até que a nova instância seja provisionada e o backup seja restaurado. Excluir uma instância também exclui seus backups.

Upgrade forçado

Se você optar por não fazer o upgrade usando a restauração e o upgrade, o Databases for Redis será atualizado à força para a próxima versão principal no final da vida útil da versão.

Se você requerer migração de dados

Para obter orientação sobre migração, consulte Migrando para o Databases for Redis.