Cara mengelola gateway multi-kluster MSE - Container Service for Kubernetes

Topik ini menjelaskan cara mengaktifkan dan menonaktifkan gateway multi-kluster pada instans ACK One Fleet serta cara menambahkan kluster terkait ke gateway multi-kluster.

Penagihan

Anda dikenai biaya untuk menggunakan gateway multi-kluster. Untuk informasi lebih lanjut mengenai penagihan gateway multi-kluster, lihat Ikhtisar penagihan instans umum.

Prasyarat

Otorisasi gateway cloud-native Microservices Engine (MSE) telah selesai.

Kebijakan AliyunAdcpManagedMseRolePolicy telah dilampirkan ke peran Resource Access Management (RAM) AliyunAdcpManagedMseRole. Blok kode berikut menunjukkan isi kebijakan AliyunAdcpManagedMseRolePolicy.

Isi kebijakan AliyunAdcpManagedMseRolePolicy

{
    "Statement": [
        {
            "Action": [
                "mse:AddBlackWhiteList",
                "mse:AddGateway",
                "mse:AddServiceSource",
                "mse:CreateApplication",
                "mse:DeleteGateway",
                "mse:DeleteServiceSource",
                "mse:GetBlackWhiteList",
                "mse:GetGateway",
                "mse:GetGatewayDetail",
                "mse:GetGatewayOption",
                "mse:ListServiceSource",
                "mse:ListTagResources",
                "mse:ModifyLosslessRule",
                "mse:TagResources",
                "mse:UntagResources",
                "mse:UpdateBlackWhiteList",
                "mse:UpdateGatewayOption",
                "mse:UpdateServiceSource"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "log:CloseProductDataCollection",
                "log:OpenProductDataCollection",
                "log:GetProductDataCollection"
            ],
            "Resource": [
                "acs:mse:*:*:instance/*",
                "acs:log:*:*:project/*/logstore/mse_*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": "ram:CreateServiceLinkedRole",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "ram:ServiceName": [
                        "audit.log.aliyuncs.com"
                    ]
                }
            },
            "Effect": "Allow"
        }
    ],
    "Version": "1"
}

Fitur manajemen Fleet diaktifkan, dan file kubeconfig dari instans Fleet diperoleh dari Konsol ACK One serta klien kubectl telah terhubung ke instans Fleet.
Kluster terkait telah ditambahkan. Kluster terkait dan instans ACK One Fleet berada dalam VPC yang sama.
(Opsional) Versi terbaru Cloud Assistant CLI telah diinstal dan dikonfigurasi.

Aktifkan fitur gateway multi-kluster

Konsol

Masuk ke Konsol ACK One. Di panel navigasi sebelah kiri, pilih Fleet > Multi-cluster Gateway.
Pada halaman Multi-cluster Gateway, klik daftar tarik-turun Create Multi-cluster Gateway, lalu klik MSE Multi-cluster Gateway. Pada kotak dialog yang muncul, klik OK.

Baris perintah

Pastikan Cloud Assistant CLI telah diperbarui, lalu jalankan perintah berikut untuk mengaktifkan fitur gateway multi-kluster.
Ganti <YOUR_FLEET_CLUSTERID> dengan ID instans Fleet Anda.
```
aliyun adcp UpdateHubClusterFeature --ClusterId <YOUR_FLEET_CLUSTERID> --GatewayEnabled true
```
Jalankan perintah berikut untuk memeriksa apakah fitur gateway multi-kluster telah diaktifkan:
```
aliyun adcp DescribeHubClusterDetails --ClusterId <YOUR_FLEET_CLUSTERID> |grep -B4 -A1 EnabledMSE`
```
Keluaran yang diharapkan: Jika nilai parameter Status adalah True, berarti fitur gateway multi-kluster telah diaktifkan.
```
			{
				"Message": "",
				"Reason": "",
				"Status": "True",
				"Type": "EnabledMSE"
			},
```

Buat gateway multi-kluster

Konsol

Masuk ke Konsol ACK One. Di panel navigasi sebelah kiri, pilih Fleet > Multi-cluster Gateway.
Di pojok kanan atas halaman Multi-cluster Gateway, klik daftar tarik-turun Create Multi-cluster Gateway, lalu klik MSE Multi-cluster Gateway.
Pada panel yang muncul, sesuaikan file YAML yang digunakan untuk membuat gateway multi-kluster sesuai kebutuhan, lalu klik Create.

Baris perintah

Dapatkan dan catat ID virtual switch dari instans ACK One Fleet.
1. Jalankan perintah berikut untuk menanyakan ID vSwitch:
```
aliyun adcp DescribeHubClusterDetails --ClusterId <YOUR_FLEET_CLUSTERID>
```
1. Catat ID vSwitch pada bidang VSwitches dalam keluaran.

Buat file bernama mseingressconfig.yaml dan tambahkan konten berikut ke dalam file tersebut.

Ganti ${vsw-id1} dengan ID vSwitch yang telah Anda catat. Anda dapat menambahkan anotasi ke file konfigurasi gateway untuk menentukan kluster terkait yang ingin ditambahkan ke gateway.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: ackone-gateway
  # Sambungkan kluster terkait ke gateway MSE.
  #annotations:
  #  mse.alibabacloud.com/remote-clusters: ${cluster1},${cluster2}
spec:
  common:
    instance:
      replicas: 3
      spec: 2c4g
    network:
      # Anda dapat mengonfigurasi SLB yang menghadap internet dan Internal-facing SLB. Jika tidak ada instans SLB yang ditentukan, SLB yang menghadap internet akan digunakan secara default.
      #publicSLBSpec: slb.s2.small
      #privateSLBSpec: slb.s2.small
      vSwitches:
      - ${vsw-id1}
  ingress:
    local:
      ingressClass: mse
  name: mse-ingress

Jalankan perintah berikut untuk membuat gateway bernama mse-ingress pada instans ACK One Fleet:
```
kubectl apply -f mseingressconfig.yaml
```
Jalankan perintah berikut untuk memeriksa apakah gateway telah dibuat:
```
kubectl get mseingressconfig ackone-gateway
```
Keluaran yang diharapkan:
```
NAME             STATUS      AGE
ackone-gateway   Listening   3m15s
```
Keluaran tersebut menunjukkan bahwa gateway berada dalam status Listening. Artinya, gateway cloud-native telah dibuat dan berjalan. Gateway tersebut mendengarkan Ingress yang memiliki IngressClass mse.
Status gateway yang dibuat dari MseIngressConfig berubah dalam urutan berikut: Pending, Running, dan Listening. Deskripsi status:
- Pending: Gateway cloud-native sedang dibuat. Proses ini memerlukan waktu sekitar 3 menit.
- Running: Gateway cloud-native telah dibuat dan berjalan.
- Listening: Gateway cloud-native berjalan dan mendengarkan Ingress.
- Failed: Gateway cloud-native berada dalam kondisi tidak normal. Anda dapat memeriksa pesan di bidang Status untuk mengidentifikasi penyebabnya.

Tambahkan atau hapus kluster terkait

Konsol

Masuk ke Konsol ACK One. Di panel navigasi sebelah kiri, pilih Fleet > Multi-cluster Gateway.
Di bagian atas halaman Multi-cluster Gateway, pilih gateway multi-kluster yang ingin Anda kelola dari daftar tarik-turun, lalu klik Edit di pojok kanan atas.
Pada panel yang muncul, edit konten YAML. Ubah ID kluster pada parameter annotations dan klik Update.
Kode contoh:
```
annotations:
  mse.alibabacloud.com/remote-clusters: ${cluster1-id},${cluster2-id}
```
- ${cluster1-id} dan ${cluster2-id} adalah ID kluster terkait. Pisahkan beberapa ID kluster dengan koma (,). Anda dapat mengubah ID kluster untuk menambahkan atau menghapus kluster terkait.
- Jika Anda tidak mengaitkan kluster apa pun saat membuat gateway multi-kluster, konten YAML tidak mencakup parameter annotations. Oleh karena itu, untuk menambahkan kluster terkait, Anda harus menambahkan contoh di atas ke objek metadata dalam konten YAML, lalu tambahkan atau ubah ID kluster.

Baris perintah

Anda dapat mengubah anotasi yang sesuai dalam objek mseingressconfig pada instans ACK One Fleet untuk menambahkan atau menghapus kluster terkait. Ganti ${cluster1-id} dan ${cluster2-id} dengan ID kluster terkait. Pisahkan beberapa ID kluster dengan koma (,).
```
annotations:
  mse.alibabacloud.com/remote-clusters: ${cluster1-id},${cluster2-id}
```
Jika Anda tidak mengaitkan kluster apa pun saat membuat gateway multi-kluster, konten YAML tidak mencakup parameter annotations. Oleh karena itu, untuk menambahkan kluster terkait, Anda harus menambahkan contoh di atas ke objek metadata dalam konten YAML, lalu tambahkan atau ubah ID kluster.
Jalankan perintah berikut untuk memeriksa apakah kluster terkait telah ditambahkan ke gateway multi-kluster:
```
kubectl get mseingressconfig ackone-gateway -ojsonpath="{.status.remoteClusters}"
```
Keluaran yang diharapkan:
```
[{"clusterId":"c7fb82****"},{"clusterId":"cd3007****"}]
```
Keluaran tersebut menunjukkan ID kluster terkait dan tidak ada pesan kegagalan yang dikembalikan. Artinya, kluster terkait telah berhasil ditambahkan ke gateway multi-kluster.
Jalankan perintah berikut untuk menanyakan kluster terkait yang telah ditambahkan ke gateway multi-kluster:
```
kubectl get mseingressconfig ackone-gateway
```
Jalankan perintah berikut untuk menambahkan atau menghapus kluster terkait.
mse.alibabacloud.com/remote-clusters=${cluster1},${cluster2} menunjukkan kluster terkait yang ingin Anda tambahkan ke gateway multi-kluster.
```
kubectl annotate mseingressconfig ackone-gateway mse.alibabacloud.com/remote-clusters=${cluster1},${cluster2} --overwrite=true
```

Nonaktifkan fitur gateway multi-kluster

Penting

Menghapus gateway multi-kluster dapat berdampak buruk pada bisnis Anda. Lakukan dengan hati-hati.
Jika Anda tidak lagi memerlukan gateway multi-kluster, Anda dapat menghapus gateway tersebut lalu menonaktifkan fitur gateway multi-kluster untuk menghindari pemborosan sumber daya.

Konsol

Masuk ke Konsol ACK One. Di panel navigasi sebelah kiri, pilih Fleet > Multi-cluster Gateway.
Pada halaman Multi-cluster Gateway, pilih MSE dari daftar tarik-turun Gateway Type, pilih gateway multi-kluster yang ingin Anda hapus dari daftar tarik-turun Select Gateway Instance, lalu klik Delete di pojok kanan atas.
Pada kotak dialog yang muncul, masukkan nama gateway multi-kluster yang ingin Anda hapus, lalu klik Delete.
Pastikan semua gateway multi-kluster dalam instans ACK One Fleet telah dihapus, lalu klik Disable MSE Gateway di pojok kanan atas halaman. Pada pesan yang muncul, klik OK.

Baris perintah

Jalankan perintah berikut untuk menghapus gateway multi-kluster:
```
kubectl delete mseingressconfig ackone-gateway
```

Jalankan perintah berikut untuk menonaktifkan fitur gateway multi-kluster:

aliyun adcp UpdateHubClusterFeature --ClusterId <YOUR_FLEET_CLUSTERID> --GatewayEnabled false