Hubungkan aplikasi ACK ke pusat tata kelola MSE - Microservices Engine

Anda dapat menghubungkan aplikasi layanan mikro Spring Cloud dan Dubbo yang berjalan di Container Service for Kubernetes dan Container Compute Service ke pusat tata kelola MSE. Dengan MSE, Anda dapat memanfaatkan berbagai kemampuan tata kelola layanan untuk meningkatkan stabilitas layanan mikro online dan efisiensi pengembangan. Topik ini menjelaskan cara menghubungkan aplikasi layanan mikro dari ACK dan ACS ke pusat tata kelola MSE.

Prasyarat

Anda telah membuat managed cluster atau ACK Serverless cluster.
Anda telah mengaktifkan tata kelola layanan mikro MSE.
Kluster ACK atau ACS dan pusat tata kelola MSE berada di wilayah yang sama.

Penting

Jika proyek Anda menggunakan komponen open-source Sentinel bersama dengan com.alibaba.cloud.sentinel.feign.SentinelFeignAutoConfiguration, koneksi ke pusat tata kelola MSE akan gagal.
Memori heap JVM harus lebih besar dari 256 MB saat menyambungkan agen Java MSE.
Pastikan kluster ACK memiliki izin yang diperlukan untuk mengakses sumber daya MSE.

Secara default, kluster ACK managed sudah menyertakan token ini. Namun, beberapa kluster lama mungkin tidak memilikinya, sehingga disarankan untuk memverifikasi keberadaan token tersebut.

Ikuti langkah-langkah berikut untuk memeriksa ARMS Addon Token di kluster ACK managed:
1. Login ke Konsol Container Service for Kubernetes. Pada halaman Clusters, klik nama kluster target.
2. Di panel navigasi sebelah kiri, pilih Configuration Management > Secrets. Dari daftar drop-down Namespaces, pilih kube-system dan periksa apakah addon.arms.token tersedia. Jika tidak ada, Anda harus memberikan izin secara manual.
Jika Anda menggunakan RAM user untuk proses ini, lihat Izin untuk RAM user.

Prosedur

Catatan

Rekomendasi pemilihan metode koneksi:

Jika Anda perlu menghubungkan semua atau sebagian besar aplikasi dalam suatu namespace ke pusat tata kelola MSE, kami menyarankan mengikuti Skenario 1: Aktifkan tata kelola untuk namespace. Untuk aplikasi yang tidak perlu dihubungkan, tambahkan label berikut ke file YAML-nya: spec.template.labels.msePilotAutoEnable: "off".
Jika Anda hanya perlu menghubungkan beberapa aplikasi dalam suatu namespace ke pusat tata kelola MSE, kami menyarankan mengikuti Skenario 2: Aktifkan tata kelola untuk satu aplikasi.

Skenario 1: Aktifkan tata kelola untuk namespace

Setelah Anda mengaktifkan tata kelola layanan mikro MSE untuk suatu namespace, MSE secara otomatis menghubungkan Pod dari semua aplikasi yang baru dibuat dan diterapkan ulang di namespace tersebut ke pusat tata kelola. Anda tidak perlu menghubungkannya satu per satu. Untuk informasi lebih lanjut tentang cara membuat aplikasi, lihat Buat workload tanpa status Deployment.

Login ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.
Di panel navigasi sebelah kiri, pilih Microservices Governance > Application Governance.
Pada halaman Application list, klik ACK Application Access.

Pada dialog ACK Application Access, konfigurasikan parameter dan klik OK.

Atur Onboarding Type menjadi Namespace atau Single Application. Dari daftar drop-down Container Cluster Namespace, pilih namespace target, misalnya default. Di bidang Governance Namespace, masukkan nama untuk namespace yang sesuai.

Parameter	Deskripsi
Cluster type	Pilih ACK Cluster, ACK Serverless Cluster, atau ACS Cluster. Catatan Jika Anda belum memberikan otorisasi Container Service for Kubernetes untuk memanggil MSE, klik Authorize Now untuk memberikan izin yang diperlukan.
Cluster Name/ID	Pilih Cluster Name/ID dari kluster yang ingin Anda hubungkan ke pusat tata kelola MSE. Anda dapat mencari kluster berdasarkan kata kunci.
ack-onepilot	Menampilkan status komponen ack-onepilot. Untuk informasi selengkapnya tentang komponen ini dan cara melakukan upgrade, lihat komponen ack-onepilot dan Instal dan upgrade komponen tata kelola layanan mikro MSE. Jika ack-onepilot belum diinstal, sistem akan secara otomatis memulai instalasi setelah Anda memilih kluster dan menampilkan pesan "The installation process takes about 1 minute. Wait for a while." Jika Anda menggunakan RAM user dan menerima error izin, login ke Konsol Container Service for Kubernetes. Buka kluster target, lalu di panel navigasi sebelah kiri, klik Add-ons. Temukan ack-onepilot dan klik Install. Jika ack-onepilot sudah diinstal, UI akan menampilkan versi yang terpasang, misalnya, `Installed 4.2.0`. Catatan Anda dapat melihat detail komponen ack-onepilot dengan login ke Konsol Container Service for Kubernetes, membuka kluster target, lalu memilih Operations > Add-ons. Setelah ack-onepilot diinstal, komponen ini secara otomatis menyuntikkan agen Java. Hal ini dapat meningkatkan waktu startup aplikasi hingga 10 detik. Saat menghubungkan berdasarkan namespace, jika kluster target Anda tidak berada di salah satu wilayah yang tercantum, pastikan kluster tersebut memiliki akses jaringan publik dan dapat terhubung ke acm.aliyun.com:8080: Tiongkok (Qingdao), Tiongkok (Hangzhou), Tiongkok (Beijing), Tiongkok (Shanghai), Shanghai Finance Cloud, Tiongkok (Shenzhen), Hong Kong (Tiongkok), Singapura, Jerman (Frankfurt), Australia (Sydney), AS (Silicon Valley), dan AS (Virginia).
Access Type	Pilih Namespace Access.
Cluster Namespace	Pilih Cluster Namespace.
Microservices Governance Namespace	Pilih Microservices Governance Namespace.

Informasi tambahan:

Setelah Anda menghubungkan aplikasi di kluster ACK atau ACS ke pusat tata kelola MSE, konsol akan menampilkan nama Deployment-nya secara default. Untuk menentukan nama aplikasi kustom, modifikasi konfigurasi YAML dari aplikasi yang diterapkan.

spec:
  template:
    metadata:
      labels:
        # Namespace tata kelola layanan mikro MSE untuk aplikasi Anda. Default-nya adalah 'default'.
        mseNamespace: default
        # Ganti dengan nama aplikasi yang diinginkan.
        msePilotCreateAppName: "your-deployment-name"

Untuk menonaktifkan tata kelola layanan mikro untuk aplikasi tertentu, tambahkan label msePilotAutoEnable ke konfigurasi YAML aplikasi dan atur nilainya menjadi off.
```
spec:
  template:
    metadata:
      labels:
        # Nilai "off" harus diapit tanda kutip tunggal atau ganda.
        msePilotAutoEnable: "off"
```

Skenario 2: Aktifkan tata kelola untuk satu aplikasi

Jika Anda hanya perlu menghubungkan beberapa aplikasi di namespace Anda ke pusat tata kelola MSE, Anda dapat menghubungkannya satu per satu.

Login ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.
Di panel navigasi sebelah kiri, pilih Microservices Governance > Application Governance.
Pada halaman Application list, klik ACK Application Access.

Pada dialog ACK Application Access, konfigurasikan parameter dan klik OK.

Atur Onboarding Type menjadi Single Application. Di bagian Edit Labels (YAML format), tambahkan label berikut di bawah spec.template.metadata.labels pada file YAML Deployment aplikasi: msePilotAutoEnable: "on" untuk mengaktifkan tata kelola layanan mikro, mseNamespace: default untuk menentukan namespace MSE, dan msePilotCreateAppName: "your-deployment-name" untuk mengatur nama aplikasi. Ganti your-deployment-name dengan nama Deployment yang sebenarnya.

Parameter	Deskripsi
Cluster type	Pilih ACK Cluster, ACK Serverless Cluster, atau ACS Cluster. Catatan Jika Anda belum memberikan otorisasi Container Service for Kubernetes untuk memanggil MSE, klik Authorize Now untuk memberikan izin yang diperlukan.
Cluster Name/ID	Pilih Cluster Name/ID dari kluster yang ingin Anda hubungkan ke pusat tata kelola MSE. Anda dapat mencari kluster berdasarkan kata kunci.
ack-onepilot	Menampilkan status komponen ack-onepilot. Untuk informasi selengkapnya tentang komponen ini dan cara melakukan upgrade, lihat komponen ack-onepilot dan Instal dan upgrade komponen tata kelola layanan mikro MSE. Jika ack-onepilot belum diinstal, sistem akan secara otomatis memulai instalasi setelah Anda memilih kluster dan menampilkan pesan "The installation process takes about 1 minute. Wait for a while." Jika Anda menggunakan RAM user dan menerima error izin, login ke Konsol Container Service for Kubernetes. Buka kluster target, lalu di panel navigasi sebelah kiri, klik Add-ons. Temukan ack-onepilot dan klik Install. Jika ack-onepilot sudah diinstal, UI akan menampilkan versi yang terpasang, misalnya, `Installed 4.2.0`. Catatan Anda dapat melihat detail komponen ack-onepilot dengan login ke Konsol Container Service for Kubernetes, membuka kluster target, lalu memilih Operations > Add-ons. Setelah ack-onepilot diinstal, komponen ini secara otomatis menyuntikkan agen Java. Hal ini dapat meningkatkan waktu startup aplikasi hingga 10 detik. Saat menghubungkan berdasarkan namespace, jika kluster target Anda tidak berada di salah satu wilayah yang tercantum, pastikan kluster tersebut memiliki akses jaringan publik dan dapat terhubung ke acm.aliyun.com:8080: Tiongkok (Qingdao), Tiongkok (Hangzhou), Tiongkok (Beijing), Tiongkok (Shanghai), Shanghai Finance Cloud, Tiongkok (Shenzhen), Hong Kong (Tiongkok), Singapura, Jerman (Frankfurt), Australia (Sydney), AS (Silicon Valley), dan AS (Virginia).
Access Type	Pilih Single Application Access.
Access Procedure	Ikuti langkah-langkah berikut. Step 1: Di Konsol Container Service for Kubernetes, buka halaman Workloads > Deployments kluster Anda dan alihkan ke namespace aplikasi Anda. Step 2: Temukan aplikasi target dan klik Edit YAML. Step 3: Edit bidang `labels` seperti pada contoh berikut dan klik Update. `spec: template: metadata: labels: # Atur ke "on" untuk mengaktifkan koneksi. Nilai harus diapit tanda kutip ganda. msePilotAutoEnable: "on" # Tentukan namespace tata kelola target. Jika namespace tidak ada, akan dibuat secara otomatis. mseNamespace: default # Tentukan nama aplikasi yang akan ditampilkan di MSE. Nilai harus diapit tanda kutip ganda. msePilotCreateAppName: "your-deployment-name"`

Verifikasi hasil

Setelah menyelesaikan langkah-langkah ini dan me-restart aplikasi Anda, tata kelola layanan mikro MSE menjadi aktif untuk aplikasi di Container Service for Kubernetes dan Container Compute Service.

Login ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.
Di panel navigasi sebelah kiri, pilih Microservices Governance > Application Governance.
Pilih namespace tata kelola layanan mikro target untuk melihat aplikasi yang terhubung.

Langkah selanjutnya

Setelah menghubungkan aplikasi ke pusat tata kelola MSE, Anda dapat menggunakan fitur seperti peluncuran kanari ujung ke ujung, mulai mulus dan shutdown, serta aturan pembatasan kecepatan trafik. Untuk informasi selengkapnya, lihat Mulai menggunakan tata kelola layanan dalam 15 menit (Java).