Provisioning delle istanze su una rete VPC condivisa

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 completare 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 al servizio, configurare VPC condiviso e creare un'istanza Memorystore for 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 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 tuo progetto host.

Crea una policy di connessione al servizio

Successivamente, è necessario creare un criterio di connessione al servizio per il progetto host del VPC condiviso in cui sono definiti il criterio, la rete, la regione e le subnet in cui vuoi eseguire il provisioning dell'istanza Memorystore for 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. Gli indirizzi IP per l'istanza vengono allocati in questa subnet predefinita nella regione.

gcloud

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

  2. Per verificare se la policy è stata creata 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 è definita la policy di connessione al servizio.

Crea un'istanza

Per creare un'istanza nel progetto di servizio collegato al VPC condiviso, esegui questo comando:

gcloud

gcloud memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"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

  • SHARD_COUNT determina il numero di shard nella tua istanza. Il conteggio degli shard determina la capacità di memoria totale per l'archiviazione dei dati dell'istanza. Per ulteriori dettagli sulla specifica dell'istanza, consulta Specifica dell'istanza e del nodo.

  • 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 questo comando:

gcloud

gcloud 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 questo comando:

gcloud

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