Como faço para me conectar aos clusters do ElastiCache sem servidor ou autogerenciados que são executados nos mecanismos ElastiCache para Valkey, Redis OSS ou Memcached?

Breve descrição

Observação: a resolução a seguir testa uma conexão somente para uso não planejado. Para obter uma lista de clientes compatíveis, consulte Conectar com bibliotecas de API do cliente Redis no site do Redis e Bibliotecas de clientes no site da Valkey.

Com base na configuração do seu cluster do ElastiCache, conclua as etapas na seção a seguir para testar sua conectividade:

• Conecte-se a um cluster não criptografado do ElastiCache para Valkey ou do ElastiCache para Redis OSS. Isso inclui clusters (modo de cluster desativado) e (modo de cluster ativado).
• Conecte-se a um cluster criptografado do ElastiCache para Valkey ou do ElastiCache para Redis OSS. Isso inclui clusters (modo de cluster desativado) e (modo de cluster ativado).
• Use telnet ou OpenSSL para se conectar a um cluster (modo de cluster desativado).
• Conecte-se a um cluster do ElastiCache para Memcached. Isso inclui clusters criptografados e não criptografados.
• Conecte-se a um cache do ElastiCache sem servidor.

Resolução

Observação: se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Conecte-se a um cluster não criptografado do ElastiCache para Valkey ou do ElastiCache para Redis OSS

O ElastiCache oferece suporte a ambos (modo de cluster desativado) e (modo de cluster ativado) em clusters Valkey e Redis OSS. Para testar uma conexão com os clusters, use o valkey-cli ou o redis6-cli. Para obter mais informações, consulte a CLI do Valkey no site da Valkey e a CLI do Redis no site da Redis.

Observação: para instalar o valkey-cli, consulte Conexão criptografada com Linux. Se o cluster não estiver criptografado, não inclua o parâmetro BUILD_TLS. Para testar com o Amazon Linux 2023, instale o pacote redis6. Este pacote inclui redis6-cli com suporte de criptografia padrão.

Para obter mais informações sobre como encontrar endpoints Redis, consulte Encontrar endpoints de conexão no ElastiCache.

Conecte-se a um cluster Valkey ou Redis OSS (modo de cluster desativado)

Para se conectar a um cluster (modo de cluster desativado), execute o seguinte comando:

Amazon Linux 2023:

redis6-cli -h yourEndpoint -p 6379

Amazon Linux e Amazon Linux 2:

src/valkey-cli -h yourEndpoint -p 6379

Observação: substitua yourEndpoint pelo endpoint do cluster e 6379 pelo número da porta.

Os comandos anteriores retornam um prompt de comando do Valkey semelhante ao exemplo a seguir:

yourEndpoint:6379>

Conecte-se a um cluster Valkey ou Redis OSS (modo de cluster ativado)

Para se conectar a um cluster (modo de cluster ativado), execute o seguinte comando:

Amazon Linux 2023:

redis6-cli -c -h yourConfigEndpoint -p 6379

Amazon Linux e Amazon Linux 2:

src/valkey-cli -c -h yourConfigEndpoint -p 6379

Observação: substitua yourConfigEndpoint pelo endpoint do cluster e 6379 pelo número da porta. O parâmetro -c ativa o modo de cluster após a ocorrência de redirecionamentos -ASK e -MOVED. Se você não ativar o redirecionamento, o comando retornará o erro MOVED.

Os comandos anteriores retornam um prompt de comando do Valkey semelhante ao exemplo a seguir:

yourConfigEndpoint:>

Conecte-se a um cluster criptografado do ElastiCache para Valkey ou do ElastiCache para Redis OSS

Para se conectar a um cluster criptografado (modo de cluster ativado) ou (modo de cluster desativado), use o parâmetro --tls no valkey-cli. O parâmetro --tls ativa a criptografia em trânsito para o cluster. Se houver um token AUTH definido no cluster, use o parâmetro -a para fornecer uma senha AUTH. Ou use o comando AUTH para autenticar, conforme mostrado nos comandos de exemplo a seguir.

Depois de ativar a criptografia em trânsito, atualize a configuração do cliente para usar os novos endpoints específicos do TLS. Para obter mais informações, consulte Práticas recomendadas ao habilitar a criptografia em trânsito.

Observação: em clusters com Valkey ou Redis OSS versões 7 e posteriores, é possível ativar a criptografia em trânsito para clusters existentes do ElastiCache. Você não precisa reconstruir seu cluster para alterar a configuração TLS do seu cluster Valkey ou Redis OSS.

Conecte-se a um cluster criptografado (modo de cluster desativado)

Para se conectar a um cluster (modo de cluster desativado) com criptografia e autenticação ativadas, execute o seguinte comando:

Amazon Linux 2023:

redis6-cli -h yourEndpoint -p 6379 --tls

AUTH <username> <password>

Amazon Linux e Amazon Linux 2:

src/valkey-cli -h yourEndpoint -p 6379 –tls

AUTH <username> <password>

Observação: substitua yourEndpoint pelo endpoint do cluster e 6379 pelo número da porta. Quando você usa AUTH com uma única forma de argumento do comando e especifica somente a senha, a CLI do Valkey assume que o nome de usuário é padrão. Para obter mais informações, consulte o comando AUTH no site da Valkey.

Conecte-se a um cluster criptografado (modo de cluster ativado)

Para se conectar a um cluster (modo de cluster ativado) com criptografia e autenticação ativadas, execute o seguinte comando:

Amazon Linux 2023:

redis6-cli -c -h yourConfigEndpoint -p 6379 –tls

AUTH <username> <password>

Amazon Linux e Amazon Linux 2:

src/valkey-cli -c -h yourConfigEndpoint -p 6379 –tls

AUTH <username> <password>

Observação: substitua yourConfigEndpoint pelo endpoint do cluster e 6379 pelo número da porta. Quando você usa AUTH com uma única forma de argumento do comando e especifica somente a senha, a CLI do Valkey assume que o nome de usuário é padrão. Para obter mais informações, consulte o comando AUTH no site da Valkey.

Use o telnet do OpenSSL para se conectar a um cluster (modo de cluster desativado)

Para executar um teste curto sem a configuração valkey-cli, use telnet ou OpenSSL para se conectar a um cluster (modo de cluster desativado). Depois de usar telnet ou OpenSSL para se conectar, é possível executar comandos Valkey.

O comando de exemplo a seguir se conecta a um cluster criptografado ou autenticado (modo de cluster desativado):

openssl s_client -connect master.valkeycmdencrypted.dcba18.use1.cache.amazonaws.com:6379

Se você definir uma senha para o cluster, conecte-se ao cluster e execute o comando a seguir para autenticar o cluster. Em seguida, pressione Enter:

AUTH <username> <password>

Observação: substitua username e password por suas credenciais de usuário.

O exemplo de comando a seguir se conecta a um cluster (modo de cluster desativado) que não tem criptografia ou autenticação ativada:

telnet yourEndpoint 6379

Conecte-se a um cluster do ElastiCache para Memcached

Para se conectar a um cluster do ElastiCache para Memcached, conclua as etapas a seguir com base no seu cluster.

Conecte-se a um cluster Memcached não criptografado

Para se conectar a um cluster Memcached não criptografado, use o utilitário telnet. Conclua as etapas a seguir:

1. Instale o utilitário telnet na instância da qual você deseja testar uma conexão.

   Para sistemas baseados em CentOS, execute o seguinte comando:

   sudo yum install telnet

   Para sistemas baseados em Debian (Ubuntu), execute o seguinte comando:

   sudo apt-get install telnet

   Para obter mais informações, consulte Conecte-se à sua instância do EC2.

2. Para se conectar ao endpoint, execute o comando a seguir:

   telnet yourEndpoint 11211

   Observação: substitua yourendpoint pelo endpoint do cluster e 11211 pela porta do seu nó.

   Exemplo de saída:

   Trying 128.0.0.1...
   Connected to mycachecluster.dcba18.0001.usw2.cache.amazonaws.com.
   Escape character is '^]'.>

Conecte-se a um cluster criptografado do Memcached

Clusters que executam as versões 1.6.12 e posteriores do Memcached oferecem suporte à criptografia em trânsito. Como o telnet não oferece suporte à criptografia, use o OpenSSL para se conectar a um cluster do Memcached que tenha a criptografia ativada.

Observação: é possível ativar a criptografia em trânsito em um cluster somente ao criá-lo. Não é possível modificar o cluster para ativar ou desativar a criptografia em trânsito. Para obter mais informações, consulte Criptografia em trânsito (TLS) do ElastiCache.

Para se conectar ao endpoint, execute o comando a seguir:

openssl s_client -quiet -crlf -connect yourEndpoint:11211

Observação: substitua yourEndpoint pelo seu endpoint e 11211 pela porta do seu nó.

Exemplo de saída:

depth=2 C = US, O = Amazon, CN = Amazon Root CA 1  verify return:1  depth=1 C = US, O = Amazon, CN = Amazon RSA 2048 M02  verify return:1  
depth=0 CN = *.testwithtls.qtyxq7.apse2.cache.amazonaws.com  
verify return:1

Conecte-se a um cache do ElastiCache sem servidor

Por padrão, o ElastiCache sem servidor inicia todos os clusters com a criptografia em trânsito ativada por padrão. Não é possível desativar essa opção. Para as bibliotecas de cliente que você selecionar, as bibliotecas devem oferecer suporte à capacidade de estabelecer conexões TLS.

Para o ElastiCache sem servidor for Valkey e Redis OSS, os caches anunciam duas portas com o mesmo nome de host: Porta primária: 6379 e porta de leitura: 6380. A porta primária permite leitura e gravação, e a porta de leitura usa o comando READONLY para permitir menor latência e leitura final consistente.

Para caches do ElastiCache sem servidor for Memcached, os caches também anunciam duas portas com o mesmo nome de host: Porta primária: 11211 e porta de leitura: 11212. Para permitir o acesso de recursos a essas portas, atualize seus grupos de segurança e listas de controle de acesso à rede (ACLs de rede).

Para se conectar a um cache do ElastiCache sem servidor, execute o seguinte comando com base em seu mecanismo e portas:

Valkey ou Redis OSS (Amazon Linux 2023):

redis6-cli -c -h yourEndpoint -p 6379 –tls

Valkey ou Redis OSS (Amazon Linux ou Amazon Linux 2):

src/valkey-cli -c -h yourEndpoint -p 6379 –tls

Memcached:

openssl s_client -connect yourEndpoint:11212 -crlf

Observação: substitua yourEndpoint pelo endpoint do seu cluster.

Informações relacionadas

Referência de comando no site da Valkey

Criptografia em trânsito do ElastiCache (TLS)

Como faço para solucionar problemas de conectividade com meu cluster autodesenvolvido do ElastiCache para Redis?