apigeectl

Al momento stai visualizzando la versione 1.9 della documentazione di Apigee hybrid. Per ulteriori informazioni, consulta Versioni supportate.

Version 1.9 (unsupported)

   Versioni supportate:

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

Versioni non supportate:

• v1.10                                      
• 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.

Ambiti per l'applicazione di apigeectl

Utilizzando i flag apigeectl, puoi controllare gli ambiti a cui il comando applica le modifiche alla configurazione. Per una panoramica degli ambiti all'interno del runtime Apigee hybrid, consulta la Panoramica della configurazione dei servizi di runtime.

Ambito	Componenti	apigeectl flag
Spazio di archiviazione	Cassandra	‑‑datastore
Archiviazione in memoria	Redis	‑‑redis
Ambiente	Runtime Synchronizer UDCA	‑‑all‑envs ‑‑env
Organization (Organizzazione)	Apigee Connect Agent MART Watcher	‑‑org
Report	Logger Metrics	‑‑telemetry

Sintassi apigeectl

apigeectl [command] [flags]

Dove:

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

• 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 al tuo cluster Kubernetes. apigeectl apply senza flag applicherà le modifiche a tutti i componenti del cluster. Flag apigeectl: ‑‑all‑envs, ‑‑datastore, ‑‑dry‑run, ‑‑env, ‑f, ‑‑file‑override‑config, ‑‑help, ‑‑org, ‑‑print‑yaml, ‑‑redis, ‑‑settings virtualhosts, ‑‑telemetry, ‑‑v NOTA: dopo una nuova installazione o un upgrade, devi chiamare apigeectl init prima di chiamare apigeectl apply.
check‑ready	Controlla 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 uno stato pari a 0 quando tutti i contenitori sono pronti. Quando c'è almeno un pod non pronto, il comando si chiude con lo stato 1. Flag Apigee: ‑f, ‑‑file‑override‑config, ‑‑help e ‑‑v
delete	Consente di eliminare i componenti ibride 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. apigeectl delete senza flag facoltativi applica delete a tutti i componenti di cui è stato eseguito il deployment nel cluster. apigeectl diagnostic delete ‑f OVERRIDES_FILE elimina lo spazio dei nomi apigee‑diagnostic creato apigeectl diagnostic. Il flag ‑f / ‑‑file‑override‑config è obbligatorio con apigeectl diagnostic delete Flag apigeectl: ‑‑all, ‑‑all‑envs, ‑‑datastore, ‑‑env, ‑f, ‑‑file‑override‑config, ‑‑help, ‑‑org, ‑‑redis, ‑‑telemetry, ‑‑v Per maggiori informazioni, vedi Disinstallare il runtime ibrido.
diagnostic	Richiama il raccoglitore diagnostico, che acquisisce i dati diagnostici su Kubernetes di un'istanza ibrida Apigee on demand e li archivia in Google Cloud Storage bucket. Il raccoglitore di diagnostica richiede un bucket Google Cloud Storage denominato, un account di servizio con il ruolo Storage Admin e una stanza diagnostic: aggiunta overrides file. Vedi: Utilizzare il raccoltore Diagnostic Proprietà di configurazione riferimento: diagnostic Quando richiami il raccoglitore di dati diagnostici, viene creato uno spazio dei nomi Kubernetes "apigee‑diagnostic". Devi eliminare questo elemento con apigeectl diagnostic delete prima di richiamare di nuovo il raccoglitore diagnostico. Richiama raccoglitore diagnostica: apigeectl diagnostic ‑f OVERRIDES_FILE Elimina il raccoglitore Diagnostic: apigeectl diagnostic delete ‑f OVERRIDES_FILE Flag Apigee: ‑‑file‑override‑config
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 ‑‑env, un nome sottoposta ad hashing dell'ambiente. Apigee Hybrid crea nomi sottoposti ad hashing di organizzazioni e ambienti per evitare conflitti di spazi dei nomi. Devi utilizzare ‑‑org org‑name o entrambi ‑‑org org‑name con ‑‑env env‑name con encode. Ad esempio: ./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 Apigee: ‑‑env, ‑‑org
help	Stampa la guida online.
init	Installa gli operatori e i CRD di Apigee nello spazio dei nomi apigee-system. Esegui apigeectl init dopo una nuova installazione o un upgrade prima di eseguire apigeectl apply. flag apigeectl: ‑f, ‑‑file‑override‑config, ‑‑help, ‑‑v
version	Stampa le informazioni sulla versione dell'interfaccia a riga di comando. flag Apigee: ‑‑help

Flag apigeectl

Nella tabella seguente sono elencati i flag apigeectl:

Bandiera	Descrizione
‑‑all	Solo delete: elimina l'intera installazione ibrida di Apigee tranne ASM (Istio) e cert-manager del tuo cluster.
‑‑all‑envs	Applica il comando apigeectl a tutti gli ambienti all'interno dell'organizzazione specificato nel file di configurazione degli override.
‑‑datastore	Applica la configurazione all'ambito del datastore (Cassandra).
‑‑dry‑run	Esegue il comando specificato senza modificare il cluster. Da utilizzare con ‑‑print‑yaml per inviare la specifica dell'oggetto di cui è stato eseguito il rendering in un file. ‑‑dry‑run deve essere utilizzato con uno dei due valori seguenti, a seconda del di kubectl che stai eseguendo. Usa gcloud version per controllare la tua versione di kubectl: kubectl versione 1.17.x o precedente: ‑‑dry‑run=true kubectl versione 1.18.x o successiva: ‑‑dry‑run=client
‑‑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. ‑‑env deve essere utilizzato con il flag ‑‑org. Ad esempio: apigeectl apply ‑‑org hybrid‑example ‑‑env example‑env \ ‑f overrides/overrides.yaml
‑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 saperne di più, consulta la pagina relativa alla gestione dei componenti del piano di runtime.
‑h ‑‑help	Visualizza la guida per il comando.
‑‑org	Applica la configurazione all'organizzazione specificata. Questo flag verrà applicato ai componenti dell'ambito dell'organizzazione apigee‐connect‐agent, apigee‐mart e apigee‐watcher. Nota: quando utilizzi ‑‑org con encode, devi includere l'ID organizzazione. Ad esempio: apigeectl encode ‑‑org example‑org
‑‑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.
‑‑redis	Applica la configurazione all'ambito di archiviazione dei dati in memoria (Redis).
‑‑restore	Ripristina Cassandra in uno snapshot salvato in precedenza specificato dal Proprietà snapshotTimestamp nella configurazione restore di il file overrides.yaml. Il backup viene ripristinato dal bucket Cloud Storage o un server remoto in base alla configurazione backup in il file overrides.yaml. Per ulteriori informazioni, consulta Ripristinare una regione da un backup.
‑s ‑‑settings virtualhosts	Specifica una configurazione a cui si applica il comando. Al momento, questo flag è supportato solo per la configurazione virtualhosts, che fa parte del componente runtime. Utilizza questo flag se apporti modifiche alle virtualhosts proprietà e niente diverso. 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 \ ‑‑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. int è un numero intero che imposta il livello di dettaglio. int è obbligatorio con ‑‑v. Questa opzione si comporta in modo identico all'opzione kubectl ‑‑v. Nota: questa opzione sostituisce l'elemento ‑‑verbose deprecato .

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

• Gestione imperativa degli oggetti Kubernetes mediante file di configurazione
• Panoramica di kubectl

Esempi

Inizializzare la configurazione del cluster

Applica configurazioni dei componenti dei prerequisiti 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 configurazioni ibride al tuo cluster Kubernetes, utilizza il 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 utilizzare i flag per applicare modifiche a una specifica solo nell'ambito.

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.

Nell'esempio seguente viene applicata solo la configurazione 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'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=client ‑‑print‑yaml > apigee‑hybrid.yaml

NOTA: è buona norma salvare una copia dell'output YAML nel controllo del codice sorgente per riferimento futuro. Tieni presente però che il file di output contiene password e secret che potresti non voler memorizzare.

Controlla 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'

Elimina ibrido dal cluster

Per maggiori dettagli, vedi Disinstallare il runtime ibrido.