Vai al contenuto principale

Distribuire Redis in 5 minuti

Questa guida la accompagna nella creazione del suo primo cluster Redis dalla console Hikube, fino ai primi test con redis-cli.

Obiettivi​

Al termine di questa guida, avrà:

  • Un cluster Redis distribuito nel suo progetto Hikube
  • Una password di accesso generata dalla piattaforma
  • Una connessione funzionante con redis-cli

Prerequisiti​

  • Un account Hikube e un progetto con quote sufficienti (CPU, memoria, storage)
  • Il client redis-cli installato sul suo computer, se desidera testare una connessione da Internet

Passo 1: Creare il cluster​

  1. Acceda alla console Hikube e selezioni il suo progetto.
  2. Nel menu laterale, apra DB & Messaging → Redis. Viene visualizzata la pagina Redis Clusters.
  3. Faccia clic su Create a cluster. Si apre la procedura guidata Create a Redis cluster.

Passo 2: Configurare e confermare​

La procedura guidata comprende quattro passaggi: General, Configuration, Summary e Done.

General​

Inserisca il Cluster Name, ad esempio demo-cache (da 3 a 16 caratteri: minuscole, cifre e trattini; inizia con una lettera, termina con una lettera o una cifra). Faccia clic su Next.

Configuration​

CampoValore consigliato per questa guidaNota
Version8 (Latest)Versioni proposte: 8 e 7
Presets1.small — 1 CPU / 2GiNessun preset è preselezionato; capacità allocata a ogni nodo
Volume size (GB)10Storage allocato a ogni nodo
Number of replicas3Da 1 a 8; minimo 2 per il failover automatico
Public networkAttivatoNecessario per connettersi dal suo computer
Enable authenticationAttivatoAttiva per impostazione predefinita; da mantenere

Il banner nella parte superiore della procedura guidata mostra l'Estimated Cost e l'impatto sulle quote del progetto. Questo impatto conta anche i tre Sentinel del cluster, alla taglia del preset. Faccia clic su Next.

avviso

Il Number of replicas non può più essere modificato dopo la creazione.

Summary​

Rilegga il riepilogo (Name, Version, Preset, Replicas, Storage size, Network: Public o Private), quindi faccia clic su Create.

Passo 3: Verificare lo stato​

Il passaggio Done mostra «Cluster successfully created». Faccia clic su Finish per tornare all'elenco Redis Clusters, quindi apra il cluster.

StatoSignificato
CreatingIl cluster è in fase di provisioning
ReadyIl cluster è operativo
ErrorLa piattaforma non è riuscita ad applicare la creazione o l'ultima modifica del cluster

Risultato atteso: dopo alcuni minuti, la sezione Connection della pagina del cluster mostra lo Status Ready e l'host interno del cluster.

Passo 4: Recuperare le credenziali​

Quando l'autenticazione è attivata, il passaggio Done della procedura guidata mostra, in User Credentials:

  • l'utente default;
  • la sua Password;
  • la Internal Connection String: l'indirizzo del cluster, quando la rete pubblica è attivata.
avviso

Copi subito la password: non verrà più mostrata. In caso di smarrimento, ne generi una nuova dalla sezione Security della pagina del cluster (Rotate password). Si veda Rinnovare la password.

La sezione Connection della pagina del cluster mostra i suoi indirizzi in due zone, ciascuna con un pulsante di copia:

  • Internal, From the project's resources only: l'host interno, sempre presente, e la porta (6379). È raggiungibile dalle VM e dai cluster Kubernetes dello stesso progetto, senza accesso esterno;
  • External, From the Internet: l'indirizzo pubblico, quando l'External access è attivato.

Passo 5: Connessione e test​

Dalla sua postazione, utilizzi l'indirizzo della zona External; da una VM o da un cluster Kubernetes del progetto, l'host della zona Internal.

export REDIS_HOST=<host>
export REDISCLI_AUTH='<password>'

# Test PING
redis-cli -h "$REDIS_HOST" -p 6379 ping
# PONG

# Creare una chiave
redis-cli -h "$REDIS_HOST" -p 6379 SET hello "hikube"
# OK

# Leggere la chiave
redis-cli -h "$REDIS_HOST" -p 6379 GET hello
# "hikube"
suggerimento

La variabile REDISCLI_AUTH evita che la password compaia nella cronologia della shell, a differenza dell'opzione -a.

Passo 6: Risoluzione rapida dei problemi​

La zona External mostra «Disabled» o «Waiting for allocation…»​

«Disabled»: l'External access è disattivato. Lo attivi tramite Edit se deve connettersi da Internet; dal progetto, utilizzi l'host della zona Internal. «Waiting for allocation…»: l'indirizzo pubblico non è ancora stato assegnato, attenda qualche istante.

L'host interno non si risolve da una VM​

Copi il nome completo della zona Internal, senza abbreviarlo. Su Debian 13, il nome non si risolve senza configurazione: vedere Raggiungere un servizio gestito del progetto.

NOAUTH Authentication required o WRONGPASS​

La password è assente o errata. Verifichi la variabile REDISCLI_AUTH, oppure generi una nuova password dalla sezione Security.

Il pulsante Next resta inattivo​

La configurazione supera le quote del progetto, Sentinel compresi. Riduca il preset, la dimensione del volume o il numero di repliche.

Il cluster passa in Error​

La piattaforma non è riuscita ad applicare la creazione o l'ultima modifica del cluster. Contatti il supporto indicando il nome del progetto e del cluster.

Passo 7: Pulizia​

  1. Apra la pagina del cluster (DB & Messaging → Redis → nome del cluster).
  2. Faccia clic su Delete.
  3. Inserisca il nome esatto del cluster nel campo Resource name to confirm, quindi faccia clic su Permanently delete.
avviso

Questa azione elimina il cluster Redis e tutti i dati associati. È irreversibile.

Dalla console ha creato:

  • Un cluster Redis replicato, supervisionato da Sentinel
  • Una password di accesso
  • Una connessione redis-cli tramite la rete pubblica