Provisioning delle istanze in una rete VPC

Questa pagina elenca i comandi gcloud CLI necessari per configurare i prerequisiti, eseguire il provisioning di un'istanza, descrivere un'istanza ed eliminare un'istanza su una rete VPC standard. Per istruzioni su come eseguire queste attività su una rete VPC condiviso, consulta Provisioning delle istanze su una VPC condiviso condivisa. 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

Inizia abilitando le API in questa sezione. Queste API sono necessarie perché Memorystore for Valkey utilizza l'automazione della connettività del servizio Private Service Connect per automatizzare la connettività per le istanze. Per saperne di più, consulta la sezione Networking.

Per abilitare le API, esegui i seguenti comandi:

gcloud

gcloud services enable --project=PROJECT_ID networkconnectivity.googleapis.com
gcloud services enable --project=PROJECT_ID compute.googleapis.com
gcloud services enable --project=PROJECT_ID serviceconsumermanagement.googleapis.com
gcloud services enable --project=PROJECT_ID memorystore.googleapis.com

Sostituisci quanto segue:

  • PROJECT_ID è l'ID progetto.

Crea una policy di connessione al servizio

Devi creare un criterio di connessione al servizio per il progetto, la rete e la regione in cui vuoi eseguire il provisioning dell'istanza Memorystore for Valkey. Un criterio di connessione al servizio consente di autorizzare la classe di servizio gcp-memorystore a creare una connessione Private Service Connect tra le reti VPC producer e consumer nella regione in cui è definito il criterio e nella subnet specificata dal criterio.

Per visualizzare l'autorizzazione necessaria per creare una policy di connessione al servizio, consulta Ruoli obbligatori.

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.

Per creare la policy di connessione al servizio, esegui questo comando:

gcloud

gcloud network-connectivity service-connection-policies create POLICY_NAME \
  --network=default \
  --project=PROJECT_ID \
  --region=REGION \
  --service-class=gcp-memorystore \
  --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/default

Sostituisci quanto segue:

  • POLICY_NAME è il nome della policy che preferisci.
  • PROJECT_ID è l'ID progetto.
  • REGION è la stessa regione in cui vuoi eseguire il provisioning dell'istanza Memorystore for Valkey.

Convalida la creazione della policy di connessione al servizio

Verifica che la policy sia stata creata correttamente eseguendo il comando list:

gcloud

gcloud network-connectivity service-connection-policies list --region=REGION --project=PROJECT_ID

Sostituisci quanto segue:

  • PROJECT_ID è l'ID progetto.
  • REGION è la regione in cui è definita la policy di connessione al servizio.

Crea un'istanza

Per creare un'istanza, esegui il comando create:

gcloud

gcloud memorystore instances create INSTANCE \
--project=PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]'

Sostituisci quanto segue:

  • INSTANCE è l'ID istanza.

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

  • PROJECT_ID è l'ID del progetto in cui vuoi creare l'istanza.

  • NETWORK_ID è l'ID della rete che vuoi utilizzare per creare l'istanza.

Descrivi l'istanza

Per visualizzare i dettagli dell'istanza, esegui il comando describe:

gcloud

gcloud memorystore instances describe INSTANCE \
--project=PROJECT_ID \
--location=REGION

Sostituisci quanto segue:

  • INSTANCE è l'ID istanza.
  • PROJECT_ID è l'ID progetto.
  • REGION è la regione in cui si trova l'istanza.

Elimina l'istanza

Per eliminare un'istanza, esegui il comando delete:

gcloud

gcloud memorystore instances delete INSTANCE \
--project=PROJECT_ID \
--location=REGION

Sostituisci quanto segue:

  • INSTANCE è l'ID istanza.
  • PROJECT_ID è l'ID progetto.
  • REGION è la regione in cui si trova l'istanza.