

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Tutorial: Transição do Redis 6 para o Valkey em 023 AL2
<a name="redis6-to-valkey-al2023"></a>

A documentação a seguir descreve os principais aspectos da transição do Redis 6 para o Valkey em AL2 023.

## Cronograma de suporte para o Redis 6
<a name="redis6-support-al2023"></a>

 O Redis 6 chega ao fim da vida útil (EOL) em 31 de janeiro de 2027. Após essa data, o Redis 6 não receberá mais atualizações nem patches de segurança do projeto Redis. É altamente recomendável que os usuários migrem para o Valkey antes de janeiro de 2027 para garantir suporte contínuo e atualizações de segurança. 

 Para obter mais informações sobre os cronogramas de suporte da versão do Redis, consulte a documentação do [Redis End-Of-Life](https://github.com/redis/redis?tab=security-ov-file#security-policy) Schedule. 

## Introdução ao Valkey
<a name="valkey-introduction-al2023"></a>

 O Valkey é um fork de código aberto do Redis 7, mantido pela The Linux Foundation. É totalmente compatível com as versões 2.x a 7.2.x do Redis Open Source Software (OSS). O Valkey mantém a API e a funcionalidade conhecidas do Redis, oferecendo vários aprimoramentos: 
+ Desempenho aprimorado por meio de multisegmentação.
+ Maior eficiência de memória, especialmente no modo de cluster.
+ Replicação de canal duplo para melhor consistência de dados.

## Plano e cronograma de migração
<a name="valkey-migration-plan-timeline-al2023"></a>

 É altamente recomendável que os usuários migrem do Redis 6 para o Valkey antes de 31 de janeiro de 2027, quando o Redis 6 chegar ao fim da vida útil (EOL). Essa migração requer intervenção manual e não é automática. 

 O Amazon Linux recomenda essa migração para garantir atualizações contínuas de funcionalidade, suporte e segurança para aplicações dependentes do Redis. 

## Opções e etapas de migração
<a name="valkey-migration-option-steps-al2023"></a>

 Propomos três caminhos de migração para o Valkey com base nos seus requisitos de implantação e necessidades operacionais. 

### Opção 1: instalação de nova instância
<a name="new-instance-installation"></a>

Para novas implantações ou quando a migração de dados não for necessária:

1. Instale o Valkey:

   ```
   [ec2-user ~]$ sudo dnf install valkey
   ```

1. Inicie o Valkey:

   ```
   [ec2-user ~]$ sudo systemctl start valkey
   ```

1. (Opcional) Habilite o Valkey na inicialização:

   ```
   [ec2-user ~]$ sudo systemctl enable valkey
   ```

1. Verifique a instalação:

   ```
   [ec2-user ~]$ valkey-cli info server
   [ec2-user ~]$ valkey-cli ping
   ```

### Opção 2: substituição no local
<a name="in-place-replacement"></a>

Para instâncias existentes em que a persistência de dados não é necessária:

1. Interrompa o Redis 6:

   ```
   [ec2-user ~]$ sudo systemctl stop redis6
   ```

1. Instale o Valkey:

   ```
   [ec2-user ~]$ sudo dnf install valkey
   ```

1. (Opcional) Use a configuração do Redis 6 no Valkey:

   ```
   [ec2-user ~]$ sudo cp /etc/redis6/redis6.conf /etc/valkey/valkey.conf
   [ec2-user ~]$ sudo cp /etc/valkey/valkey.conf /etc/valkey/valkey.conf.backup
   [ec2-user ~]$ sudo chown valkey:root /etc/valkey/valkey.conf
   [ec2-user ~]$ sudo sed -i 's|^dir\s.*|dir /var/lib/valkey|g' /etc/valkey/valkey.conf
   ```

1. (Opcional) Use o arquivo de configuração sentinela do Redis 6 no Valkey:

   ```
   [ec2-user ~]$ sudo cp /etc/redis6/sentinel.conf /etc/valkey/sentinel.conf
   [ec2-user ~]$ sudo chown valkey:root /etc/valkey/sentinel.conf
   ```

1. Inicie o Valkey:

   ```
   [ec2-user ~]$ sudo systemctl start valkey
   ```

1. (Opcional) Habilite o Valkey na inicialização:

   ```
   [ec2-user ~]$ sudo systemctl enable valkey
   ```

1. Verifique a instalação do Valkey:

   ```
   [ec2-user ~]$ valkey-cli info server
   [ec2-user ~]$ valkey-cli ping
   ```

1. Remova o Redis 6:

   ```
   [ec2-user ~]$ sudo dnf remove redis6
   ```

### Opção 3: migração de dados
<a name="data-migration"></a>

Essa opção permite que você execute o Redis 6 e o Valkey simultaneamente.

1. Instale o Valkey sem remover o Redis 6:

   ```
   [ec2-user ~]$ sudo dnf install valkey
   ```

1. (Opcional) Use a configuração do Redis 6 no Valkey:

   ```
   [ec2-user ~]$ sudo cp /etc/redis6/redis6.conf /etc/valkey/valkey.conf
   [ec2-user ~]$ sudo cp /etc/valkey/valkey.conf /etc/valkey/valkey.conf.backup
   [ec2-user ~]$ sudo chown valkey:root /etc/valkey/valkey.conf
   [ec2-user ~]$ sudo sed -i 's|^dir\s.*|dir /var/lib/valkey|g' /etc/valkey/valkey.conf
   ```

1. (Opcional) Use o arquivo de configuração sentinela do Redis 6 no Valkey:

   ```
   [ec2-user ~]$ sudo cp /etc/redis6/sentinel.conf /etc/valkey/sentinel.conf
   [ec2-user ~]$ sudo chown valkey:root /etc/valkey/sentinel.conf
   ```

1. Modifique a configuração do Valkey:

   Edite `/etc/valkey/valkey.conf` e defina a diretiva “port” com um valor diferente (por exemplo, 6380) para evitar conflitos com o Redis 6.

1. Inicie o Valkey:

   ```
   [ec2-user ~]$ sudo systemctl start valkey
   ```

1. (Opcional) Habilite o Valkey na inicialização:

   ```
   [ec2-user ~]$ sudo systemctl enable valkey
   ```

1. Verifique a instalação do Valkey:

   ```
   [ec2-user ~]$ valkey-cli -p port info server
   [ec2-user ~]$ valkey-cli -p port ping
   ```
**nota**  
*port*Substitua pelo número da porta configurada.

1. Migre os dados:

   Agora você pode migrar dados do Redis 6 para o Valkey usando métodos de replicação ou transferência manual de dados.

1. Atualize as configurações das aplicações:

   Atualize gradualmente as aplicações para usar a porta do Valkey.

1. Remova o Redis 6:

   Depois que todos os dados e aplicações tiverem sido migrados, você poderá interromper e remover o Redis 6.

   ```
   [ec2-user ~]$ sudo systemctl stop redis6
   [ec2-user ~]$ sudo dnf remove redis6
   ```

**nota**  
 É altamente recomendável validar o processo de migração em um ambiente de teste antes de implementar mudanças nos sistemas de produção. 

## Tópicos relacionados
<a name="valkey-migration-related-topics-al2023"></a>

 Para saber mais sobre o Valkey: 
+ Valkey: [https://valkey.io/](https://valkey.io)
+ Migração do Vale: [https://valkey. io/topics/migration](https://valkey.io/topics/migration/)/