Questa pagina elenca i comandi gcloud CLI necessari per configurare i prerequisiti, eseguire il provisioning di un'istanza in un progetto di servizio, descrivere un'istanza ed eliminarla. Per svolgere queste attività, segui le istruzioni riportate in ogni sezione di questa pagina.
Per indicazioni più dettagliate su queste attività, consulta le seguenti pagine:
Abilita API
Abilita le seguenti API necessarie per configurare un criterio di connessione ai servizi, configurare la VPC condivisa e creare un'istanza Memorystore per Valkey.
gcloud
Abilita le seguenti API nel progetto di servizio:
gcloud services enable --project=SERVICE_PROJECT_ID networkconnectivity.googleapis.com gcloud services enable --project=SERVICE_PROJECT_ID serviceconsumermanagement.googleapis.com gcloud services enable --project=SERVICE_PROJECT_ID memorystore.googleapis.com
Sostituisci SERVICE_PROJECT_ID con l'ID del progetto di servizio.
Abilita le seguenti API nel progetto host:
gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com
Sostituisci HOST_PROJECT_ID con l'ID del progetto host.
Crea una policy di connessione al servizio
Successivamente, devi creare una policy di connessione al servizio per il progetto host del VPC condiviso in cui è definita la policy, la rete, la regione e le sottoreti in cui vuoi eseguire il provisioning dell'istanza Memorystore for Redis. In genere, questa operazione viene eseguita dall'amministratore di rete oppure potresti disporre dell'autorizzazione necessaria per eseguire il comando se disponi del ruolo richiesto.
Questa guida rapida utilizza la rete default
e la subnet default
. Gli indirizzi IP per la tua istanza vengono allocati in questa subnet predefinita nella regione.
gcloud
Per creare il criterio di connessione al servizio, esegui il comando
create
:gcloud network-connectivity service-connection-policies create POLICY_NAME \ --network=default \ --project=HOST_PROJECT_ID \ --region=REGION \ --service-class=gcp-memorystore \ --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default
Sostituisci quanto segue:
- POLICY_NAME è il nome della norma che preferisci.
- HOST_PROJECT_ID è l'ID progetto host.
- REGION è la stessa regione in cui vuoi eseguire il provisioning dell'istanza Memorystore per Valkey.
Per verificare se il criterio è stato creato correttamente, esegui il comando
list
:gcloud network-connectivity service-connection-policies list \ --region=REGION \ --project=HOST_PROJECT_ID
Sostituisci quanto segue:
- HOST_PROJECT_ID è l'ID progetto host.
- REGION è la regione in cui è definito il criterio di connessione al servizio.
Crea un'istanza
Per creare un'istanza nel progetto di servizio collegato al VPC condiviso, esegui il seguente comando:
gcloud
gcloud beta memorystore instances create INSTANCE \ --project=SERVICE_PROJECT_ID \ --location=REGION \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --replica-count=REPLICA_COUNT \ --psc-auto-connections=network=projects/HOST_PROJECT_ID/global/networks/default,projectId=SERVICE_PROJECT_ID
Sostituisci quanto segue:
- INSTANCE è l'ID istanza.
- SERVICE_PROJECT_ID è l'ID progetto di servizio.
REGION è la regione in cui vuoi eseguire il provisioning dell'istanza.
NODE_TYPE è il tipo di nodo scelto. I valori accettati sono:
shared-core-nano
standard-small
highmem-medium
highmem-xlarge
Per ulteriori dettagli sui tipi di nodi e sulle configurazioni delle istanze, consulta la specifica di istanze e nodi.
SHARD_COUNT determina il numero di shard nell'istanza. Il numero di shard determina la capacità di memoria totale per l'archiviazione degli dati delle istanze. Per ulteriori dettagli sulla specifica dell'istanza, consulta Specifiche di istanze e nodi.
REPLICA_COUNT è il numero desiderato di repliche di lettura (per shard). I valori accettati sono
0
,1
e2
.HOST_PROJECT_ID è l'ID progetto host.
Descrivi l'istanza
Per visualizzare i dettagli dell'istanza, esegui il seguente comando:
gcloud
gcloud beta memorystore instances describe INSTANCE \ --project=SERVICE_PROJECT_ID \ --location=REGION
Sostituisci quanto segue:
- INSTANCE è l'ID istanza.
- SERVICE_PROJECT_ID è l'ID progetto di servizio.
- REGION è la regione in cui si trova l'istanza.
Elimina l'istanza
Per eliminare un'istanza, esegui il seguente comando:
gcloud
gcloud beta memorystore instances delete INSTANCE \ --project=SERVICE_PROJECT_ID \ --location=REGION
Sostituisci quanto segue:
- INSTANCE è l'ID istanza.
- SERVICE_PROJECT_ID è l'ID progetto di servizio.
- REGION è la regione in cui si trova l'istanza.