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 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 le configurazioni per i componenti di runtime di Apigee hybrid 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. Se almeno un pod non è pronto, il comando esce con uno stato pari a 1.
Flag Apigee: |
delete |
Elimina i componenti ibridi dal cluster. Usa il flag
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 apigeectl: |
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 dal 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 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 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, consulta Stampare la configurazione in un file. |
--redis |
Applica la configurazione all'ambito dell'archiviazione dei dati in memoria (Redis). |
-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. |
--verbose |
Stampa log dettagliati in std err. |
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 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
descritti in Flag Apigee.
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
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'
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
.
apigeectl delete -f my_overrides.yaml