Encontrar endpoints de conexão

Seu aplicativo conecta-se ao seu cluster usando endpoints. Um endpoint é o endereço exclusivo de um nó ou cluster.

Se você não usar a Descoberta automática, deverá configurar seu cliente para usar os endpoints de nó individuais para leituras e gravações. Você também deve acompanhá-los à medida que adiciona e remove nós.

Quais endpoints usar

Nó OSS autônomo do Redis, use o endpoint do nó para operações de leitura e gravação.
Clusters Redis OSS (modo de cluster desativado) usam o endpoint primário para todas as operações de gravação. Use o Endpoint de leitor para dividir uniformemente as conexões de entrada no endpoint entre todas as réplicas de leitura. Use os pontos finais individuais do Node para operações de leitura (noAPI//, CLI eles são chamados de pontos finais de leitura).
Clusters Redis OSS (habilitado para modo de cluster) usam o Endpoint de configuração do cluster para todas as operações que oferecem suporte a comandos habilitados para o modo de cluster. Você deve usar um cliente que ofereça suporte ao Redis OSS Cluster (Redis OSS 3.2). Você ainda pode ler a partir de pontos de extremidade de nós individuais (no API /, CLI eles são chamados de pontos de extremidade de leitura).

As seções a seguir orientam pelo processo de descoberta dos endpoints necessários para o mecanismo que você está executando.

Se um cluster Redis OSS (modo de cluster desativado) tiver somente um nó, o endpoint do nó será usado para leituras e gravações. Se um cluster Redis OSS (modo de cluster desativado) tiver vários nós, há três tipos de endpoints: o endpoint primário, o endpoint do leitor e os endpoints do nó.

O endpoint primário é um DNS nome que sempre é resolvido para o nó primário no cluster. O endpoint primário é imune às alterações no seu cluster, como promover uma réplica de leitura para a função primária. Para atividades de gravação, recomendamos que suas aplicações se conectem ao endpoint primário.

Um endpoint de leitura dividirá uniformemente as conexões de entrada com o endpoint entre todas as réplicas de leitura em um cluster ElastiCache (Redis). OSS Fatores adicionais, como quando o aplicativo cria as conexões ou como o aplicativo (re)usa as conexões determinarão a distribuição do tráfego. Os endpoints de leitor acompanham as alterações do cluster em tempo real à medida que réplicas são adicionadas ou removidas. Você pode colocar as várias réplicas de leitura do seu cluster ElastiCache (RedisOSS) em diferentes zonas de AWS disponibilidade (AZ) para garantir a alta disponibilidade dos endpoints de leitura.

nota

Um endpoint leitor não é um balanceador de carga. É um DNS registro que será resolvido para um endereço IP de um dos nós de réplica de forma redonda.

Para atividades de leitura, os aplicativos também podem se conectar a qualquer nó no cluster. Ao contrário do endpoint primário, endpoints de nó são resolvidos para endpoints específicos. Se você fizer uma alteração no cluster, como adicionar ou excluir uma réplica, deverá atualizar os endpoints de nó no seu aplicativo.

Para encontrar os endpoints de um cluster Redis OSS (modo de cluster desativado)

Faça login no AWS Management Console e abra o ElastiCache console em https://console.aws.amazon.com/elasticache/.
No painel de navegação, escolha clusters Redis OSS.

A tela de clusters aparecerá com uma lista de clusters Redis OSS (modo de cluster desativado) e Redis OSS (modo de cluster ativado).
Para encontrar os endpoints Primário e/ou Leitor do cluster, escolha o nome do cluster (e não o botão à esquerda).

Endpoints primários e Reader para um cluster Redis OSS (modo de cluster desativado)

Se houver apenas um nó no cluster, não haverá um endpoint primário, e você poderá continuar na próxima etapa.
Se o cluster Redis OSS (modo de cluster desativado) tiver nós de réplica, você poderá encontrar os endpoints do nó de réplica do cluster escolhendo o nome do cluster e, em seguida, escolhendo a guia Nodes.

A tela de nós aparece com cada nó do cluster, primário e réplicas, listados com seu respectivo endpoint.

Endpoints de nós para um cluster Redis OSS (modo de cluster desativado)
Como copiar um endpoint para a área de transferência:
1. Um endpoint por vez, localize o endpoint que você deseja copiar.
2. Escolha o ícone de cópia diretamente na frente do endpoint.
O endpoint agora é copiado para a área de transferência. Para obter informações sobre como usar o endpoint para se conectar a um nó, consulte Conexão a nós.

Um endpoint primário do Redis OSS (modo de cluster desativado) se parece com o seguinte. Há uma diferença, dependendo de a criptografia em trânsito estar ou não habilitada.

Criptografia em trânsito não habilitada


clusterName.xxxxxx.nodeId.regionAndAz.cache.amazonaws.com:port
			
redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379

Criptografia em trânsito habilitada


master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port

master.ncit.ameaqx.use1.cache.amazonaws.com:6379

Um cluster Redis OSS (modo de cluster ativado) tem um único endpoint de configuração. Ao se conectar ao endpoint de configuração, a aplicação pode descobrir os endpoints primários e os endpoints de leitura para cada fragmento no cluster.

Para encontrar o endpoint de um cluster Redis OSS (modo de cluster ativado)

Faça login no AWS Management Console e abra o ElastiCache console em https://console.aws.amazon.com/elasticache/.
No painel de navegação, escolha clusters Redis OSS.

A tela de clusters aparecerá com uma lista de clusters Redis OSS (modo de cluster desativado) e Redis OSS (modo de cluster ativado). Escolha o cluster Redis OSS (modo de cluster ativado) ao qual você deseja se conectar.
Para encontrar o endpoint de configuração do cluster, escolha o nome do cluster (não o botão de opção).
O endpoint de configuração é exibido em detalhes do cluster. Para copiá-lo, selecione o ícone copiar à esquerda do endpoint.

Você pode usar o AWS CLI for Amazon ElastiCache para descobrir os endpoints para nós, clusters e grupos de replicação.

Tópicos

Encontrar endpoints para nós e clusters (AWS CLI)
Encontrar os endpoints para grupos de replicação (AWS CLI)

Encontrar endpoints para nós e clusters (AWS CLI)

Você pode usar o AWS CLI para descobrir os endpoints de um cluster e seus nós com o describe-cache-clusters comando. Para OSS clusters Redis, o comando retorna o endpoint do cluster. Se você incluir o parâmetro opcional --show-cache-node-info, o comando também retornará os endpoints dos nós individuais no cluster.

O comando a seguir recupera as informações do cluster do Redis de nó único OSS (modo de cluster desativado) mycluster.

Importante

O parâmetro --cache-cluster-id pode ser usado com ID de cluster Redis de nó único OSS (modo de cluster desativado) ou IDs de nó específicos em grupos de replicação do RedisOSS. O --cache-cluster-id de um grupo de OSS replicação do Redis é um valor de 4 dígitos, como. 0001 Se --cache-cluster-id for o id de um cluster (nó) em um grupo de OSS replicação do replication-group-id Redis, o será incluído na saída.

Para Linux, macOS ou Unix:


aws elasticache describe-cache-clusters \
    --cache-cluster-id redis-cluster \
    --show-cache-node-info

Para Windows:


aws elasticache describe-cache-clusters ^
    --cache-cluster-id redis-cluster ^
    --show-cache-node-info

A saída da operação acima deve ser semelhante a esta (JSONformato).


{
    "CacheClusters": [
        {
            "CacheClusterStatus": "available",
            "SecurityGroups": [
                {
                    "SecurityGroupId": "sg-77186e0d",
                    "Status": "active"
                }
            ],
            "CacheNodes": [
                {
                    "CustomerAvailabilityZone": "us-east-1b",
                    "CacheNodeCreateTime": "2018-04-25T18:19:28.241Z",
                    "CacheNodeStatus": "available",
                    "CacheNodeId": "0001",
                    "Endpoint": {
                        "Address": "redis-cluster.amazonaws.com",
                        "Port": 6379
                    },
                    "ParameterGroupStatus": "in-sync"
                }
            ],
            "AtRestEncryptionEnabled": false,
            "CacheClusterId": "redis-cluster",
            "TransitEncryptionEnabled": false,
            "CacheParameterGroup": {
                "ParameterApplyStatus": "in-sync",
                "CacheNodeIdsToReboot": [],
                "CacheParameterGroupName": "default.redis3.2"
            },
            "NumCacheNodes": 1,
            "PreferredAvailabilityZone": "us-east-1b",
            "AutoMinorVersionUpgrade": true,
            "Engine": "redis",
            "AuthTokenEnabled": false,
            "PendingModifiedValues": {},
            "PreferredMaintenanceWindow": "tue:08:30-tue:09:30",
            "CacheSecurityGroups": [],
            "CacheSubnetGroupName": "default",
            "CacheNodeType": "cache.t2.small",
             "DataTiering": "disabled"
            "EngineVersion": "3.2.10",
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "CacheClusterCreateTime": "2018-04-25T18:19:28.241Z"
        }
    ]
}

Para obter mais informações, consulte o tópico describe-cache-clusters.

Encontrar os endpoints para grupos de replicação (AWS CLI)

Você pode usar o AWS CLI para descobrir os endpoints de um grupo de replicação e seus clusters com o describe-replication-groups comando. O comando retorna o endpoint primário do grupo de replicação e uma lista de todos os clusters (nós) no grupo de replicação com seus endpoints, junto com o endpoint de leitor.

A seguinte operação recupera o endpoint primário e o endpoint de leitor para o grupo de replicação myreplgroup. Use o endpoint primário para todas as operações de gravação.


aws elasticache describe-replication-groups \
    --replication-group-id myreplgroup

Para Windows:


aws elasticache describe-replication-groups ^
    --replication-group-id myreplgroup

A saída dessa operação deve ser semelhante a esta (JSONformato).


{
   "ReplicationGroups": [
     {
       "Status": "available", 
       "Description": "test", 
       "NodeGroups": [
         {
            "Status": "available", 
               "NodeGroupMembers": [
                  {
                     "CurrentRole": "primary", 
                     "PreferredAvailabilityZone": "us-west-2a", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "myreplgroup-001.amazonaws.com"
                     }, 
                     "CacheClusterId": "myreplgroup-001"
                  }, 
                  {
                     "CurrentRole": "replica", 
                     "PreferredAvailabilityZone": "us-west-2b", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "myreplgroup-002.amazonaws.com"
                     }, 
                     "CacheClusterId": "myreplgroup-002"
                  }, 
                  {
                     "CurrentRole": "replica", 
                     "PreferredAvailabilityZone": "us-west-2c", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "myreplgroup-003.amazonaws.com"
                     }, 
                     "CacheClusterId": "myreplgroup-003"
                  }
               ], 
               "NodeGroupId": "0001", 
               "PrimaryEndpoint": {
                  "Port": 6379, 
                  "Address": "myreplgroup.amazonaws.com"
               },
               "ReaderEndpoint": {
                  "Port": 6379, 
                  "Address": "myreplgroup-ro.amazonaws.com"
               }
            }
         ], 
         "ReplicationGroupId": "myreplgroup", 
         "AutomaticFailover": "enabled", 
         "SnapshottingClusterId": "myreplgroup-002", 
         "MemberClusters": [
            "myreplgroup-001", 
            "myreplgroup-002", 
            "myreplgroup-003"
         ], 
         "PendingModifiedValues": {}
      }
   ]
}

Para obter mais informações, consulte describe-replication-groupsna Referência de AWS CLI Comandos.

Você pode usar a Amazon ElastiCache API para descobrir os endpoints para nós, clusters e grupos de replicação.

Tópicos

Encontrando endpoints para nós e clusters () ElastiCache API
Encontrando endpoints para grupos de replicação () ElastiCache API

Encontrando endpoints para nós e clusters () ElastiCache API

Você pode usar o ElastiCache API para descobrir os endpoints de um cluster e seus nós com a DescribeCacheClusters ação. Para OSS clusters Redis, o comando retorna o endpoint do cluster. Se você incluir o parâmetro opcional ShowCacheNodeInfo, a ação também retornará os endpoints dos nós individuais no cluster.


https://elasticache.us-west-2.amazonaws.com/
    ?Action=DescribeCacheClusters
    &CacheClusterId=mycluster
    &ShowCacheNodeInfo=true
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20150202T192317Z
    &Version=2015-02-02
    &X-Amz-Credential=<credential>

Encontrando endpoints para grupos de replicação () ElastiCache API

Você pode usar o ElastiCache API para descobrir os endpoints de um grupo de replicação e seus clusters com a DescribeReplicationGroups ação. A ação retorna o endpoint primário do grupo de replicação e uma lista de todos os clusters no grupo de replicação com seus endpoints, junto com o endpoint de leitor.

A operação a seguir recupera o endpoint primário (PrimaryEndpoint), o endpoint do leitor (ReaderEndpoint) e os endpoints individuais do nó (ReadEndpoint) para o grupo de replicação. myreplgroup Use o endpoint primário para todas as operações de gravação.


https://elasticache.us-west-2.amazonaws.com/
    ?Action=DescribeReplicationGroups
    &ReplicationGroupId=myreplgroup
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20150202T192317Z
    &Version=2015-02-02
    &X-Amz-Credential=<credential>

Para obter mais informações, consulte DescribeReplicationGroups.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Acesso ao seu cluster ou grupo de replicação

Fragmentos