Provisioning delle istanze su una rete VPC condiviso

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à devi seguire le istruzioni 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

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

  2. 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 un criterio di connessione al servizio

Successivamente, devi creare un criterio di connessione al servizio per il progetto host del VPC condiviso in cui è definito il criterio, la rete, la regione e le sottoreti in cui vuoi eseguire il provisioning dell'istanza Memorystore per Valkey. 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. Indirizzi IP per la tua istanza sono allocate in questa subnet predefinita nella regione.

gcloud

  1. 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 del criterio che preferisci.
    • HOST_PROJECT_ID è l'ID del progetto host.
    • REGION è la stessa regione in cui vuoi eseguire il provisioning dell'istanza Memorystore per Valkey.

  2. 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 si trova il criterio di connessione al servizio definito.

Crea un'istanza

Per creare un'istanza nel progetto di servizio collegato al VPC condiviso, esegui questo 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=HOST_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 delle istanze e dei nodi.

  • SHARD_COUNT determina il numero di shard nell'istanza. Il numero di shard determina la capacità di memoria totale per l'archiviazione dei dati dell'istanza. 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 e 2.

  • HOST_PROJECT_ID è l'ID del 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.