apigeectl
è un'interfaccia a riga di comando (CLI) per l'installazione e la gestione di Apigee hybrid in un cluster Kubernetes.
Per informazioni su come scaricare e installare apigeectl
, consulta Scaricare e installare apigeectl.
Ambiti per l'applicazione di apigeectl
Utilizzando i flag apigeectl
, puoi controllare a quali ambiti il comando applica le modifiche alla configurazione. Per una panoramica degli ambiti all'interno del runtime Apigee hybrid, consulta la Panoramica configurazione del servizio runtime.
Ambito | Componenti | apigeectl flag |
---|---|---|
Spazio di archiviazione | Cassandra | ‑‑datastore |
Spazio di archiviazione in memoria | Redis | ‑‑redis |
Ambiente | Runtime Synchronizer UDCA |
‑‑all‑envs ‑‑env |
Organization (Organizzazione) | Apigee Connect Agent MART Watcher |
‑‑org |
Report | Logger Metriche |
‑‑telemetry |
Sintassi di apigeectl
apigeectl [command] [flags]
Dove:
command: specifica l'operazione da eseguire. Per un elenco completo dei comandi, consulta Comandi apigeectl.
flags: specifica i parametri del comando. Per un elenco completo dei flag, consulta flag di apigeectl.
Comandi apigeectl
La tabella seguente elenca i comandi apigeectl
:
Comando | Descrizione |
---|---|
apply |
Applica le configurazioni per i componenti di runtime di Apigee hybrid al tuo cluster Kubernetes.
Flag apigeectl: |
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 gli script automatici, tieni presente che il comando esce con uno stato pari a 0 quando tutti i contenitori sono pronti. Se almeno un pod non è pronto, il comando esce con uno stato pari a 1.
flag apigeectl: |
delete |
Consente di eliminare i componenti ibride dal cluster. Utilizza il flag
flag di apigeectl: |
diagnostic |
Richiama il raccoglitore di dati di diagnostica, che acquisisce i dati di diagnostica sui componenti Kubernetes di un'istanza ibrida Apigee on demand e li archivia nei bucket Google Cloud Storage. Il Collector diagnostico richiede un bucket Google Cloud Storage denominato, un account di servizio con il ruolo Amministratore archiviazione e una stanza Quando richiami il raccoglitore di dati di diagnostica, viene creato uno spazio dei nomi Kubernetes " Richiama il raccoglitore Diagnostic: apigeectl diagnostic ‑f OVERRIDES_FILE Elimina il raccoglitore Diagnostic: apigeectl diagnostic delete ‑f OVERRIDES_FILE
flag apigeectl:
|
encode |
Restituisce un elenco di nomi codificati di tutti gli ApigeeDeployment per l'organizzazione o l'ambiente specificato all'interno dell'organizzazione specificata. I nomi codificati
includono il nome del componente con un nome sottoposta ad hashing dell'organizzazione e, se si utilizza il
flag Devi utilizzare ./apigeectl encode ‑‑org hybrid‑example List of ApigeeDeployments are: apigee‑connect‑agent‑hybrid‑example‑6a82f8a apigee‑mart‑hybrid‑example‑6a82f8a apigee‑watcher‑hybrid‑example‑6a82f8a ./apigeectl encode ‑‑org hybrid‑example ‑‑env example‑env List of ApigeeDeployments are: apigee‑runtime‑hybrid‑example‑example‑env‑9e87e2d apigee‑synchronizer‑hybrid‑example‑example‑env‑9e87e2d apigee‑udca‑hybrid‑example‑example‑env‑9e87e2d
flag apigeectl: |
help |
Guida online di Stampe. |
init |
Installa gli operatori e i CRD di Apigee nello spazio dei nomi apigee-system.
Esegui
flag apigeectl: |
version |
Stampa le informazioni sulla versione della CLI.
Flag apigeectl: |
Flag apigeectl
La tabella seguente elenca i flag apigeectl
:
Bandiera | Descrizione |
---|---|
‑‑all |
Solo delete : elimina l'intera installazione di Apigee hybrid, ad eccezione di ASM (Istio)
e cert-manager, dal cluster.
|
‑‑all‑envs |
Applica il comando |
‑‑datastore |
Applica la configurazione all'ambito del datastore (Cassandra). |
‑‑dry‑run |
Esegue il comando specificato senza modificare il cluster. Utilizza con
‑‑print‑yaml per esportare la specifica dell'oggetto visualizzato in un file.
|
‑‑env env‑name |
Applica la configurazione all'ambiente specificato. Questo flag applicherà la configurazione ai componenti apigee-runtime, apigee-synchronizer e apigee-udca a livello di ambito dell'ambiente.
apigeectl apply ‑‑org hybrid‑example ‑‑env example‑env \ ‑f overrides/overrides.yaml |
‑f |
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 saperne di più, consulta la pagina relativa alla gestione dei componenti del piano di runtime. |
‑h |
Visualizza la guida per il comando. |
‑‑org |
Applica la configurazione all'organizzazione specificata. Questo flag applicherà la configurazione ai componenti apigee‑connect‑agent, apigee‑mart e apigee‑watcher a livello di ambito dell'organizzazione. |
‑‑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. |
‑‑redis |
Applica la configurazione all'ambito di archiviazione dei dati in memoria (Redis). |
‑‑restore |
Ripristina Cassandra in uno snapshot salvato in precedenza specificato dalla proprietà
|
‑s |
Specifica una configurazione a cui si applica il comando. Al momento, questo flag
è supportato solo per la configurazione Ad esempio, se apporti una modifica alla configurazione apigeectl apply ‑f my‑overrides.yaml ‑‑settings virtualhosts \ ‑‑org example‑org ‑‑env example‑env |
‑‑telemetry |
Applica la configurazione per i componenti di telemetria come apigee‑logger e apigee‑metrics. |
‑‑v int |
Stampa i log dettagliati in stderr. ‑‑verbose
ritirata. |
Esempi
Inizializza la configurazione del cluster
Applica le configurazioni dei componenti prerequisiti al tuo 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 configurazioni ibride al tuo cluster Kubernetes, utilizza il comando
apply
. La prima volta che esegui apply
, tutti i componenti di runtime ibrida vengono creati nel cluster. Se apporti modifiche alla configurazione, esegui di nuovo
apply
per applicare solo le modifiche o utilizza i flag per applicare le modifiche solo a un ambito 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 per un singolo componente
Per limitare il comando apply
a un determinato componente, utilizza i flag descritti in Flag apigeectl.
L'esempio seguente applica la configurazione solo per il componente Cassandra:
apigeectl apply ‑‑datastore ‑f my_overrides.yaml
Stampa la configurazione in un file
Se stai eseguendo il debug di un problema di installazione, è utile stampare l'intera configurazione del cluster in un file in modo da poter ispezionare le impostazioni di configurazione. 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=client ‑‑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 ‑f overrides/overrides.yaml All containers ready in namespace 'my-namespace'