apigeectl

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.

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 i parametri del comando. Per un elenco completo dei flag, consulta flag apigeectl.

Comandi apigeectl

La tabella seguente elenca 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 specificare uno o più componenti (separati da virgole).

Se non specifichi il valore -c , il comando apply applica tutti dai componenti al cluster.

check‑ready

Controlla lo stato dei pod di componenti ibride. Quando tutti i pod dei componenti sono pronti, viene visualizzato il messaggio "Tutti i container pronti". Per lo scripting automatico, nota che il comando si chiude con uno stato pari a 0 quando i container sono pronti. Se almeno un pod non è pronto, il comando esce con uno stato pari a 1.

Se non specifichi il valore -c il flag, il comando check-ready si applica a tutti componenti del cluster.

delete

Elimina i componenti ibridi dal cluster. Utilizza il flag --all per rimuovere TUTTI i componenti. Se ometti --all, vengono applicate solo le query vengono rimossi (i componenti installati con apigeectl init vengono non eliminato). I componenti specifici di Apigee sono quelli 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 Guida online di Stampe.
init

Applica le configurazioni per i componenti prerequisiti, come Istio e Apigee Deployment, al cluster. Utilizza il flag -c per specificare uno o più componenti (separati da virgole).

version Stampa le informazioni sulla versione della CLI.

Flag apigeectl

La tabella seguente elenca 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 cluster. Da utilizzare con ‑‑print-yaml per generare la specifica dell'oggetto visualizzato 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. È necessario un file di override per i comandi apply, 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, consulta Stampare la configurazione in 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 nella versione 1.2.0)

Ad esempio, se apporti una modifica alla configurazione virtualhosts nel file delle sostituzioni, applicala al cluster con questo comando:

apigeectl apply -f my-overrides.yaml --settings virtualhosts -c runtime

Esempi

Inizializzare la configurazione del cluster

Applica le configurazioni dei componenti prerequisiti al tuo 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 di nuovo apply per applicare solo le modifiche o utilizza -c per applicare solo un componente specifico.

Il seguente esempio applica la configurazione per i componenti del piano di runtime ibrida al 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.

Il seguente esempio applica la configurazione solo al componente Synchronizer:

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. Il flag --print-yaml stampa la configurazione ibrida su stdout e il flag --dry-run consente di eseguire il comando senza apportare modifiche al cluster.

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

Controllare lo stato del pod

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

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

Elimina ibrido dal cluster

L'esempio seguente elimina solo i componenti di runtime ibrida nel cluster Kubernetes. Per eliminare tutti i dati, utilizza il flag --all.

apigeectl delete -f my_overrides.yaml