apigeectl

Stai visualizzando la versione 1.1 della documentazione sulla documentazione ibrida di Apigee. Questa versione è terminata. Dovresti eseguire l'upgrade a una versione più recente. Per maggiori informazioni, consulta la pagina Versioni supportate.

apigeectl è un'interfaccia a riga di comando (CLI) per l'installazione e la gestione di Apigee hybrid in un cluster Kubernetes.

NOTA: per utilizzare il comando apigeectl, devi aver installato e configurato kubectl sulla tua macchina di amministrazione Kubernetes.

Sintassi di Apigeectl

apigeectl [command] [flags]

Dove:

• command: specifica l'operazione che vuoi eseguire. Per un elenco completo dei comandi, vedi Comandi Apigeectl.

• flags: specifica i parametri dei comandi. Per un elenco completo dei flag, vedi Flag di Apigeectl.

Comandi Apigee

Nella tabella seguente sono elencati i comandi apigeectl:

Comando	Descrizione
apply	Applica le configurazioni per i componenti runtime ibridi di Apigee al tuo cluster Kubenetes. Utilizza il flag -c per specificare uno o più componenti (separati da virgole). Se non specifichi il flag -c, il comando apply applica tutti i componenti al cluster. NOTA: devi chiamare apigeectl init prima di chiamare apigeectl apply.
check‑ready	Verifica lo stato dei pod dei componenti ibridi. Quando tutti i pod dei componenti sono pronti, viene visualizzato il messaggio "Tutti i container pronti". Per gli script automatici, tieni presente che il comando esce con lo stato 0 quando i container sono tutti pronti. Quando è presente almeno un pod non pronto, il comando esce con uno stato pari a 1. Se non specifichi il flag -c, il comando check-ready viene applicato a tutti i componenti del cluster.
delete	Elimina i componenti ibridi dal cluster. Utilizza il flag --all per rimuovere TUTTI i componenti. Se ometti --all, vengono rimossi solo i componenti specifici di Apigee (i componenti installati con apigeectl init non vengono eliminati). I componenti specifici di Apigee sono quelli installati con il comando apply. Se non specifichi il flag -c, il comando delete viene applicato a tutti i componenti di cui è stato eseguito il deployment nel cluster.
help	Guida alla stampa online.
init	Applica al cluster le configurazioni per i componenti preliminari, ad esempio Istio e Apigee Deployment. Utilizza il flag -c per specificare uno o più componenti (separati da virgole).
version	Stampa le informazioni sulla versione dell'interfaccia a riga di comando.

Flag Apigee

Nella tabella seguente sono elencati i flag apigeectl:

Flag	Descrizione
-c, --components	Specifica un singolo componente a cui si applica il comando. Se non specifichi questo flag, il comando si applica a tutti i componenti (l'intero deployment) del cluster. I valori possibili sono: cassandra logger mart metrics runtime synchronizer udca Ad esempio, -c cassandra In alternativa, per specificare più componenti, aggiungi valori separati da virgole: -c cassandra, runtime
--dry-run	Esegue il comando specificato senza modificare il cluster. Utilizza questo criterio con ‑‑print-yaml per restituire le specifiche dell'oggetto visualizzate in un file.
‑f, ‑‑file‑override‑config	Specifica un file YAML contenente proprietà di configurazione personalizzate per il deployment ibrido. Il valore predefinito è ./overrides.yaml. È richiesto un file di sostituzione per i comandi apply, check-ready, delete e init. Devi specificare il percorso completo con questo flag. Per maggiori informazioni, consulta la sezione Gestione dei componenti del piano di runtime.
--print-yaml	Visualizza l'output del modello di configurazione in stdout. Per un esempio che utilizza questo flag, consulta Stampare la configurazione su un file.
-h, --help	Visualizza la guida per il comando.

Il comando apigeectl utilizza il dietro le quinte di kubectl per svolgere il suo lavoro. Le opzioni dei comandi apigeectl (apply e delete e l'uso dei file di configurazione YAML sono simili alle loro controparti kubectl. Per scoprire di più su come vengono gestiti gli oggetti in un cluster Kubernetes, vedi i seguenti argomenti:

• Gestione imperativa degli oggetti Kubernetes tramite i file di configurazione
• Panoramica di kubectl

Esempi

Inizializza la configurazione del cluster

Applica le configurazioni del componente prerequisito al cluster con init. Devi eseguire il comando init prima del giorno apply.

apigeectl init -f my_overrides.yaml

Applica la configurazione del cluster

Per applicare le configurazioni ibride al cluster Kubernetes, utilizza il comando apply. La prima volta che esegui apply, tutti i componenti runtime runtime vengono creati nel cluster. Se apporti modifiche alla configurazione, esegui di nuovo apply per applicare solo le modifiche oppure utilizza -c per applicare solo un componente specifico.

L'esempio seguente applica la configurazione per i componenti del piano di runtime ibrido al cluster:

apigeectl apply -f my_overrides.yaml

Applicare la configurazione per un singolo componente

Per limitare il comando apply a un determinato componente, utilizza il flag -c, come descritto in Flag Apigeectl.

L'esempio seguente applica solo la configurazione del componente Sincronizzatore:

apigeectl apply -c synchronizer -f my_overrides.yaml

L'esempio seguente applica solo la configurazione per i componenti Cassandra e runtime:

apigeectl apply -c cassandra,runtime -f my_overrides.yaml

Stampa la configurazione su un file

Se stai eseguendo il debug di un problema di installazione, è utile stampare l'intera configurazione del cluster in un file per ispezionare le impostazioni di configurazione. Il flag --print-yaml stampa la configurazione ibrida su stdout, mentre il flag --dry-run consente l'esecuzione del comando senza apportare modifiche al cluster.

apigeectl apply -f my_overrides.yaml --dry-run --print-yaml > apigee-hybrid.yaml

NOTA: è buona norma salvare una copia dell'output YAML nel controllo del codice sorgente per riferimento futuro. Tuttavia, tieni presente che il file di output contiene password e segreti che non vuoi archiviare.

Controlla lo stato del pod

L'esempio seguente controlla lo stato dei pod di cui è stato eseguito il deployment nel cluster:

apigeectl check-ready
All containers ready in namespace 'my-namespace'

Elimina il cloud ibrido dal cluster

L'esempio seguente elimina solo i componenti runtime ibridi nel cluster Kubernetes. Per eliminare tutti i contenuti, usa il flag --all.

NOTA: per disinstallare correttamente l'app, devi avere installato kubectl versione 1.11.x o successive.

apigeectl delete -f my_overrides.yaml