Questa pagina elenca i comandi della 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 di istanze su una VPC condiviso condivisa. Per eseguire 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à delle istanze. Per saperne di più, consulta Networking.
Per abilitare le API, esegui questi 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 una policy di connessione al servizio
per il progetto, la rete e la regione in cui vuoi eseguire il provisioning dell'
istanza Memorystore for Valkey. Una policy di connessione al servizio ti consente di autorizzare la classe di servizi gcp-memorystore a creare una connessione Private Service Connect tra le reti VPC del producer e del consumer nella regione in cui è definita la policy e nella subnet specificata dalla policy.
Per visualizzare l'autorizzazione necessaria per creare una policy di connessione al servizio, consulta Ruoli richiesti.
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 se la policy è 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 che vuoi utilizzare per l' istanza.
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 maggiori dettagli sulla specifica dell'istanza, consulta Specifica dell'istanza e del nodo.
REPLICA_COUNT è il numero di repliche di lettura (per shard). I valori accettati sono
0-5.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.