Uso de datastores globais (CLI) - Amazon ElastiCache
Baixando e configurando o AWS CLIUsando a AWS CLI 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 o AWS Command Line Interface (AWS CLI) para controlar vários AWS serviços na linha de comando e automatizá-los por meio de scripts. Você pode usar a AWS CLI para operações ad hoc (únicas).

Baixando e configurando o AWS CLI

AWS CLI É executado em Windows, macOS ou Linux. Use o procedimento a seguir para fazer download e configurá-la.

Como fazer download, instalar e configurar a CLI

  1. Faça o download da AWS CLI na página da interface da linha de AWS comando.

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

Usando a AWS CLI 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

    A Amazon aplica ElastiCache automaticamente um prefixo ao ID global do armazenamento de dados quando ele é criado. Cada AWS região 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 AWS região e seu prefixo de ID de armazenamento de dados 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 essa operação para criar clusters secundários para um armazenamento de dados global fornecendo o nome do armazenamento de dados 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 essa operação e passar um --global-replication-group-id valor, ElastiCache 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 de vários mecanismos do Redis para o OSS Valkey para ElastiCache GlobalDataStore

    Você pode atualizar um grupo de replicação global existente do Redis OSS 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 o upgrade 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-grupo de replicação

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