Uso de datastores globais (CLI) - Amazon ElastiCache
Download e configuração da AWS CLIUso da CLI da AWS com datastores globais

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á.

Uso de datastores globais (CLI)

Você pode usar a AWS Command Line Interface (AWS CLI) para controlar vários serviços da AWS via linha de comando e automatizá-los usando scripts. Você pode usar a CLI da AWS para operações ad hoc (únicas).

Download e configuração da AWS CLI

A AWS CLI é executada no Windows, no macOS ou no Linux. Use o procedimento a seguir para fazer download e configurá-la.

Como fazer download, instalar e configurar a CLI

  1. Baixe a CLI da AWS na página Interface de linha de comando da AWS.

  2. Siga as instruções para instalação da CLI da AWS e configurar a CLI da AWS no Guia do usuário da AWS Command Line Interface.

Uso da CLI da AWS com datastores globais

Use as seguintes operações da CLI para trabalhar com datastores globais:

  • create-global-replication-group

    aws elasticache create-global-replication-group \
   --global-replication-group-id-suffix my global datastore  \
   --primary-replication-group-id sample-repl-group  \
   --global-replication-group-description an optional description of the global datastore

    O Amazon ElastiCache aplica automaticamente um prefixo ao ID do datastore global quando ele é criado. Cada região da AWS tem seu próprio prefixo. Por exemplo, um ID de datastore global criado na região Oeste dos EUA (Norte da Califórnia) começa com "virxk" junto com o nome do sufixo fornecido. O sufixo, combinado com o prefixo gerado automaticamente, garante a exclusividade do nome do datastore global em várias regiões.

    A tabela a seguir lista cada região da AWS e seu prefixo de ID de datastore global.

    Nome da região/região Prefixo

    Região Leste dos EUA (Ohio)

    us-east-2

    fpkhr

    Região Leste dos EUA (Norte da Virgínia)

    us-east-1

    ldgnf

    Região Oeste dos EUA (Norte da Califórnia)

    us-west-1

    virxk

    Região Oeste dos EUA (Oregon)

    us-west-2

    sgaui

    Região Canadá (Central)

    ca-central-1

    bxodz

    Região Ásia-Pacífico (Mumbai)

    ap-south-1

    erpgt

    Região Ásia-Pacífico (Tóquio)

    ap-northeast-1

    quwsw

    Região Ásia-Pacífico (Seul)

    ap-northeast-2

    lfqnh

    Região Ásia-Pacífico (Osaka)

    ap-northeast-3

    nlapn

    Região Ásia-Pacífico (Singapura)

    ap-southeast-1

    vlqxn

    Região Ásia-Pacífico (Sydney)

    ap-southeast-2

    vbgxd

    Região Europa (Frankfurt)

    eu-central-1

    iudkw

    Região Europa (Irlanda)

    eu-west-1

    gxeiz

    Região Europa (Londres)

    eu-west-2

    okuqm

    Região Europa (Paris)

    eu-west-3

    fgjhi

    Região América do Sul (São Paulo)

    sa-east-1

    juxlw

    Região da China (Pequim)

    cn-north-1

    emvgo

    Região da China (Ningxia)

    cn-northwest-1

    ckbem

    Região Ásia-Pacífico (Hong Kong)

    ap-east-1

    knjmp

    AWS GovCloud (Oeste dos EUA)

    us-gov-west-1

    		 sgwui

  • create-replication-group: use esta operação para criar clusters secundários para um datastore global fornecendo o nome do datastore global ao parâmetro --global-replication-group-id.

    aws elasticache create-replication-group \
  --replication-group-id secondary replication group name \
  --replication-group-description “Replication group description" \
  --global-replication-group-id global datastore name

    Ao chamar esta operação e passar um valor --global-replication-group-id, o ElastiCache irá inferir os valores do grupo de replicação principal do grupo de replicação global para os seguintes parâmetros. Não passe valores para estes parâmetros:

    "PrimaryClusterId",

    "AutomaticFailoverEnabled",

    "NumNodeGroups",

    "CacheParameterGroupName",

    "CacheNodeType",

    "Engine",

    "EngineVersion",

    "CacheSecurityGroupNames",

    "EnableTransitEncryption",

    "AtRestEncryptionEnabled",

    "SnapshotArns",

    "SnapshotName"

  • describe-global-replication-groups

    aws elasticache describe-global-replication-groups \
   --global-replication-group-id my global datastore  \
   --show-member-info an optional parameter that returns a list of the primary and secondary clusters that make up the global datastore

  • modify-global-replication-group

    aws elasticache modify-global-replication-group \
   --global-replication-group-id my global datastore  \
   --automatic-failover-enabled \
   --cache-node-type node type \
   --cache-parameter-group-name parameter group name \ 
   --engine-version engine version \
   -—apply-immediately \
   --global-replication-group-description description

    Atualização entre mecanismos do Redis OSS para Valkey para ElastiCache GlobalDataStore

    Você pode atualizar um grupo de replicação global do Redis OSS existente para o Valkey usando o Console, a API ou a CLI.

    Se você tiver um grupo de replicação global do Redis OSS existente, poderá fazer a atualização para o Valkey especificando o novo mecanismo e a versão do mecanismo com a API modify-global-replication-group.

    Para Linux, macOS ou Unix:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --apply-immediately \
   --engine-version 8.0

    Para Windows:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --apply-immediately ^
   --engine-version 8.0

    Se você tiver um grupo de parâmetros de cache personalizado aplicado ao grupo de replicação global do Redis OSS existente que deseja atualizar, também será necessário passar um grupo de parâmetros de cache personalizado do Valkey na solicitação. O grupo de parâmetros personalizados Valkey de entrada deve ter os mesmos valores de parâmetros estáticos do Redis OSS que o grupo de parâmetros personalizados do Redis OSS existente.

    Para Linux, macOS ou Unix:

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --engine-version 8.0 \
   --apply-immediately \
   --cache-parameter-group-name myParamGroup

    Para Windows:

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --engine-version 8.0 ^
   --apply-immediately ^
   --cache-parameter-group-name myParamGroup

  • delete-global-replication-group

    aws elasticache delete-global-replication-group \
   --global-replication-group-id my global datastore  \
   --retain-primary-replication-group defaults to true

  • disassociate-global-replication-group

    aws elasticache disassociate-global-replication-group \
   --global-replication-group-id my global datastore  \
   --replication-group-id my secondary cluster  \
   --replication-group-region the AWS Region in which the secondary cluster resides

  • failover-global-replication-group

    aws elasticache failover-replication-group \
   --global-replication-group-id my global datastore \
   --primary-region The AWS Region of the primary cluster \  
   --primary-replication-group-id  The name of the global datastore, including the suffix.

  • increase-node-groups-in-global-replication-group

    aws elasticache increase-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • decrease-node-groups-in-global-replication-group

    aws elasticache decrease-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • rebalance-shards-in-global-replication-group

    aws elasticache rebalance-shards-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name

Use a ajuda para listar todos os comandos disponíveis para o ElastiCache para Valkey ou Redis OSS.

aws elasticache help

Você também pode usar a ajuda para descrever um comando específico e saber mais sobre seu uso: 

aws elasticache create-global-replication-group help