apigeectl
è un'interfaccia a riga di comando (CLI)
per l'installazione e la gestione di Apigee ibrida in un cluster Kubernetes.
Per informazioni sul download e l'installazione di apigeectl
, consulta Scaricare e installare Apigee.
Ambito per l'applicazione di apigeectl
Utilizzando i flag apigeectl
puoi controllare gli ambiti a cui viene applicata la regola di configurazione. Per una panoramica degli ambiti all'interno del runtime di runtime ibrido Apigee, consulta la Panoramica della configurazione del servizio di runtime.
Ambito | Componenti | apigeectl flag |
---|---|---|
Spazio di archiviazione | Cassandra | --datastore |
Spazio di archiviazione in memoria | Redis | --redis |
Ambiente | Runtime Sincronizzatore UDCA |
--all-envs --env |
Organization (Organizzazione) | Agente Apigee Connect MART Watcher |
--org |
Rapporti | Metriche Logger |
--telemetry |
Sintassi Apigee
apigeectl [command] [flags]
Dove:
command: specifica l'operazione che vuoi eseguire. Per un elenco completo dei comandi, consulta la sezione Comandi Apigeectl.
flags: specifica i parametri del comando. Per un elenco completo dei flag, consulta Flag di Apigeectl.
Comandi Apigeectl
Nella tabella seguente sono elencati i comandi apigeectl
:
Comando | Descrizione |
---|---|
apply |
Applica le configurazioni per i componenti runtime ibridi di Apigee al tuo cluster Kubernetes.
Flag Apigeect: |
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 lo script automatico, tieni presente che il comando esce con lo stato 0 quando i container sono tutti pronti. Se almeno un pod non è pronto, il comando esce con lo stato 1.
Flag Apigeect: |
delete |
Elimina i componenti ibridi dal cluster. Utilizza il flag
Flag Apigeect: |
diagnostic |
Richiama il raccoglitore diagnostico, che acquisisce i dati diagnostici sui componenti Kubernetes di un'istanza ibrida Apigee on demand e li archivia nei bucket di archiviazione Google Cloud. L'utilità di raccolta di diagnostica richiede un bucket di archiviazione Google Cloud denominato, un account di servizio con
il ruolo Amministratore Storage e una riga Quando richiami raccoglitore diagnostico, viene creato uno spazio dei nomi " Richiama dati diagnostici: apigeectl diagnostic -f OVERRIDES_FILE Elimina commerciante di diagnostica: apigeectl diagnostic delete -f OVERRIDES_FILE
Flag Apigeect:
|
encode |
Restituisce un elenco di nomi codificati di tutti i deployment Apigee per l'organizzazione specificata o per l'ambiente specificato all'interno dell'organizzazione specificata. I nomi codificati includono il nome del componente con un nome sottoposto ad hashing dell'organizzazione e, se utilizzi 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 per le stampe. |
init |
Installa gli operatori Apigee e CRD nello spazio dei nomi del sistema Apigee.
Esegui
Flag Apigeect: |
version |
Stampa le informazioni sulla versione dell'interfaccia a riga di comando.
Bandiera Apigeectl: |
Flag Apigee Apigee
Nella tabella seguente sono elencati i flag apigeectl
:
Flag | Descrizione |
---|---|
--all |
Solo delete : elimina l'intera installazione ibrida di Apigee, tranne ASM (Istio) e cert-manager dal cluster.
|
--all-envs |
Applica il comando |
--datastore |
Applica la configurazione all'ambito datastore (Cassandra). |
‑‑dry‑run |
Esegue il comando specificato senza modificare il cluster. Utilizza con ‑‑print-yaml per generare in un file le specifiche dell'oggetto sottoposto a rendering.
|
--env env-name |
Applica la configurazione all'ambiente specificato. Il flag applicherà la configurazione 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 proprietà di configurazione personalizzate per il deployment ibrido. Il valore predefinito è
./overrides.yaml . È richiesto 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 la sezione Gestire i componenti del piano di runtime. |
-h |
Visualizza la guida per il comando. |
--org |
Applica la configurazione all'organizzazione specificata. Il flag applicherà la configurazione 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 di utilizzo di questo flag, vedi Stampare la configurazione in un file. |
--redis |
Applica la configurazione all'ambito di archiviazione dei dati in memoria (Redis). |
--restore |
Ripristina Cassandra su uno snapshot salvato in precedenza specificato dalla
proprietà |
-s |
Specifica una configurazione a cui si applica il comando. Attualmente, questo flag
è supportato solo per la configurazione Ad esempio, se modifichi la 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. |
--verbose |
Stampa i log dettagliati in std err. |
Esempi
Inizializza la configurazione del cluster
Applica le configurazioni dei componenti 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 le configurazioni ibride al cluster Kubernetes, utilizza il comando apply
. La prima volta che esegui apply
, tutti i componenti runtime ibridi vengono creati nel cluster. Se apporti modifiche alla configurazione, esegui nuovamente apply
per applicare solo le modifiche o utilizza i flag per applicare le modifiche solo a un ambito specifico.
L'esempio seguente applica la configurazione per i componenti del piano di runtime ibrido 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 solo la configurazione per il componente Cassandra:
apigeectl apply --datastore -f my_overrides.yaml
Stampare la configurazione su un file
Se stai eseguendo il debug di un problema di installazione, è utile stampare l'intera configurazione del cluster a un file in modo da poter controllare le impostazioni di configurazione. Il flag --print-yaml
stampa
la configurazione ibrida su stdout e il flag --dry-run
consente
l'esecuzione del comando senza 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 verifica 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 il modello ibrido dal cluster
L'esempio seguente elimina solo i componenti runtime ibridi nel cluster Kubernetes. Per eliminare tutti i dati, utilizza il flag --all
.
apigeectl delete -f my_overrides.yaml