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.
Ambiti per l'applicazione di apigeectl
Utilizzando i flag apigeectl
puoi stabilire gli ambiti in base al comando
a cui applicare le modifiche alla configurazione. Per una panoramica degli ambiti all'interno del runtime di Apigee hybrid
consulta la panoramica della configurazione del servizio 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) | Osservatore dell'agente Apigee Connect MART |
‑‑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, 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 al tuo cluster Kubernetes.
Flag Apigee: |
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.
Flag Apigee: |
delete |
Elimina i componenti ibridi dal cluster. Usa il flag
Flag Apigee: |
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 Quando richiami il raccoglitore diagnostico, viene creato un " Richiama raccoglitore diagnostica: apigeectl diagnostic ‑f OVERRIDES_FILE Elimina raccoglitore di diagnostica: apigeectl diagnostic delete ‑f OVERRIDES_FILE
Flag Apigee:
|
encode |
Restituisce un elenco di nomi codificati di tutti gli ApigeeDeployment per il
dell'organizzazione o dell'ambiente specificato
all'interno dell'organizzazione specificata. I nomi codificati
includi il nome del componente con il nome dell'organizzazione sottoposto ad hashing e, se utilizzi
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 Apigee: |
help |
Stampa la guida online. |
init |
Installa operatori Apigee e CRD nello spazio dei nomi apigee‐system.
Esegui
Flag Apigee: |
version |
Stampa le informazioni sulla versione dell'interfaccia a riga di comando.
flag Apigee: |
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 |
‑‑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.
|
‑‑env env‑name |
Applica la configurazione all'ambiente specificato. Questo flag verrà applicato ai componenti dell'ambito dell'ambiente apigee‐runtime, apigee‐synchronizer e apigee‐udca.
apigeectl apply ‑‑org hybrid‑example ‑‑env example‑env \ ‑f overrides/overrides.yaml |
‑f |
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 |
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. |
‑‑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 dell'archiviazione dei dati in memoria (Redis). |
‑‑restore |
Ripristina Cassandra in uno snapshot salvato in precedenza specificato dal
Proprietà |
‑s |
Specifica una configurazione a cui si applica il comando. Attualmente, questa segnalazione
è supportato solo per la configurazione Ad esempio, se apporti una modifica alla configurazione di 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 log dettagliati in std err. ‑‑verbose deprecato
. |
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 utilizzare i flag per applicare le modifiche a una specifica
solo nell'ambito.
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
i flag descritti in apigeectl flag.
Nell'esempio seguente viene applicata solo la configurazione per il componente Cassandra:
apigeectl apply ‑‑datastore ‑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=client ‑‑print‑yaml > apigee‑hybrid.yaml
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 ‑f overrides/overrides.yaml All containers ready in namespace 'my-namespace'