apigeectl
adalah antarmuka command line (CLI) untuk menginstal dan mengelola Apigee Hybrid di cluster Kubernetes.
Untuk mengetahui informasi tentang cara mendownload dan menginstal apigeectl
, lihat Mendownload dan menginstal apigeectl.
Cakupan untuk menerapkan apigeectl
Dengan menggunakan flag apigeectl
, Anda mengontrol cakupan yang akan diterapkan perintah
perubahan konfigurasi. Untuk ringkasan cakupan dalam runtime hybrid Apigee, lihat Ringkasan konfigurasi layanan runtime.
Cakupan | Komponen | Flag apigeectl |
---|---|---|
Penyimpanan | Cassandra | --datastore |
Penyimpanan dalam memori | Redis | --redis |
Lingkungan | Runtime Synchronizer UDCA |
--all-envs --env |
Organisasi | Apigee Connect Agent MART Watcher |
--org |
Pelaporan | Metrik Logger |
--telemetry |
Sintaksis apigeectl
apigeectl [command] [flags]
Dengan keterangan:
command: Menentukan operasi yang ingin Anda lakukan. Untuk mengetahui daftar lengkap perintah, lihat perintah apigeectl.
flags: Menentukan parameter perintah. Untuk mengetahui daftar lengkap flag, lihat flag apigeectl.
Perintah apigeectl
Tabel berikut mencantumkan perintah apigeectl
:
Perintah | Deskripsi |
---|---|
apply |
Menerapkan konfigurasi untuk komponen runtime Apigee Hybrid ke cluster Kubernetes Anda.
Flag apigeectl: |
check‑ready |
Memeriksa status pod komponen campuran. Jika semua pod komponen sudah siap, pesan "Semua penampung siap" akan ditampilkan. Untuk pembuatan skrip otomatis, perhatikan bahwa perintah akan keluar dengan status 0 saat semua penampung siap. Jika ada setidaknya satu pod yang belum siap, perintah akan keluar dengan status 1.
Flag apigeectl: |
delete |
Menghapus komponen campuran dari cluster. Gunakan flag
Flag apigeectl: |
encode |
Menampilkan daftar nama yang dienkode dari semua ApigeeDeployment untuk organisasi yang ditentukan atau lingkungan yang ditentukan dalam organisasi yang ditentukan. Nama yang dienkode
menyertakan nama komponen dengan nama organisasi yang di-hash dan jika menggunakan
tanda Anda harus menggunakan ./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 |
Mencetak bantuan online. |
init |
Menginstal Operator dan CRD Apigee di namespace apigee-system.
Jalankan
Flag apigeectl: |
version |
Mencetak informasi versi CLI.
Flag apigeectl: |
Flag apigeectl
Tabel berikut mencantumkan flag apigeectl
:
Flag | Deskripsi |
---|---|
--all |
Khusus delete : Menghapus seluruh penginstalan hibrida Apigee kecuali ASM (Istio)
dan cert-manager dari cluster Anda.
|
--all-envs |
Menerapkan perintah |
--datastore |
Menerapkan konfigurasi ke cakupan datastore (Cassandra). |
‑‑dry‑run |
Menjalankan perintah yang ditentukan tanpa mengubah cluster. Gunakan dengan
‑‑print-yaml untuk menghasilkan spesifikasi objek yang dirender ke file.
|
--env env-name |
Menerapkan konfigurasi ke lingkungan yang ditentukan. Flag ini akan menerapkan konfigurasi ke komponen cakupan lingkungan apigee-runtime, apigee-synchronizer, dan apigee-udca.
apigeectl apply --org hybrid-example --env example-env \ -f overrides/overrides.yaml |
‑f |
Menentukan file YAML yang berisi properti konfigurasi kustom untuk deployment campuran. Nilai defaultnya adalah
./overrides.yaml . File penggantian diperlukan untuk perintah apply ,
check-ready , delete , dan init .
Anda harus menentukan jalur lengkap dengan tanda ini. Untuk informasi selengkapnya, lihat Mengelola komponen platform runtime. |
-h |
Menampilkan bantuan untuk perintah. |
--org |
Menerapkan konfigurasi ke organisasi yang ditentukan. Flag ini akan menerapkan konfigurasi ke komponen cakupan organisasi apigee-connect-agent, apigee-mart, dan apigee-watcher. |
--print‑yaml |
Mencetak output template konfigurasi ke stdout. Untuk contoh yang menggunakan flag ini, lihat Mencetak konfigurasi ke file. |
--redis |
Menerapkan konfigurasi ke cakupan penyimpanan data dalam memori (Redis). |
-s |
Menentukan konfigurasi yang diterapkan perintah. Saat ini, tanda ini
hanya didukung untuk konfigurasi Misalnya, jika Anda membuat perubahan pada konfigurasi apigeectl apply -f my-overrides.yaml --settings virtualhosts \ --org example-org --env example-env |
--telemetry |
Menerapkan konfigurasi untuk komponen telemetri seperti apigee-logger dan apigee-metrics. |
--verbose |
Mencetak log panjang ke std err. |
Contoh
Melakukan inisialisasi konfigurasi cluster
Terapkan konfigurasi komponen prasyarat ke cluster Anda dengan init
.
Anda harus menjalankan perintah init
sebelum apply
.
apigeectl init -f my_overrides.yaml
Menerapkan konfigurasi cluster
Untuk menerapkan konfigurasi campuran ke cluster Kubernetes, gunakan perintah apply
. Saat pertama kali Anda menjalankan apply
, semua
komponen runtime campuran akan dibuat di cluster Anda. Jika Anda membuat perubahan konfigurasi, jalankan ulang
apply
untuk hanya menerapkan perubahan atau gunakan tanda untuk menerapkan perubahan hanya ke cakupan
tertentu.
Contoh berikut menerapkan konfigurasi untuk komponen platform runtime hybrid ke cluster Anda:
apigeectl apply -f my_overrides.yaml
Menerapkan konfigurasi untuk satu komponen
Untuk membatasi perintah apply
ke komponen tertentu, gunakan flag yang dijelaskan dalam flag apigeectl.
Contoh berikut hanya menerapkan konfigurasi untuk komponen Cassandra:
apigeectl apply --datastore -f my_overrides.yaml
Mencetak konfigurasi ke file
Jika Anda men-debug masalah penginstalan, sebaiknya cetak seluruh konfigurasi cluster ke file sehingga Anda dapat memeriksa setelan konfigurasi. Flag --print-yaml
mencetak konfigurasi hibrida ke stdout, dan flag --dry-run
memungkinkan perintah berjalan tanpa membuat perubahan apa pun pada cluster.
apigeectl apply -f my_overrides.yaml --dry-run=client --print-yaml > apigee-hybrid.yaml
Memeriksa status pod
Contoh berikut memeriksa status pod yang di-deploy ke cluster Anda:
apigeectl check-ready -f overrides/overrides.yaml All containers ready in namespace 'my-namespace'
Menghapus hybrid dari cluster
Contoh berikut hanya menghapus komponen runtime campuran ke
cluster Kubernetes Anda. Untuk menghapus semuanya, gunakan flag --all
.
apigeectl delete -f my_overrides.yaml