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

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

  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 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.
  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 è 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 e 2.

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