Menyediakan bidang kontrol Cloud Service Mesh terkelola di GKE
Panduan ini Untuk mengetahui informasi selengkapnya, lihat Ringkasan Cloud Service Mesh.Cloud Service Mesh adalah mesh layanan yang dikelola Google yang cukup Anda aktifkan. Google menangani keandalan, peningkatan, penskalaan, dan keamanan untuk Anda.
Halaman ini menunjukkan cara menggunakan API fleet untuk menyiapkan Cloud Layanan Mesh yang terkelola menggunakan Istio API.
Prasyarat
Sebagai titik awal, panduan ini mengasumsikan bahwa Anda telah:
- Project Cloud
- Akun Penagihan Cloud
- Memperoleh izin yang diperlukan untuk menyediakan Cloud Service Mesh
- Workload Identity telah diaktifkan di cluster Anda.
Persyaratan
- Satu atau beberapa cluster dengan versi GKE yang didukung, di salah satu region yang didukung.
- Pastikan cluster Anda memiliki kapasitas yang cukup untuk komponen yang diperlukan yang mengelola penginstalan Cloud Service Mesh di cluster.
- Deployment
mdp-controller
dalam namespacekube-system
meminta cpu:50m, memory: 128Mi. - Daemon
istio-cni-node
dalam namespacekube-system
meminta cpu: 100m, memory: 100Mi pada setiap node.
- Deployment
- Pastikan mesin klien tempat Anda menyediakan Cloud Service Mesh terkelola memiliki konektivitas jaringan ke server API.
- Cluster Anda harus terdaftar ke fleet. Hal ini disertakan dalam petunjuk, atau dapat dilakukan secara terpisah sebelum penyediaan.
- Project Anda harus mengaktifkan fitur fleet Service Mesh. Tindakan ini disertakan dalam petunjuk atau dapat dilakukan secara terpisah.
Autopilot GKE hanya didukung dengan GKE versi 1.21.3+.
Cloud Service Mesh dapat menggunakan beberapa cluster GKE dalam lingkungan jaringan tunggal project tunggal atau lingkungan jaringan tunggal multi-project.
- Jika Anda bergabung dengan cluster yang tidak berada dalam project yang sama, cluster tersebut harus didaftarkan ke project host perangkat yang sama, dan cluster harus berada dalam konfigurasi VPC bersama bersama di jaringan yang sama.
- Untuk lingkungan multi-cluster project tunggal, project fleet dapat sama dengan project cluster. Untuk mengetahui informasi selengkapnya tentang fleet, lihat Ringkasan Armada.
- Untuk lingkungan multi-project, sebaiknya Anda menghosting fleet dalam project terpisah dari project cluster. Jika kebijakan organisasi dan konfigurasi yang ada mengizinkannya, sebaiknya gunakan project VPC bersama sebagai project host fleet. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan cluster dengan VPC Bersama.
Peran yang diperlukan untuk menginstal Cloud Service Mesh
Tabel berikut menjelaskan peran yang diperlukan untuk menginstal Cloud Service Mesh terkelola.
Nama peran | ID Peran | Berikan lokasi | Deskripsi |
---|---|---|---|
GKE Hub Admin | roles/gkehub.admin | Project fleet | Akses penuh ke GKE Hub dan resource terkait. |
Service Usage Admin | roles/serviceusage.serviceUsageAdmin | Project fleet | Kemampuan untuk mengaktifkan, menonaktifkan, dan memeriksa status layanan, memeriksa operasi, serta menggunakan kuota dan penagihan untuk project konsumen. (Catatan 1) |
CA Service Admin Beta | roles/privateca.admin | Project fleet | Akses penuh ke semua resource CA Service. (Catatan 2) |
Batasan
Sebaiknya tinjau daftar fitur dan batasan yang didukung Cloud Service Mesh. Secara khusus, perhatikan hal-hal berikut:
IstioOperator
API tidak didukung karena tujuan utamanya adalah mengontrol komponen dalam cluster.Penggunaan Certificate Authority Service (CA Service) memerlukan konfigurasi Cloud Service Mesh per cluster, dan tidak didukung saat menggunakan konfigurasi default fisik di GKE Enterprise.
Untuk cluster GKE Autopilot, penyiapan lintas project hanya didukung dengan GKE 1.23 atau yang lebih baru.
Untuk cluster GKE Autopilot, guna beradaptasi dengan batas resource GKE Autopilot, batas dan permintaan resource proxy default ditetapkan ke 500 m CPU dan memori 512 Mb. Anda dapat mengganti nilai default menggunakan injeksi kustom.
Selama proses penyediaan untuk bidang kontrol terkelola, Istio CRD disediakan di cluster yang ditentukan. Jika sudah ada CRD Istio di cluster, CRD tersebut akan ditimpa
Istio CNI dan Cloud Service Mesh tidak kompatibel dengan GKE Sandbox. Oleh karena itu, Cloud Service Mesh yang dikelola dengan implementasi
TRAFFIC_DIRECTOR
tidak mendukung cluster dengan GKE Sandbox yang diaktifkan.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
- Konfigurasikan
gcloud
(meskipun Anda menggunakan Cloud Shell). -
Lakukan autentikasi dengan Google Cloud CLI, dengan FLEET_PROJECT_ID
adalah ID project Fleet Host Anda. Umumnya, FLEET_PROJECT_ID dibuat secara default dan memiliki nama yang sama dengan project.
gcloud auth login --project FLEET_PROJECT_ID
- Update komponen:
gcloud components update
-
Aktifkan API yang diperlukan pada project host fleet Anda.
gcloud services enable mesh.googleapis.com \ --project=FLEET_PROJECT_ID
Di konsol Google Cloud, buka halaman Feature Manager.
Di panel Service Mesh, klik Configure.
Tinjau setelan yang diwarisi oleh semua cluster baru yang Anda buat di Konsol Google Cloud dan daftarkan ke fleet.
Untuk menerapkan setelan ini, klik Konfigurasi.
Pada dialog konfirmasi, klik Confirm.
Opsional: Sinkronkan cluster yang ada ke setelan default:
- Di daftar Clusters in the fleet, pilih cluster yang ingin Anda sinkronkan. Anda hanya dapat memilih cluster yang telah menginstal Cloud Service Mesh.
- Klik Sync to fleet settings dan klik Confirm di dialog konfirmasi yang muncul. Operasi ini dapat memerlukan waktu beberapa menit hingga selesai.
Setelan tingkat perangkat
Buat file
mesh.yaml
yang hanya berisi satu barismanagement: automatic
:echo "management: automatic" > mesh.yaml
Aktifkan Cloud Service Mesh untuk fleet Anda:
gcloud container fleet mesh enable --project FLEET_PROJECT_ID \ --fleet-default-member-config mesh.yaml
Jika melihat error berikut, Anda perlu mengaktifkan GKE Enterprise.
ERROR: (gcloud.container.fleet.mesh.enable) FAILED_PRECONDITION: The [anthos.googleapis.com] service is required for this operation and is not enabled for the project [PROJECT_NUMBER]. Please use the Google Developers Console to enable it.: failed precondition
Setelan tingkat jaringan
Jika project jaringan Anda berbeda dengan project host fleet (misalnya, Anda menggunakan VPC bersama), Anda harus mengizinkan akun layanan Cloud Service Mesh di project fleet untuk mengakses project jaringan. Anda hanya perlu melakukannya sekali untuk project jaringan.
Beri akun layanan di project fleet izin untuk mengakses project jaringan:
gcloud projects add-iam-policy-binding "NETWORK_PROJECT_ID" \ --member "serviceAccount:service-FLEET_PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role roles/anthosservicemesh.serviceAgent
Setelan tingkat cluster
Setelah siap membuat cluster yang akan digunakan dengan Cloud Service Mesh, buat dan daftarkan cluster tersebut dalam satu langkah dengan Google Cloud CLI untuk menggunakan konfigurasi default. Contoh:
gcloud container clusters create-auto CLUSTER_NAME \ --fleet-project FLEET_PROJECT_ID \ --location=LOCATION
Anda bisa mendapatkan nomor project untuk project fleet dengan menjalankan perintah berikut:
gcloud projects list --filter="FLEET_PROJECT_ID" --format="value(PROJECT_ID)"
Flag
--location
adalah zona atau region komputasi (sepertius-central1-a
atauus-central1
) untuk cluster.Jika project cluster Anda berbeda dengan project host fleet, Anda harus mengizinkan akun layanan Cloud Service Mesh dalam project fleet untuk mengakses project cluster, dan mengaktifkan API yang diperlukan pada project cluster. Anda hanya perlu melakukan ini sekali untuk setiap project cluster.
Beri akun layanan dalam project fleet izin untuk mengakses project cluster:
gcloud projects add-iam-policy-binding "CLUSTER_PROJECT_ID" \ --member "serviceAccount:service-FLEET_PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role roles/anthosservicemesh.serviceAgent
Aktifkan Mesh API di project cluster:
gcloud services enable mesh.googleapis.com \ --project=CLUSTER_PROJECT_ID
Ganti CLUSTER_PROJECT_ID dengan ID unik project cluster Anda. Jika Anda membuat cluster dalam project yang sama dengan fleet, CLUSTER_PROJECT_ID akan sama dengan FLEET_PROJECT_ID.
Daftarkan cluster GKE menggunakan identitas workload fleet. Flag
--location
adalah zona atau region komputasi (sepertius-central1-a
atauus-central1
) untuk cluster.gcloud container clusters update CLUSTER_NAME \ --location CLUSTER_LOCATION \ --fleet-project FLEET_PROJECT_ID
Pastikan bahwa cluster Anda terdaftar:
gcloud container fleet memberships list --project FLEET_PROJECT_ID
Contoh output:
NAME EXTERNAL_ID LOCATION cluster-1 1d8e255d-2b55-4df9-8793-0435461a2cbc us-central1
Catat MEMBERSHIP_NAME, karena Anda akan membutuhkannya saat mengaktifkan pengelolaan otomatis.
Jika project jaringan cluster Anda berbeda dengan project host fleet Anda (misalnya, Anda menggunakan VPC bersama), Anda harus mengizinkan akun layanan Cloud Service Mesh di project fleet untuk mengakses project jaringan. Anda hanya perlu melakukannya sekali untuk project jaringan.
Beri akun layanan di project fleet izin untuk mengakses project jaringan:
gcloud projects add-iam-policy-binding "NETWORK_PROJECT_ID" \ --member "serviceAccount:service-FLEET_PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role roles/anthosservicemesh.serviceAgent
Jika project cluster Anda berbeda dengan project host fleet, Anda harus mengizinkan akun layanan Cloud Service Mesh di project fleet untuk mengakses project cluster, dan mengaktifkan API yang diperlukan pada project cluster.
Anda hanya perlu melakukannya sekali untuk setiap project cluster. Jika sebelumnya Anda telah mengonfigurasi Cloud Service Mesh terkelola untuk kombinasi project cluster dan project ini, berarti perubahan ini telah diterapkan dan Anda tidak perlu menjalankan perintah berikut.
Beri akun layanan di project fleet izin untuk mengakses project cluster:
gcloud projects add-iam-policy-binding "CLUSTER_PROJECT_ID" \ --member "serviceAccount:service-FLEET_PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role roles/anthosservicemesh.serviceAgent
Aktifkan Mesh API di project cluster:
gcloud services enable mesh.googleapis.com \ --project=CLUSTER_PROJECT_ID
- MEMBERSHIP_NAME adalah nama keanggotaan yang tercantum saat Anda memverifikasi bahwa cluster Anda telah terdaftar di fleet.
MEMBERSHIP_LOCATION adalah lokasi keanggotaan Anda (baik region, maupun
global
).Jika Anda baru saja membuat keanggotaan menggunakan perintah dalam panduan ini, ini harus merupakan region cluster Anda. Jika Anda memiliki cluster zona, gunakan region yang sesuai dengan zona cluster. Misalnya, jika Anda memiliki cluster zona di
us-central1-c
, gunakan nilaius-central1
.Nilai ini mungkin
global
jika Anda mendaftar sebelum Mei 2023, atau jika Anda menentukan lokasiglobal
saat mendaftarkan langganan. Anda dapat memeriksa lokasi langganan dengangcloud container fleet memberships list --project FLEET_PROJECT_ID
.- Pod yang tidak dimasukkan
- Pod yang dimasukkan secara manual
- Tugas
- StatefulSets
- DaemonSets
Buka halaman Komunikasi.
Di baris Cloud Service Mesh Upgrade, pada kolom Email, pilih tombol pilihan untuk MENGAKTIFKAN notifikasi pemeliharaan.
- Terapkan label injeksi default ke namespace:
Jalankan perintah berikut untuk menemukan saluran rilis yang tersedia:
kubectl -n istio-system get controlplanerevision
Outputnya mirip dengan hal berikut ini:
NAME AGE asm-managed-rapid 6d7h
CATATAN: Jika dua revisi bidang kontrol muncul dalam daftar di atas, hapus salah satu. Memiliki beberapa saluran bidang kontrol dalam cluster tidak didukung.
Pada output, nilai pada kolom
NAME
adalah label revisi yang sesuai dengan saluran rilis yang tersedia untuk versi Cloud Service Mesh.Terapkan label revisi ke namespace:
kubectl label namespace NAMESPACE \ istio-injection- istio.io/rev=REVISION_LABEL --overwrite
- Kubernetes mengharuskan kolom
image
ditetapkan sebelum injeksi berjalan. Meskipun Anda dapat menyetel gambar tertentu untuk mengganti gambar default, sebaiknya tetapkanimage
keauto
, yang akan menyebabkan injektor file bantuan otomatis memilih gambar yang akan digunakan. - Beberapa kolom di
containers
bergantung pada setelan terkait. Misalnya, harus kurang dari atau sama dengan batas CPU. Jika kedua kolom tidak dikonfigurasi dengan benar, pod mungkin gagal dimulai. - Kubernetes memungkinkan Anda menetapkan
requests
danlimits
untuk resource di Podspec
. Autopilot GKE hanya mempertimbangkanrequests
. Untuk mengetahui informasi selengkapnya, lihat Menetapkan batas resource di Autopilot. - Untuk GKE Standard, jika
sidecar.istio.io/proxyCPU
ditetapkan, pastikan untuk menetapkansidecar.istio.io/proxyCPULimit
secara eksplisit. Jika tidak, batas CPU file bantuan akan ditetapkan sebagai tidak terbatas. - Untuk GKE Standard, jika
sidecar.istio.io/proxyMemory
ditetapkan, pastikan untuk menetapkansidecar.istio.io/proxyMemoryLimit
secara eksplisit. Jika tidak, batas memori file bantuan akan ditetapkan sebagai tidak terbatas. - Untuk GKE Autopilot, mengonfigurasi resource
requests
danlimits
menggunakan anotasi dapat menyediakan resource secara berlebihan. Sebaiknya hindari pendekatan template gambar. Lihat Contoh modifikasi resource di Autopilot. - Ganti label namespace saat ini. Langkah-langkah bergantung pada penerapan bidang kontrol Anda.
- Terapkan label injeksi default ke namespace:
Jalankan perintah berikut untuk menemukan saluran rilis yang tersedia:
kubectl -n istio-system get controlplanerevision
Outputnya mirip dengan hal berikut ini:
NAME AGE asm-managed-rapid 6d7h
CATATAN: Jika dua revisi bidang kontrol muncul dalam daftar di atas, hapus salah satu. Memiliki beberapa saluran bidang kontrol dalam cluster tidak didukung.
Pada output, nilai pada kolom
NAME
adalah label revisi yang sesuai dengan saluran rilis yang tersedia untuk versi Cloud Service Mesh.Terapkan label revisi ke namespace:
kubectl label namespace NAMESPACE \ istio-injection- istio.io/rev=REVISION_LABEL --overwrite
Lakukan upgrade berkelanjutan untuk deployment di namespace:
kubectl rollout restart deployment -n NAMESPACE
Uji aplikasi Anda untuk memverifikasi bahwa beban kerja berfungsi dengan benar.
Jika Anda memiliki workload di namespace lain, ulangi langkah-langkah sebelumnya untuk setiap namespace.
Jika Anda men-deploy aplikasi dalam penyiapan multi-cluster, buat replika konfigurasi Kubernetes dan Istio di semua cluster, kecuali jika ada keinginan untuk membatasi konfigurasi tersebut ke sebagian cluster saja. Konfigurasi yang diterapkan ke cluster tertentu adalah sumber tepercaya untuk cluster tersebut.
Update workload yang akan dimasukkan dengan versi bidang kontrol sebelumnya. Dalam perintah berikut, nilai revisi
asm-191-1
hanya digunakan sebagai contoh. Ganti nilai contoh dengan label revisi bidang kontrol sebelumnya.kubectl label namespace NAMESPACE istio-injection- istio.io/rev=asm-191-1 --overwrite
Mulai ulang Pod untuk memicu injeksi ulang sehingga proxy memiliki versi sebelumnya:
kubectl rollout restart deployment -n NAMESPACE
Mengaktifkan mesh.googleapis.com akan mengaktifkan API berikut:
API | Tujuan | Bisa Dinonaktifkan |
---|---|---|
meshconfig.googleapis.com |
Cloud Service Mesh menggunakan Mesh Configuration API untuk merelai data konfigurasi dari mesh Anda ke Google Cloud. Selain itu, mengaktifkan Mesh Configuration API memungkinkan Anda mengakses halaman Cloud Service Mesh di Konsol Google Cloud dan menggunakan certificate authority Cloud Service Mesh. | Tidak |
meshca.googleapis.com |
Terkait dengan certificate authority Cloud Service Mesh yang digunakan oleh Cloud Service Mesh terkelola. | Tidak |
container.googleapis.com |
Diperlukan untuk membuat cluster Google Kubernetes Engine (GKE). | Tidak |
gkehub.googleapis.com |
Diperlukan untuk mengelola mesh sebagai fleet. | Tidak |
monitoring.googleapis.com |
Diperlukan untuk mengambil telemetri untuk workload mesh. | Tidak |
stackdriver.googleapis.com |
Diperlukan untuk menggunakan UI Services. | Tidak |
opsconfigmonitoring.googleapis.com |
Diperlukan untuk menggunakan UI Layanan bagi cluster di luar Google Cloud. | Tidak |
connectgateway.googleapis.com |
Diperlukan agar bidang kontrol Cloud Service Mesh terkelola dapat mengakses workload mesh. | Ya* |
trafficdirector.googleapis.com |
Mengaktifkan bidang kontrol terkelola yang sangat tersedia dan skalabel. | Ya* |
networkservices.googleapis.com |
Mengaktifkan bidang kontrol terkelola yang sangat tersedia dan skalabel. | Ya* |
networksecurity.googleapis.com |
Mengaktifkan bidang kontrol terkelola yang sangat tersedia dan skalabel. | Ya* |
Mengonfigurasi Mesh Layanan Cloud terkelola
Langkah-langkah yang diperlukan untuk menyediakan Cloud Service Mesh terkelola menggunakan fleet API bergantung pada apakah Anda memilih untuk mengaktifkan secara default untuk cluster fleet baru atau mengaktifkannya per cluster.
Mengonfigurasi untuk fleet Anda
Jika telah mengaktifkan Google Kubernetes Engine (GKE) edisi Enterprise, Anda dapat mengaktifkan Cloud Service Mesh terkelola sebagai konfigurasi default untuk fleet Anda. Artinya, setiap GKE baru di cluster Google Cloud yang terdaftar selama pembuatan cluster akan mengaktifkan Cloud Service Mesh terkelola di cluster tersebut. Anda dapat mengetahui konfigurasi default perangkat lebih lanjut di Mengelola fitur tingkat fleet.
Mengaktifkan Cloud Service Mesh terkelola sebagai konfigurasi default untuk fleet Anda dan mendaftarkan cluster ke fleet selama pembuatan cluster hanya mendukung Mesh CA. Jika Anda ingin menggunakan Certificate Authority Service, sebaiknya aktifkan per cluster.
Guna mengaktifkan setelan default tingkat fleet untuk Cloud Service Mesh terkelola, selesaikan langkah-langkah berikut:
Konsol
gcloud
Untuk mengonfigurasi setelan default tingkat fleet menggunakan Google Cloud CLI, Anda harus menetapkan setelan berikut:
Lanjutkan untuk Memverifikasi bahwa bidang kontrol telah disediakan.
Konfigurasi per cluster
Gunakan langkah-langkah berikut untuk mengonfigurasi Cloud Service Mesh terkelola untuk setiap cluster di mesh Anda satu per satu.
Mengaktifkan fitur fleet Cloud Service Mesh
Mengaktifkan Cloud Service Mesh pada project fleet. Perhatikan bahwa jika Anda berencana untuk mendaftarkan beberapa cluster, pengaktifan Cloud Service Mesh akan terjadi di tingkat fleet, sehingga Anda hanya perlu menjalankan perintah ini satu kali.
gcloud container fleet mesh enable --project FLEET_PROJECT_ID
Mendaftarkan cluster ke fleet
Mengonfigurasi Certificate Authority Service (Opsional)
Jika deployment mesh layanan Anda memerlukan Certificate Authority Service (CA Service), ikuti Mengonfigurasi Certificate Authority Service untuk Cloud Service Mesh terkelola guna mengaktifkannya untuk fleet Anda. Pastikan untuk menyelesaikan semua langkah sebelum melanjutkan ke bagian berikutnya.
Aktifkan pengelolaan otomatis
Jalankan perintah berikut untuk mengaktifkan pengelolaan otomatis:
gcloud container fleet mesh update \
--management automatic \
--memberships MEMBERSHIP_NAME \
--project FLEET_PROJECT_ID \
--location MEMBERSHIP_LOCATION
dengan:
Memverifikasi bahwa bidang kontrol telah disediakan
Setelah beberapa menit, verifikasi bahwa status bidang kontrol adalah ACTIVE
:
gcloud container fleet mesh describe --project FLEET_PROJECT_ID
Outputnya mirip dengan:
...
membershipSpecs:
projects/746296320118/locations/us-central1/memberships/demo-cluster-1:
mesh:
management: MANAGEMENT_AUTOMATIC
membershipStates:
projects/746296320118/locations/us-central1/memberships/demo-cluster-1:
servicemesh:
controlPlaneManagement:
details:
- code: REVISION_READY
details: 'Ready: asm-managed'
state: ACTIVE
implementation: ISTIOD | TRAFFIC_DIRECTOR
dataPlaneManagement:
details:
- code: OK
details: Service is running.
state: ACTIVE
state:
code: OK
description: 'Revision(s) ready for use: asm-managed.'
...
Catat bidang kontrol yang ditampilkan di kolom implementation
, baik
ISTIOD
maupun TRAFFIC_DIRECTOR
. Lihat
Fitur yang didukung Cloud Service Mesh
untuk mengetahui perbedaan bidang kontrol dan konfigurasi yang didukung, serta cara
implementasi bidang kontrol dipilih.
Konfigurasi kubectl
agar mengarah ke cluster
Bagian berikut ini melibatkan pengoperasian perintah kubectl
pada setiap
cluster Anda. Sebelum melanjutkan ke bagian berikut, jalankan perintah berikut untuk setiap cluster Anda guna mengonfigurasi kubectl
agar mengarah ke cluster.
gcloud container clusters get-credentials CLUSTER_NAME \
--location CLUSTER_LOCATION \
--project CLUSTER_PROJECT_ID
Perlu diperhatikan bahwa gateway masuk tidak otomatis di-deploy dengan bidang kontrol. Dengan memisahkan deployment gateway masuk dan bidang kontrol, Anda dapat mengelola gateway di lingkungan produksi dengan lebih mudah. Jika cluster memerlukan gateway masuk atau gateway keluar, lihat Men-deploy gateway. Untuk mengaktifkan fitur opsional lainnya, lihat Mengaktifkan fitur opsional di Cloud Service Mesh.
Bidang data terkelola
Jika Anda menggunakan Cloud Service Mesh terkelola, Google akan sepenuhnya mengelola upgrade proxy Anda, kecuali jika Anda menonaktifkannya.
Dengan bidang data terkelola, proxy file bantuan dan gateway yang dimasukkan akan otomatis diupdate bersama bidang kontrol terkelola dengan memulai ulang workload untuk memasukkan ulang versi baru proxy. Proses ini biasanya selesai 1-2 minggu setelah bidang kontrol terkelola diupgrade.
Jika dinonaktifkan, pengelolaan proxy didorong oleh siklus proses alami dari pod di cluster dan harus dipicu secara manual oleh pengguna untuk mengontrol kecepatan update.
Bidang data terkelola mengupgrade proxy dengan mengeluarkan pod yang menjalankan versi proxy sebelumnya. Penghapusan dilakukan secara bertahap, sesuai dengan anggaran gangguan pod dan pengendalian tingkat perubahan.
Bidang data terkelola tidak mengelola hal berikut:
Menonaktifkan bidang data terkelola (opsional)
Jika menyediakan Cloud Service Mesh terkelola pada cluster baru, Anda dapat menonaktifkan bidang data terkelola sepenuhnya, atau untuk namespace atau pod individual. Bidang data terkelola akan terus dinonaktifkan untuk cluster yang ada, yang dinonaktifkan secara default atau manual.
Untuk menonaktifkan bidang data terkelola di tingkat cluster dan kembali ke pengelolaan proxy file bantuan sendiri, ubah anotasi:
kubectl annotate --overwrite controlplanerevision -n istio-system \
mesh.cloud.google.com/proxy='{"managed":"false"}'
Cara menonaktifkan bidang data terkelola untuk namespace:
kubectl annotate --overwrite namespace NAMESPACE \
mesh.cloud.google.com/proxy='{"managed":"false"}'
Untuk menonaktifkan bidang data terkelola untuk pod:
kubectl annotate --overwrite pod POD_NAME \
mesh.cloud.google.com/proxy='{"managed":"false"}'
Aktifkan notifikasi pemeliharaan
Anda dapat meminta untuk diberi tahu tentang pemeliharaan bidang data terkelola yang akan datang hingga seminggu sebelum pemeliharaan dijadwalkan. Notifikasi pemeliharaan tidak dikirim secara default. Anda juga harus Mengonfigurasi masa pemeliharaan GKE sebelum dapat menerima notifikasi. Jika diaktifkan, notifikasi akan dikirim setidaknya dua hari sebelum operasi upgrade.
Untuk memilih ikut serta dalam notifikasi pemeliharaan bidang data terkelola:
Setiap pengguna yang ingin menerima notifikasi harus memilih ikut serta secara terpisah. Jika Anda ingin menetapkan filter email untuk notifikasi ini, baris subjeknya adalah:
Upcoming upgrade for your Cloud Service Mesh cluster "CLUSTER_LOCATION/CLUSTER_NAME"
.
Contoh berikut menunjukkan notifikasi pemeliharaan bidang data terkelola yang umum:
Subject Line: Upgrade mendatang untuk cluster Cloud Service Mesh Anda "
<location/cluster-name>
"Pengguna Cloud Service Mesh yang terhormat,
Komponen Cloud Service Mesh dalam cluster Anda ${instance_id} (https://console.cloud.google.com/kubernetes/clusters/details/${instance_id}/details?project=${project_id}) dijadwalkan untuk diupgrade pada ${scheduled_date_human_readable} pada ${scheduled_time_human_readable}.
Anda dapat memeriksa catatan rilis (https://cloud.google.com/service-mesh/docs/release-notes) untuk mempelajari update baru ini.
Jika pemeliharaan ini dibatalkan, Anda akan menerima email baru.
Terima kasih,
Tim Cloud Service Mesh
(c) 2023 Google LLC 1600 Amphitheater Parkway, Mountain View, CA 94043 Kami mengirimkan pengumuman ini untuk menginformasikan perubahan penting pada Google Cloud Platform atau akun Anda. Anda dapat memilih untuk tidak menerima notifikasi masa pemeliharaan dengan mengedit preferensi pengguna: https://console.cloud.google.com/user-preferences/communication?project=${project_id}
Mengonfigurasi penemuan endpoint (hanya untuk penginstalan multi-cluster)
Jika mesh Anda hanya memiliki satu cluster, lewati langkah multi-cluster ini dan lanjutkan ke Men-deploy aplikasi atau Memigrasikan aplikasi.
Sebelum melanjutkan, pastikan bahwa Cloud Service Mesh dikonfigurasi pada setiap cluster.
Mengaktifkan Cloud Service Mesh dengan fleet API akan mengaktifkan penemuan endpoint untuk cluster ini. Namun, Anda harus membuka port firewall. Guna menonaktifkan penemuan endpoint untuk satu atau beberapa cluster, lihat petunjuk untuk menonaktifkannya di Penemuan endpoint di antara cluster dengan API deklaratif.
Untuk aplikasi contoh dengan dua cluster, lihat contoh layanan HelloWorld.
Men-deploy aplikasi
Jika Anda memiliki lebih dari satu cluster dalam fleet yang menggunakan Cloud Service Mesh terkelola, pastikan port penemuan endpoint atau firewall dikonfigurasi sebagaimana mestinya sebelum melanjutkan dan men-deploy aplikasi.Mengaktifkan namespace untuk injeksi. Langkah-langkah bergantung pada penerapan bidang kontrol Anda.
Terkelola (TD)
kubectl label namespace NAMESPACE
istio.io/rev- istio-injection=enabled --overwrite
Terkelola (Istiod)
Direkomendasikan: Jalankan perintah berikut untuk menerapkan label injeksi default ke namespace:
kubectl label namespace NAMESPACE \
istio.io/rev- istio-injection=enabled --overwrite
Jika Anda adalah pengguna lama dengan bidang kontrol Istio yang Terkelola: Sebaiknya gunakan injeksi default, tetapi injeksi berbasis revisi didukung. Gunakan petunjuk berikut:
Pada tahap ini, Anda telah berhasil mengonfigurasi Cloud Service Mesh terkelola. Jika Anda sudah memiliki workload di namespace berlabel, mulai ulang workload tersebut agar proxy dapat dimasukkan.
Jika Anda men-deploy aplikasi di penyiapan multi-cluster, replikasikan konfigurasi bidang kontrol dan Kubernetes di semua cluster, kecuali Anda berencana membatasi konfigurasi tersebut ke subset cluster. Konfigurasi yang diterapkan ke cluster tertentu adalah sumber tepercaya untuk cluster tersebut.
Sesuaikan injeksi (opsional)
Anda dapat mengganti nilai default dan menyesuaikan setelan injeksi, tetapi hal ini dapat menyebabkan error konfigurasi yang tidak terduga dan mengakibatkan masalah pada penampung file bantuan. Sebelum menyesuaikan injeksi, baca informasi setelah contoh untuk catatan tentang setelan dan rekomendasi tertentu.
Konfigurasi per pod tersedia untuk mengganti opsi ini di tiap pod.
Hal ini dilakukan dengan menambahkan container istio-proxy
ke pod Anda. Injeksi file bantuan
akan memperlakukan konfigurasi apa pun yang ditentukan di sini sebagai penggantian terhadap
template injeksi default.
Misalnya, konfigurasi berikut menyesuaikan berbagai setelan,
termasuk menurunkan permintaan CPU, menambahkan pemasangan volume, dan menambahkan
hook preStop
:
apiVersion: v1
kind: Pod
metadata:
name: example
spec:
containers:
- name: hello
image: alpine
- name: istio-proxy
image: auto
resources:
requests:
cpu: "200m"
memory: "256Mi"
limits:
cpu: "200m"
memory: "256Mi"
volumeMounts:
- mountPath: /etc/certs
name: certs
lifecycle:
preStop:
exec:
command: ["sleep", "10"]
volumes:
- name: certs
secret:
secretName: istio-certs
Secara umum, kolom apa pun dalam pod dapat ditetapkan. Namun, kolom tertentu harus diperhatikan:
Selain itu, kolom tertentu dapat dikonfigurasi oleh anotasi di Pod, meskipun sebaiknya gunakan pendekatan di atas untuk menyesuaikan setelan. Berikan perhatian tambahan untuk anotasi berikut:
Misalnya, lihat anotasi resource di bawah:
spec:
template:
metadata:
annotations:
sidecar.istio.io/proxyCPU: "200m"
sidecar.istio.io/proxyCPULimit: "200m"
sidecar.istio.io/proxyMemory: "256Mi"
sidecar.istio.io/proxyMemoryLimit: "256Mi"
Memigrasikan aplikasi ke Mesh Layanan Cloud terkelola
Untuk memigrasikan aplikasi dari Cloud Service Mesh dalam cluster ke Cloud Service Mesh terkelola, lakukan langkah-langkah berikut:
Terkelola (TD)
kubectl label namespace NAMESPACE
istio.io/rev- istio-injection=enabled --overwrite
Terkelola (Istiod)
Direkomendasikan: Jalankan perintah berikut untuk menerapkan label injeksi default ke namespace:
kubectl label namespace NAMESPACE \
istio.io/rev- istio-injection=enabled --overwrite
Jika Anda adalah pengguna lama dengan bidang kontrol Istio yang Terkelola: Sebaiknya gunakan injeksi default, tetapi injeksi berbasis revisi didukung. Gunakan petunjuk berikut:
Jika puas dengan aplikasi Anda bekerja sesuai harapan, Anda dapat menghapus istiod
dalam cluster setelah mengalihkan semua namespace ke bidang kontrol terkelola, atau menyimpannya sebagai cadangan - istiod
akan otomatis memperkecil skala untuk menggunakan lebih sedikit resource. Untuk menghapus, lanjutkan ke
Menghapus bidang kontrol lama.
Jika mengalami masalah, Anda dapat mengidentifikasi dan menyelesaikannya menggunakan informasi di Menyelesaikan masalah bidang kontrol terkelola dan jika perlu, melakukan roll back ke versi sebelumnya.
Hapus bidang kontrol lama
Setelah menginstal dan mengonfirmasi bahwa semua namespace menggunakan bidang kontrol yang dikelola Google, Anda dapat menghapus bidang kontrol lama.
kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod -n istio-system --ignore-not-found=true
Jika Anda menggunakan istioctl kube-inject
, bukan injeksi otomatis, atau jika
menginstal gateway tambahan, periksa metrik untuk bidang kontrol,
dan verifikasi bahwa jumlah endpoint yang terhubung adalah nol.
Roll back
Lakukan langkah-langkah berikut jika Anda perlu melakukan roll back ke versi bidang kontrol sebelumnya:
Bidang kontrol terkelola akan otomatis diskalakan ke nol dan tidak menggunakan resource apa pun jika tidak digunakan. Webhook dan penyediaan yang bermutasi akan tetap ada dan tidak memengaruhi perilaku cluster.
Gateway sekarang disetel ke revisi asm-managed
. Untuk melakukan roll back, jalankan kembali perintah
instal Cloud Service Mesh, yang akan men-deploy ulang gateway yang mengarah kembali
ke bidang kontrol dalam cluster Anda:
kubectl -n istio-system rollout undo deploy istio-ingressgateway
Output yang akan dihasilkan saat berhasil:
deployment.apps/istio-ingressgateway rolled back
Meng-uninstal Cloud Service Mesh
Bidang kontrol terkelola menskalakan otomatis hingga nol saat tidak ada namespace yang menggunakannya. Untuk mengetahui langkah-langkah mendetail, lihat Meng-uninstal Cloud Service Mesh.