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
| 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:
- Acesse a guia Backups e restauração de sua instância do Databases for Redis
- 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:
-
Acesse a guia Backups e restauração
-
Clique na linha correspondente para expandir as opções do backup sob demanda que você deseja restaurar
-
Clique em Restore backup (Restaurar backup), que o redirecionará para a página da instância de restauração.
-
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.
-
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.