Interfaccia a Riga di Comando

L’Interfaccia a Riga di Comando (CLI) di ZoneHero offre un modo pratico per interagire con le API regionali di ZoneHero direttamente dal tuo terminale. Ti permette di eseguire operazioni come il recupero di informazioni sui bilanciatori di carico, particolarmente utile per la risoluzione dei problemi e per le richieste di assistenza.

Compilazione e Installazione della CLI#

La CLI di ZoneHero può essere compilata dallo stesso repository utilizzato per il provider Terraform.

Prerequisiti#

• Go >= 1.24
• Make

Passaggi per l’Installazione#

1. Clona il repository:

git clone https://gitlab.guerraz.net/HLB/hlb-terraform-provider.git

2. Compila e installa la CLI:

cd hlb-terraform-provider
make cli && make cli-install

Questo compilerà la CLI e la installerà sul tuo sistema, rendendo disponibile il comando zonehero nel tuo terminale.

Utilizzo della CLI#

La CLI di ZoneHero richiede le credenziali del tuo account AWS e una chiave API per autenticarsi con l’API di ZoneHero.

Configurazione di Base#

Per utilizzare la CLI, avrai bisogno di:

1. Una Chiave API (vedi Chiavi API)
2. Credenziali AWS configurate (tramite variabili d’ambiente, profili AWS CLI o ruoli IAM)

Sintassi dei Comandi#

La sintassi di base per i comandi della CLI di ZoneHero è:

zonehero --api-key TUA_CHIAVE_API --profile PROFILO_AWS --region REGIONE_AWS COMANDO [OPZIONI]

Dove:

• TUA_CHIAVE_API è la tua chiave API di ZoneHero
• PROFILO_AWS è il profilo AWS da utilizzare per le credenziali
• REGIONE_AWS è la regione AWS da utilizzare (ad esempio, eu-west-1)
• COMANDO è l’operazione da eseguire (ad esempio, hlb get-load-balancer)
• [OPZIONI] sono opzioni specifiche del comando

Esempio: Recupero di Informazioni su un Bilanciatore di Carico#

Per recuperare informazioni dettagliate su un bilanciatore di carico specifico:

zonehero --api-key UUID --profile PROFILO_AWS --region eu-west-1 hlb get-load-balancer --id ID_LB --output json

Sostituisci:

• UUID con la tua chiave API di ZoneHero
• PROFILO_AWS con il nome del tuo profilo AWS
• ID_LB con l’ID del bilanciatore di carico che vuoi ispezionare

L’opzione --output json formatta la risposta come JSON, utile per ulteriori elaborazioni o quando si inviano ticket di supporto.

Risoluzione dei Problemi e Assistenza#

Quando invii un ticket di assistenza riguardante un particolare HLB tramite il Portale di Assistenza ZoneHero, è consigliabile allegare l’output del seguente comando:

zonehero --api-key UUID --profile PROFILO_AWS --region eu-west-1 hlb get-load-balancer --id ID_LB --output json

Questo fornisce al team di assistenza informazioni complete sulla configurazione del tuo bilanciatore di carico, facilitando la diagnosi e la risoluzione dei problemi.

Comandi Aggiuntivi#

La CLI di ZoneHero supporta vari comandi per gestire i tuoi bilanciatori di carico. Per un elenco completo dei comandi e delle opzioni disponibili, esegui:

zonehero --help

Per ottenere aiuto su un comando specifico, esegui:

zonehero COMANDO --help