apigeectl

apigeectl adalah antarmuka command line (CLI) untuk menginstal dan mengelola Apigee Hybrid di cluster Kubernetes. Untuk informasi tentang cara mendownload dan menginstal apigeectl, lihat Mendownload dan menginstal apigeectl.

Sintaksis apigeectl

apigeectl [command] [flags]

Dengan:

  • 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. Gunakan tanda -c untuk menentukan satu atau beberapa komponen (yang dipisahkan koma).

Jika Anda tidak menentukan flag -c, perintah apply akan menerapkan semua komponen ke cluster.
check‑ready

Memeriksa status pod komponen hybrid. Jika semua pod komponen sudah siap, pesan "Semua container siap" akan ditampilkan. Untuk pembuatan skrip otomatis, perhatikan bahwa perintah akan keluar dengan status 0 saat semua container siap. Jika ada setidaknya satu pod yang belum siap, perintah akan keluar dengan status 1.

Jika Anda tidak menentukan flag -c, perintah check-ready akan berlaku untuk semua komponen dalam cluster.
delete

Menghapus komponen hybrid dari cluster. Gunakan tanda --all untuk menghapus SEMUA komponen. Jika Anda tidak menyertakan --all, hanya komponen khusus Apigee yang dihapus (komponen yang diinstal dengan apigeectl init tidak dihapus). Komponen khusus Apigee adalah komponen yang diinstal dengan perintah apply.

Jika Anda tidak menentukan flag -c, perintah delete akan berlaku untuk semua komponen yang di-deploy di cluster.
help Mencetak bantuan online.
init

Menerapkan konfigurasi untuk komponen prasyarat, seperti Istio dan Deployment Apigee, ke cluster. Gunakan tanda -c untuk menentukan satu atau beberapa komponen (yang dipisahkan koma).
version Mencetak informasi versi CLI.

Flag apigeectl

Tabel berikut mencantumkan flag apigeectl:

Tanda Deskripsi
-c, --components

Menentukan satu komponen tempat perintah diterapkan.

Jika Anda tidak menentukan flag ini, perintah akan diterapkan ke semua komponen (seluruh deployment) di cluster. Nilai yang memungkinkan mencakup:

  • cassandra
  • logger
  • mart
  • metrics
  • runtime
  • synchronizer
  • udca

Contoh, -c cassandra

Atau, untuk menentukan beberapa komponen, tambahkan nilai yang dipisahkan koma: -c cassandra, runtime

--dry-run Menjalankan perintah yang ditentukan tanpa mengubah cluster. Gunakan dengan ‑‑print-yaml untuk menghasilkan spesifikasi objek yang dirender ke file.
‑f, ‑‑file‑override‑config Menentukan file YAML yang berisi properti konfigurasi kustom untuk deployment hybrid. 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 mengetahui informasi selengkapnya, lihat Mengelola komponen bidang runtime.
-h, --help Menampilkan bantuan untuk perintah.
--print-yaml Mencetak output template konfigurasi ke stdout. Untuk contoh yang menggunakan tanda ini, lihat Mencetak konfigurasi ke file.
-s, --settings

Menentukan konfigurasi yang diterapkan perintah. Saat ini, tanda ini hanya didukung untuk konfigurasi virtualhosts, yang merupakan bagian dari komponen runtime. Gunakan tanda ini jika Anda membuat perubahan pada properti virtualhosts, dan tidak ada yang lain. (Ditambahkan di v1.2.0)

Misalnya, jika Anda membuat perubahan pada konfigurasi virtualhosts di file penggantian, terapkan ke cluster dengan perintah ini:

apigeectl apply -f my-overrides.yaml --settings virtualhosts -c runtime

Contoh

Lakukan 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

Terapkan konfigurasi cluster

Untuk menerapkan konfigurasi hybrid ke cluster Kubernetes, gunakan perintah apply. Saat pertama kali menjalankan apply, semua komponen runtime hybrid dibuat di cluster Anda. Jika Anda membuat perubahan konfigurasi, jalankan ulang apply untuk menerapkan perubahan saja atau gunakan -c untuk menerapkan hanya komponen tertentu.

Contoh berikut menerapkan konfigurasi untuk komponen bidang 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 -c, seperti yang dijelaskan dalam flag apigeectl.

Contoh berikut hanya menerapkan konfigurasi untuk komponen Synchronizer:

apigeectl apply -c synchronizer -f my_overrides.yaml

Contoh berikut hanya menerapkan konfigurasi untuk komponen Cassandra dan runtime:

apigeectl apply -c cassandra,runtime -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 hybrid ke stdout, dan flag --dry-run memungkinkan perintah dijalankan tanpa membuat perubahan apa pun pada cluster.

apigeectl apply -f my_overrides.yaml --dry-run --print-yaml > apigee-hybrid.yaml

Memeriksa status pod

Contoh berikut memeriksa status pod yang di-deploy ke cluster Anda:

apigeectl check-ready
All containers ready in namespace 'my-namespace'

Menghapus hybrid dari cluster

Contoh berikut hanya menghapus komponen runtime hybrid ke cluster Kubernetes Anda. Untuk menghapus semuanya, gunakan flag --all.

apigeectl delete -f my_overrides.yaml