Otomatisasi Lifecycle ASM dengan servicemesh-operator - Container Service for Kubernetes

Komponen servicemesh-operator menyederhanakan penerapan, peningkatan, dan pengelolaan konfigurasi Alibaba Cloud Service Mesh (ASM) di kluster ACK, memungkinkan Anda segera mengaktifkan fitur-fitur canggih ASM seperti manajemen traffic, keamanan, dan observabilitas.

Lingkup

Versi kluster ACK Anda harus 1.28 atau lebih baru.
Anda telah mengaktifkan ASM.

Penggunaan

Setelah menginstal komponen servicemesh-operator di kluster ACK Anda, sistem secara otomatis melakukan langkah-langkah berikut:

Men-deploy controller bernama servicemesh-operator di lapisan kontrol kluster. Controller ini mendengarkan dan memproses resource kustom ServiceMesh.
Membuat CustomResourceDefinition (CRD): servicemesh.istio.alibabacloud.com.
Secara otomatis membuat resource kustom ServiceMesh (CR) bernama mesh.

Controller servicemesh-operator membuat instans ASM Edisi Standar bernama mesh-for-${cluster ID} dan menambahkan kluster ACK ke instans tersebut setelah pembuatan.

Kueri resource kustom ServiceMesh untuk memantau progres pembuatan instans ASM dan status terkini secara real time.

Konsol

Pada halaman ACK Clusters , klik nama kluster Anda. Pada halaman detail kluster, di panel navigasi sebelah kiri, klik Workloads > Custom Resources.

Pada halaman Custom Resources, cari ServiceMesh. Di daftar di bawahnya, klik nama ServiceMesh di bawah istio.alibabacloud.com. Lalu klik Actions dan pilih Edit YAML.

Contoh YAML:

apiVersion: istio.alibabacloud.com/v1beta1
kind: ServiceMesh
metadata:
  annotations:
    operator.istio.alibabacloud.com/deletion-policy: Retain
  creationTimestamp: "2026-01-09T02:25:12Z"
  finalizers:
  - servicemeshoperator.finalizers.alibabacloud.com
  generation: 2
  name: asm
  resourceVersion: "36619976"
  uid: 94967e01-fc25-477e-9da9-4df42cede8ba
spec:
  clusterSpec: Enterprise
status:
  clusterSpec: Enterprise
  conditions:
  - lastTransitionTime: "2026-01-09T02:25:19Z"
    message: ""
    observedGeneration: 2
    reason: Passed
    status: "True"
    type: PreChecked
  - lastTransitionTime: "2026-01-09T02:25:32Z"
    message: ""
    observedGeneration: 2
    reason: Available
    status: "True"
    type: ServiceMeshAvailable
  - lastTransitionTime: "2026-01-09T02:25:32Z"
    message: ""
    observedGeneration: 2
    reason: Succeeded
    status: "True"
    type: ClusterEnrolled
  - lastTransitionTime: "2026-01-09T02:25:38Z"
    message: ""
    observedGeneration: 2
    reason: Succeeded
    status: "True"
    type: MeshConfigApplied
  serviceMeshId: c6490deb776cc458c82c4c22a69315bae
  serviceMeshName: mesh-for-cf17b23e9fa6b4fb081c58a33964cd3dc

kubectl

Dapatkan KubeConfig kluster dan hubungkan ke kluster menggunakan kubectl.

Lihat YAML resource kustom ServiceMesh.

kubectl get servicemesh mesh -n istio-system -o yaml

Output yang diharapkan:

apiVersion: istio.alibabacloud.com/v1beta1
kind: ServiceMesh
metadata:
  annotations:
    operator.istio.alibabacloud.com/deletion-policy: Retain
  creationTimestamp: "2026-01-09T02:25:12Z"
  finalizers:
  - servicemeshoperator.finalizers.alibabacloud.com
  generation: 2
  name: asm
  resourceVersion: "36619976"
  uid: 94967e01-fc25-477e-9da9-4df42cede8ba
spec:
  clusterSpec: Enterprise
status:
  clusterSpec: Enterprise
  conditions:
  - lastTransitionTime: "2026-01-09T02:25:19Z"
    message: ""
    observedGeneration: 2
    reason: Passed
    status: "True"
    type: PreChecked
  - lastTransitionTime: "2026-01-09T02:25:32Z"
    message: ""
    observedGeneration: 2
    reason: Available
    status: "True"
    type: ServiceMeshAvailable
  - lastTransitionTime: "2026-01-09T02:25:32Z"
    message: ""
    observedGeneration: 2
    reason: Succeeded
    status: "True"
    type: ClusterEnrolled
  - lastTransitionTime: "2026-01-09T02:25:38Z"
    message: ""
    observedGeneration: 2
    reason: Succeeded
    status: "True"
    type: MeshConfigApplied
  serviceMeshId: c6490deb776cc458c82c4c22a69315bae
  serviceMeshName: mesh-for-cf17b23e9fa6b4fb081c58a33964cd3dc

Kuota dan batasan

Versi servicemesh-operator saat ini hanya mendukung pengikatan satu-ke-satu antara instans ASM dan kluster ACK. Untuk memperbarui instans ASM, buka Konsol ASM.
Menghapus resource ServiceMesh akan menghapus kluster ACK dari ASM. Jika kluster ACK menggunakan resource ASM seperti gateway atau Sidecar proxy, penghapusan akan gagal. Periksa status terkini di bidang Status resource ServiceMesh.
Jika resource ServiceMesh mencakup anotasi operator.istio.alibabacloud.com/deletion-policy: Delete, menghapus kluster ACK juga akan menghapus instans ASM. Jika tidak, instans ASM akan dipertahankan.
Komponen ini secara default membuat instans ASM Edisi Standar. Edisi Standar gratis tetapi tidak memiliki Service-Level Agreement (SLA). Edisi ini mendukung hingga 50 Pod dan hanya tersedia di wilayah Tiongkok daratan. Pembuatan instans Edisi Standar di wilayah lain akan gagal. Untuk membuat atau meningkatkan ke edisi berbeda, atur .spec.clusterSpec pada resource ServiceMesh menjadi Enterprise atau Ultimate. Untuk informasi selengkapnya tentang edisi dan penagihan, lihat Ikhtisar penagihan.

Referensi CRD ServiceMesh

Resource ServiceMesh mendefinisikan status yang diinginkan dan aktual dari service mesh ASM di kluster Kubernetes. Beberapa bidang dalam Spec dapat diubah, dan perubahan tersebut akan memicu pembaruan properti mesh yang sesuai.

Spec (.spec)

Bidang	Tipe	Deskripsi	Default	Wajib	Dapat Diubah
`id`	string	ID service mesh. Jika tidak ditentukan, sistem akan menghasilkan ID acak. Anda dapat menentukan ID ini untuk membuat service mesh baru atau menambahkan kluster saat ini ke mesh yang sudah ada. Bidang ini memiliki prioritas lebih tinggi dibandingkan bidang name.	N/A	Tidak	Tidak
`name`	string	Nama service mesh. Jika tidak ditentukan, sistem akan menghasilkan nama dalam format `mesh-for-${cluster ID}`. Anda dapat menentukan nama ini untuk membuat service mesh baru atau menambahkan kluster saat ini ke mesh yang sudah ada.	N/A	Tidak	Ya
`clusterSpec`	string	Edisi awal instans service mesh yang dibuat. Ini menentukan fitur dan tingkat kinerja instans mesh. Nilai yang valid adalah: Standard Enterprise Edition. Ultimate	Standard di wilayah Tiongkok daratan Enterprise di wilayah lain	Tidak	Ya

Status (.status)

Bidang	Tipe	Deskripsi
`serviceMeshName`	string	Nama unik service mesh aktual yang dibuat oleh controller. Bidang ini dicatat sebelum permintaan pembuatan pertama dikirim dan tetap tidak berubah selama rekonsiliasi untuk mencegah duplikasi instans service mesh.
`serviceMeshId`	string	ID service mesh yang berhasil dibuat. Nilai ini diambil dari cloud setelah instans service mesh dibuat.
`clusterSpec`	string	Spesifikasi instans Service Mesh yang dibuat.
`conditions`	[]ServiceMeshCondition	Daftar kondisi dan statusnya yang dilalui service mesh selama proses rekonsiliasi. Ini mencatat langkah-langkah utama mulai dari pembuatan resource hingga siap digunakan.

ServiceMeshCondition

Bidang	Tipe	Deskripsi
`lastTransitionTime`	metav1.Time	Timestamp saat status kondisi terakhir berubah.
`status`	string	Status kondisi saat ini. Nilai yang valid adalah: True (kondisi terpenuhi) False (kondisi tidak terpenuhi) Unknown (status tidak diketahui)
`type`	string	Tipe kondisi, merepresentasikan langkah rekonsiliasi tertentu. Contohnya meliputi: PreChecked (pemeriksaan awal selesai) ServiceMeshAvailable (service mesh tersedia) ClusterEnrolled (kluster terdaftar) MeshConfigApplied (konfigurasi mesh diterapkan) Retried (status percobaan ulang) ServiceMeshDeleted (service mesh dihapus)
`message`	string	Pesan deskriptif tentang status kondisi. Ini memberikan konteks tambahan saat terjadi error atau kondisi tertentu.
`reason`	string	Alasan status kondisi. Contohnya meliputi: Reconciling (memperbarui) Succeeded (berhasil) Failed (gagal) Available (tersedia) Unavailable (tidak tersedia) Passed (lolos) WaitSteady (menunggu pembaruan mesh selesai) Retried (dicoba ulang)

Anotasi khusus

Resource ServiceMesh mendukung anotasi khusus untuk konfigurasi. Anotasi yang didukung saat ini meliputi:

Retry

Gunakan anotasi operator.istio.alibabacloud.com/retry-at untuk memicu percobaan ulang proses rekonsiliasi. Saat terjadi error selama rekonsiliasi, atur anotasi ini untuk mencoba ulang operasi tersebut.

kubectl annotate servicemesh mesh operator.istio.alibabacloud.com/retry-at=""

Setelah menjalankan perintah ini, sistem secara otomatis mencoba ulang operasi tersebut.

Kebijakan penghapusan

Gunakan anotasi operator.istio.alibabacloud.com/deletion-policy untuk mengonfigurasi kebijakan penghapusan:

Retain (default): Mempertahankan instans ASM di Alibaba Cloud saat resource ServiceMesh dihapus.
Delete: Menghapus instans ASM dari Alibaba Cloud saat resource ServiceMesh dihapus.

apiVersion: istio.alibabacloud.com/v1beta1
kind: ServiceMesh
metadata:
  name: advanced-mesh
  annotations:
    operator.istio.alibabacloud.com/deletion-policy: Delete  # atau Retain
spec:
  name: advanced-service-mesh
  clusterSpec: Ultimate