apigeectl

Saat ini Anda melihat versi 1.6 dari dokumentasi Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.6 (unsupported)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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.

CATATAN: Anda harus menginstal dan menyiapkan kubectl di mesin administrasi Kubernetes untuk menggunakan perintah apigeectl.

Cakupan untuk menerapkan apigeectl

Dengan menggunakan flag apigeectl, Anda dapat mengontrol cakupan yang akan diterapkan perubahan konfigurasi oleh perintah. Untuk ringkasan cakupan dalam runtime Apigee Hybrid, 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	Logger Metrics	--telemetry

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. apigeectl apply tanpa tanda akan menerapkan perubahan pada semua komponen dalam cluster. Flag apigeectl: --all-envs, --datastore, --dry-run, --env, -f, --file-override-config, --help, --org, --print-yaml, --redis, --settings virtualhosts, --telemetry,--verbose CATATAN: Setelah penginstalan baru atau upgrade, Anda harus memanggil apigeectl init sebelum memanggil apigeectl apply.
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. flag apigeectl: -f, --file-override-config, --help, --verbose
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. apigeectl delete tanpa tanda opsional apa pun akan menerapkan perintah delete ke semua komponen yang di-deploy di cluster. apigeectl diagnostic delete -f OVERRIDES_FILE menghapus namespace apigee-diagnostic yang dibuat oleh apigeectl diagnostic. Flag -f / --file-override-config diperlukan dengan apigeectl diagnostic delete Flag apigeectl: --all, --all-envs, --datastore, --env, -f, --file-override-config, --help, --org, --redis, --telemetry, --verbose
diagnostic	Memanggil pengumpul Diagnostik, yang mengambil data diagnostik pada komponen Kubernetes dari instance hybrid Apigee sesuai permintaan dan menyimpannya di bucket penyimpanan Google Cloud. Pengumpul diagnostik memerlukan bucket penyimpanan Google Cloud bernama, akun layanan dengan peran Storage Admin, dan stanza diagnostic: yang ditambahkan ke file overrides Anda. Lihat: Menggunakan pengumpul diagnostik Referensi properti konfigurasi: diagnostic Saat Anda memanggil pengumpul Diagnostik, pengumpul akan membuat namespace Kubernetes "apigee-diagnostic". Anda harus menghapusnya dengan apigeectl diagnostic delete sebelum memanggil pengumpul Diagnostik lagi. Panggil pengumpul Diagnostik: apigeectl diagnostic -f OVERRIDES_FILE Hapus pengumpul Diagnostik: apigeectl diagnostic delete -f OVERRIDES_FILE Flag apigeectl: --file-override-config
encode	Menampilkan daftar nama yang dienkode dari semua ApigeeDeployment untuk organisasi yang ditentukan atau lingkungan yang ditentukan dalam organisasi yang ditentukan. Nama yang dienkode mencakup nama komponen dengan nama organisasi yang di-hash dan jika menggunakan flag --env, nama lingkungan yang di-hash. Apigee Hybrid membuat nama organisasi dan lingkungan yang di-hash untuk menghindari konflik namespace. Anda harus menggunakan flag --org org-name atau kedua flag --org org-name dengan --env env-name bersama encode. Contoh: ./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: --env, --org
help	Mencetak bantuan online.
init	Menginstal Operator dan CRD Apigee di namespace apigee-system. Jalankan apigeectl init setelah penginstalan atau upgrade baru sebelum menjalankan apigeectl apply. flag apigeectl: -f, --file-override-config, --help, --verbose
version	Mencetak informasi versi CLI. flag apigeectl: --help

Flag apigeectl

Tabel berikut mencantumkan flag apigeectl:

Tanda	Deskripsi
--all	delete saja: Menghapus seluruh penginstalan hybrid Apigee kecuali ASM (Istio) dan cert-manager dari cluster Anda.
--all-envs	Menerapkan perintah apigeectl ke semua lingkungan dalam organisasi yang ditentukan dalam file konfigurasi penggantian Anda.
--datastore	Menerapkan konfigurasi ke cakupan datastore (Cassandra).
‑‑dry‑run	Mengeksekusi perintah yang ditentukan tanpa mengubah cluster. Gunakan dengan ‑‑print-yaml untuk menghasilkan spesifikasi objek yang dirender ke file. ‑‑dry‑run harus digunakan dengan salah satu dari dua nilai berikut, bergantung pada versi kubectl yang Anda jalankan. Gunakan gcloud version untuk memeriksa versi kubectl Anda: kubectl versi 1.17.x atau yang lebih lama: ‑‑dry‑run=true kubectl versi 1.18.x atau yang lebih baru: ‑‑dry‑run=client
--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. --env harus digunakan dengan flag --org. Contoh: apigeectl apply --org hybrid-example --env example-env \ -f overrides/overrides.yaml
‑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.
--org	Menerapkan konfigurasi ke organisasi yang ditentukan. Flag ini akan menerapkan konfigurasi ke komponen cakupan org apigee-connect-agent, apigee-mart, dan apigee-watcher. Catatan: Saat menggunakan --org dengan encode, Anda harus menyertakan ID organisasi. Contoh: apigeectl encode --org example-org
--print‑yaml	Mencetak output template konfigurasi ke stdout. Untuk contoh yang menggunakan tanda ini, lihat Mencetak konfigurasi ke file.
--redis	Menerapkan konfigurasi ke cakupan penyimpanan data dalam memori (Redis).
--restore	(Diperkenalkan di v1.6.6) Memulihkan Cassandra ke snapshot yang disimpan sebelumnya yang ditentukan oleh properti snapshotTimestamp dalam konfigurasi restore dari file overrides.yaml. Cadangan dipulihkan dari bucket Cloud Storage atau server jarak jauh berdasarkan konfigurasi backup di file overrides.yaml. Untuk mengetahui informasi selengkapnya, lihat Memulihkan region dari cadangan.
-s ‑‑settings virtualhosts	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. 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 \ --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.

Perintah apigeectl menggunakan kubectl di balik layar untuk melakukan tugasnya. Opsi perintah apigeectl (apply dan delete, serta penggunaan file konfigurasi YAML, serupa dengan perintah kubectl yang setara. Untuk mempelajari lebih lanjut cara objek dikelola di cluster Kubernetes, lihat topik berikut:

• Pengelolaan Imperatif Objek Kubernetes Menggunakan File Konfigurasi
• Ringkasan kubectl

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 hanya perubahan atau gunakan tanda untuk menerapkan perubahan hanya pada cakupan 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 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 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=client --print-yaml > apigee-hybrid.yaml

CATATAN: Sebaiknya simpan salinan output YAML dalam kontrol sumber untuk referensi di masa mendatang. Namun, perlu diketahui bahwa file output berisi sandi dan rahasia yang mungkin tidak ingin Anda simpan.

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 hybrid ke cluster Kubernetes Anda. Untuk menghapus semuanya, gunakan flag --all.

CATATAN: Agar berhasil meng-uninstal, Anda harus menginstal kubectl versi 1.11.x atau yang lebih baru.

apigeectl delete -f my_overrides.yaml