Creare istanze

Questa pagina fornisce istruzioni per creare istanze Memorystore for Valkey.

Prima di iniziare

Completa le istruzioni della sezione Prima di iniziare:

  1. Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud.

    Nota:se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.


    Vai al selettore dei progetti
  2. Verifica che la fatturazione sia attivata per il tuo progetto. Scopri come verificare se la fatturazione è abilitata per un progetto.
  3. Installa e inizializza Google Cloud CLI.

    Nota:se hai già installato gcloud CLI, assicurati di avere l'ultima versione eseguendo gcloud components update. Per accedere ai comandi gcloud CLI di Memorystore for Valkey, devi disporre almeno della versione 489.0.0 di gcloud CLI.

  4. Attiva l'API Memorystore for Valkey
    Memorystore for Valkey
  5. Abilita l'API Network Connectivity
    API Network Connectivity
  6. Abilita l'API Service Consumer Management
    API Service Consumer Management

Altri prerequisiti

  • Devi disporre di uno di questi ruoli IAM nel progetto Google Cloud che stai utilizzando:
    • roles/memorystore.admin (il ruolo IAM predefinito Amministratore Memorystore)
    • roles/owner (il ruolo IAM di base Proprietario)
    • roles/editor (il ruolo IAM di base Editor)

Configurare la rete

Leggi la pagina Networking per determinare se devi configurare una policy di connessione al servizio.

Se non è stata creata una policy di connessione al servizio per la rete con cui creerai l'istanza Valkey, segui le indicazioni relative al networking per crearla.

Crea un'istanza

Console

  1. Vai alla pagina Memorystore for Valkey nella console Google Cloud .

    Memorystore for Valkey

  2. Fai clic su Crea istanza.

  3. Nella pagina Crea un'istanza Valkey, seleziona le configurazioni che preferisci per la nuova istanza.

    • In Assegna un nome all'istanza, inserisci un ID istanza. L'ID istanza deve utilizzare solo lettere minuscole, numeri e trattini. Deve inoltre iniziare con una lettera ed essere univoco nella rispettiva regione.
      • Ad esempio: my-instance-1.
    • In Scegli regione, seleziona una regione per l'istanza.
    • In Tipo di nodo, seleziona il tipo di nodo.
    • In Modalità, seleziona Modalità cluster attivata o Modalità cluster disattivata.
    • In Dimensione dell'istanza, definisci il numero di shard per la tua istanza. Il conteggio degli shard determina la capacità totale di memoria per l'archiviazione dei dati dell'istanza. Le istanze con modalità cluster disabilitata supportano un solo shard. Per ulteriori informazioni, consulta Specifiche di istanze e shard.
    • Se vuoi creare un'istanza con repliche, inserisci il numero di repliche che preferisci (per shard) in Repliche. I valori accettabili sono Nessuna replica, 1 replica e 2 repliche. Il valore predefinito è 1 replica quando utilizzi la console Google Cloud .
    • Nella sezione Configura connessione, seleziona la rete che preferisci. Per maggiori dettagli sul networking privato per Memorystore for Valkey, consulta Networking.
    • Se vuoi attivare l'autenticazione IAM, seleziona Enable IAM AUTH (Attiva autenticazione IAM).
    • Se vuoi attivare la crittografia in transito, seleziona Abilita Transport Layer Security (TLS).
    • In Scegli versione, seleziona la tua versione di Valkey. La versione 7.2 di Valkey è quella predefinita.
  4. Fai clic sul pulsante Crea istanza.

gcloud

Per creare un'istanza Memorystore for Valkey, esegui il comando create:

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

Sostituisci quanto segue:

  • INSTANCE è l'ID dell'istanza Memorystore for Valkey che stai creando. L'ID istanza deve contenere da 1 a 63 caratteri e utilizzare solo lettere minuscole, numeri o trattini. Deve iniziare con una lettera minuscola e terminare con una lettera minuscola o un numero.

  • REGION_ID è la regione in cui vuoi posizionare l'istanza.

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

  • REPLICA_COUNT è il numero di repliche che vuoi (per shard). I valori accettati sono 0, 1 e 2.

  • 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, vedi Specifica di istanze e nodi.

  • ENGINE_VERSION è la versione del motore Valkey che hai scelto. I valori accettati sono VALKEY_7_2 e VALKEY_8_0.

  • SHARD_COUNT determina il numero di shard nella tua istanza. Il numero di shard determina la capacità di memoria totale per l'archiviazione dei dati dell'istanza. Le istanze con modalità cluster disabilitata supportano un solo shard. Per ulteriori informazioni, consulta Specifica di istanze e nodi.

  • MODE determina se l'istanza è abilitata o disabilitata in modalità cluster. Se questo campo viene omesso, l'istanza utilizza per impostazione predefinita la modalità cluster abilitata. Per saperne di più, vedi Attivare e disattivare la modalità cluster.

Ad esempio:

Esempio di modalità cluster abilitata


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8 \
--mode=cluster

Esempio di modalità cluster disabilitata


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--shard-count=1 \
--replica-count=2 \
--node-type=highmem-medium \
--mode=cluster-disabled

Per impostazione predefinita, la crittografia dei dati in transito è disabilitata e la rete autorizzata è default.

Crea un'istanza a zona singola

Questa sezione fornisce istruzioni per creare un'istanza a zona singola.

gcloud

Per creare un'istanza a zona singola, esegui il comando create:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \
--zone-distribution-config=ZONE \
--mode=MODE

Sostituisci quanto segue:

  • INSTANCE è l'ID dell'istanza Memorystore for Valkey che stai creando. L'ID istanza deve contenere da 1 a 63 caratteri e utilizzare solo lettere minuscole, numeri o trattini. Deve iniziare con una lettera minuscola e terminare con una lettera minuscola o un numero.

  • REGION_ID è la regione in cui vuoi posizionare l'istanza.

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

  • REPLICA_COUNT è il numero di repliche scelto (per shard). I valori accettati sono 0, 1 e 2.

  • 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, vedi Specifica di istanze e nodi.

  • ENGINE_VERSION è la versione del motore Valkey che hai scelto. I valori accettati sono VALKEY_7_2 e VALKEY_8_0.

  • 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. Se la modalità selezionata è Cluster Mode Disabled, puoi specificare un solo shard per l'istanza. Per ulteriori informazioni, consulta Specifica di istanze e nodi.

  • MODE determina se l'istanza deve essere abilitata o disabilitata in modalità cluster. Se ometti questo campo, la modalità predefinita è la modalità cluster attivata. Per saperne di più, vedi Attivare e disattivare la modalità cluster.

  • ZONE_DISTRIBUTION_CONFIG_MODE è la modalità che ti consente di scegliere tra il provisioning di un'istanza a zona singola o di un'istanza multizona. L'impostazione predefinita è multizona. I valori accettati sono single-zone e multi-zone.

  • ZONE è la zona in cui vuoi eseguire il provisioning dei nodi. Questo flag è applicabile solo se --zone-distribution-config-mode= è impostato su single-zone.