Utilizzo di Global Datastore (CLI)

Puoi usare il AWS Command Line Interface (AWS CLI) per controllare più AWS servizi dalla riga di comando e automatizzarli tramite script. È possibile utilizzare la AWS CLI per operazioni ad hoc (una tantum).

Scaricamento e configurazione di AWS CLI

AWS CLI Funziona su Windows, macOS o Linux. Utilizzare la procedura seguente per scaricarla e configurarla.

Per scaricare, installare e configurare la CLI

1. Scarica la AWS CLI dalla pagina web dell'interfaccia a riga di AWS comando.

2. Segui le istruzioni per l'installazione della AWS CLI e la configurazione della AWS CLI nella Guida per l'utente.AWS Command Line Interface

Utilizzo della AWS CLI con datastore globali

Utilizzare le seguenti operazioni della CLI per utilizzare i Global Datastore:

• 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  
  

  Amazon applica ElastiCache automaticamente un prefisso all'ID globale del datastore al momento della creazione. Ogni AWS regione ha il proprio prefisso. Ad esempio, un ID datastore globale creato nella regione Stati Uniti occidentali (California settentrionale) inizia con "virxk" assieme al nome del suffisso fornito. Il suffisso, combinato al prefisso autogenerato, garantisce l'unicità del nome del datastore globale in più Regioni.

  La tabella seguente elenca ogni AWS regione e il relativo prefisso ID globale del datastore.

  Nome regione/Regione	Prefix
  Stati Uniti orientali (Ohio) us-east-2	fpkhr
  Stati Uniti orientali (Virginia settentrionale) us-east-1	ldgnf
  Regione Stati Uniti occidentali (California settentrionale) us-west-1	virxk
  Stati Uniti occidentali (Oregon) us-west-2	sgaui
  Regione Canada (Centrale) ca-central-1	bxodz
  Regione Asia Pacifico (Mumbai) ap-south-1	erpgt
  Regione Asia Pacifico (Tokyo) ap-northeast-1	quwsw
  Regione Asia Pacifico (Seoul) ap-northeast-2	lfqnh
  Regione Asia Pacifico (Osaka-Locale) ap-northeast-3	nlapn
  Regione Asia Pacifico (Singapore) ap-southeast-1	vlqxn
  Regione Asia Pacifico (Sydney) ap-southeast-2	vbgxd
  Regione Europa (Francoforte) eu-central-1	iudkw
  Regione Europa (Irlanda) eu-west-1	gxeiz
  Regione Europa (Londra) eu-west-2	okuqm
  Regione UE (Parigi) eu-west-3	fgjhi
  Regione Sud America (San Paolo) sa-east-1	juxlw
  Regione Cina (Pechino) cn-north-1	emvgo
  Regione Cina (Ningxia) cn-northwest-1	ckbem
  Regione Asia Pacifico (Hong Kong) ap-east-1	knjmp
  AWS GovCloud (Stati Uniti occidentali) us-gov-west-1	sgwui

• create-replication-group— Utilizzate questa operazione per creare cluster secondari per un datastore globale fornendo il nome del datastore globale al parametro. --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 
  
  

  Quando si chiama questa operazione e si passa un --global-replication-group-id valore, ElastiCache dedurrà i valori dal gruppo di replica primario del gruppo di replica globale per i seguenti parametri. Non passare valori per questi parametri:

  "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
                       
  

  Aggiornamento multimotore da Redis a OSS Valkey per ElastiCache GlobalDataStore

  È possibile aggiornare un gruppo di replica globale Redis OSS esistente a Valkey utilizzando la console, l'API o la CLI.

  Se disponi di un gruppo di replica globale Redis OSS esistente, puoi eseguire l'aggiornamento a Valkey specificando il nuovo motore e la nuova versione del motore con API. modify-global-replication-group

  Per Linux, macOS o Unix:

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

  Per Windows:

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

  Se hai un gruppo di parametri di cache personalizzato applicato al gruppo di replica globale Redis OSS esistente che desideri aggiornare, dovrai passare anche un gruppo di parametri di cache Valkey personalizzato nella richiesta. Il gruppo di parametri personalizzati Valkey di input deve avere gli stessi valori dei parametri statici Redis OSS del gruppo di parametri personalizzati Redis OSS esistente.

  Per Linux, macOS o 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

  Per 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-gruppo di replica

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

Usa help per elencare tutti i comandi disponibili ElastiCache per Valkey o Redis OSS.

aws elasticache help

È anche possibile utilizzare la guida per la descrizione di un comando specifico e per ulteriori informazioni relative al suo utilizzo:

aws elasticache create-global-replication-group help