Questa pagina fornisce istruzioni per creare istanze Memorystore for Valkey.
Prima di iniziare
Completa le istruzioni della sezione Prima di iniziare:
- 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 - Verifica che la fatturazione sia attivata per il tuo progetto. Scopri come verificare se la fatturazione è abilitata per un progetto.
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 versione489.0.0
di gcloud CLI.-
Attiva l'API Memorystore for Valkey
Memorystore for Valkey -
Abilita l'API Network Connectivity
API Network Connectivity -
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
Vai alla pagina Memorystore for Valkey nella console Google Cloud .
Fai clic su Crea istanza.
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
.
- Ad esempio:
- 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.
- 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.
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
e2
.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
eVALKEY_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
e2
.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
eVALKEY_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
emulti-zone
.ZONE è la zona in cui vuoi eseguire il provisioning dei nodi. Questo flag è applicabile solo se
--zone-distribution-config-mode=
è impostato susingle-zone
.