apigeectl

Stai visualizzando la versione 1.2 di Documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per ulteriori informazioni, vedi Versioni supportate.

Version 1.2 (unsupported)

Versioni supportate:

• v1.12 (più recente)                        
• v1.11                         
• v1.10                                        
• Elenco delle versioni supportate

Versioni non supportate:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

apigeectl è un'interfaccia a riga di comando (CLI) per l'installazione e la gestione di Apigee hybrid in un cluster Kubernetes. Per informazioni sul download e l'installazione di apigeectl, consulta Scarica e installa apigeectl.

NOTA: devi disporre di kubectl installato e configurato sulla tua macchina di amministrazione Kubernetes per l'utilizzo del comando apigeectl.

Sintassi apigeectl

apigeectl [command] [flags]

Dove:

• command: specifica l'operazione da eseguire eseguire il deployment. Per un elenco completo dei comandi, vedi Comandi Apigee.

• flags: specifica il comando parametri. Per un elenco completo dei flag, vedi apigeectl flags.

Comandi apigeectl

Nella tabella seguente sono elencati i comandi apigeectl:

Comando	Descrizione
apply	Applica configurazioni per il runtime ibrido Apigee ai tuoi Kubernetes in un cluster Kubernetes. Utilizza il flag -c per specificarne uno o più (separati da virgole) componenti. Se non specifichi il valore -c , il comando apply applica tutti dai componenti al cluster. NOTA: devi chiamare apigeectl init prima di chiamare apigeectl apply.
check‑ready	Controlla lo stato dei pod dei componenti ibridi. Quando tutto i pod dei componenti sono pronti, viene visualizzato il messaggio "Tutti i container pronti" come output. Per lo scripting automatico, nota che il comando si chiude con uno stato pari a 0 quando i container sono pronti. Quando c'è almeno un pod non pronto, il comando si chiude con lo stato 1. Se non specifichi il valore -c il flag, il comando check-ready si applica a tutti componenti aggiuntivi nel cluster.
delete	Elimina i componenti ibridi dal cluster. Usa il flag --all per rimuovere TUTTI i componenti. Se ometti --all, solo lo stato specifico di Apigee vengono rimossi (i componenti installati con apigeectl init vengono non eliminato). I componenti specifici di Apigee sono i componenti installati con il comando apply. Se non specifichi il valore -c il flag, il comando delete si applica a tutti dei componenti di cui è stato eseguito il deployment nel cluster.
help	Stampa la guida online.
init	Applica le configurazioni per i componenti dei prerequisiti, come Istio e Deployment Apigee, per nel cluster. Utilizza il flag -c per specificarne uno o più (separati da virgole) componenti.
version	Stampa le informazioni sulla versione dell'interfaccia a riga di comando.

Flag apigeectl

Nella tabella seguente sono elencati i flag apigeectl:

Bandiera	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) nel 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 valore in un cluster Kubernetes. Utilizzalo con ‑‑print-yaml per restituire la specifica dell'oggetto di cui è stato eseguito il rendering a un file.
‑f, ‑‑file‑override‑config	Specifica un file YAML contenente delle proprietà di configurazione per il deployment ibrido. Il valore predefinito è ./overrides.yaml. È richiesto un file di override per apply, Comandi check-ready, delete e init. Devi specificare il percorso completo con questo flag. Per ulteriori informazioni, consulta Gestione dei componenti del piano di runtime.
-h, --help	Visualizza la guida per il comando.
--print-yaml	Stampa l'output del modello di configurazione su stdout. Per un esempio che utilizza questo flag, vedi Stampare la configurazione su un file.
-s, --settings	Specifica una configurazione a cui si applica il comando. Attualmente, questa segnalazione è supportato solo per la configurazione virtualhosts, che fa parte di il componente runtime. Utilizza questo flag se apporti modifiche alle virtualhosts proprietà e niente diverso. (Aggiunta la versione 1.2.0) Ad esempio, se apporti una modifica alla configurazione di virtualhosts nel file degli override, applicalo al cluster con questo comando: apigeectl apply -f my-overrides.yaml --settings virtualhosts -c runtime

Il comando apigeectl usa kubectl per eseguire questa operazione il suo funzionamento. Le opzioni del comando apigeectl (apply e delete, e l'uso dei file di configurazione YAML, sono simili alle loro controparti kubectl. Per saperne di più su come vengono gestiti gli oggetti in un cluster Kubernetes, consulta i seguenti argomenti:

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

Esempi

Inizializzare la configurazione del cluster

Applica configurazioni dei componenti dei prerequisiti al cluster con init. Devi eseguire init prima di apply.

apigeectl init -f my_overrides.yaml

Applica la configurazione del cluster

Per applicare configurazioni ibride al cluster Kubernetes, utilizza Comando apply. La prima volta che esegui apply tutte le vengono creati componenti runtime ibridi nel cluster. Se apporti modifiche alla configurazione, esegui nuovamente apply per applicare solo le modifiche o usa -c per applicare una specifica .

Nell'esempio seguente viene applicata la configurazione per il piano di runtime ibrido componenti per il tuo cluster:

apigeectl apply -f my_overrides.yaml

Applicare la configurazione a un singolo componente

Per limitare il comando apply a un determinato componente, utilizza la classe -c, come descritto in Flag Apigee.

L'esempio seguente applica solo la configurazione per il sincronizzatore componente:

apigeectl apply -c synchronizer -f my_overrides.yaml

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

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'intero configurazione del cluster in un file per poter esaminare la configurazione impostazioni. La bandiera --print-yaml viene stampata la configurazione ibrida a stdout e il flag --dry-run consente senza dover apportare modifiche al cluster.

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

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

Controlla lo stato del pod

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

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

Elimina ibrido dal cluster

L'esempio seguente elimina solo i componenti di runtime ibridi nell'account in un cluster Kubernetes. Per eliminare tutti i dati, utilizza il flag --all.

NOTA: per eseguire correttamente la disinstallazione, devi avere kubectl versione 1.11.x o successiva installata.

apigeectl delete -f my_overrides.yaml