Comment gérer les passerelles multi-clusters MSE - Container Service for Kubernetes

Cette rubrique explique comment activer et désactiver les passerelles multi-clusters sur une instance ACK One Fleet, et comment ajouter des clusters associés à une passerelle multi-cluster.

Facturation

L'utilisation des passerelles multi-clusters est facturée. Pour plus d'informations sur la facturation, consultez la section Facturation des instances à usage général.

Prérequis

L'autorisation de la passerelle cloud-native Microservices Engine (MSE) est effectuée.

La stratégie AliyunAdcpManagedMseRolePolicy est attachée au rôle Resource Access Management (RAM) AliyunAdcpManagedMseRole. Le bloc de code suivant présente le document de stratégie de AliyunAdcpManagedMseRolePolicy.

Document de stratégie de 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"
}

La fonctionnalité de gestion Fleet est activée, vous avez obtenu le fichier kubeconfig de l'instance Fleet depuis la console ACK One et un client kubectl est connecté à l'instance Fleet.
Des clusters associés ont été ajoutés. Les clusters associés et l'instance ACK One Fleet sont déployés dans le même VPC.
(Facultatif) La dernière version de Cloud Assistant CLI est installée et configurée.

Activer la fonctionnalité de passerelle multi-cluster

Console

Connectez-vous à la console ACK One. Dans le volet de navigation de gauche, sélectionnez Fleet > Multi-cluster Gateway.
Sur la page Multi-cluster Gateway, cliquez sur la liste déroulante Create a multi-cluster gateway, puis sélectionnez Enable MSE multi-cluster gateway. Dans la boîte de dialogue qui s'affiche, cliquez sur OK.

Command line

Assurez-vous que Cloud Assistant CLI est à jour et exécutez la commande suivante pour activer la fonctionnalité de passerelle multi-cluster.

Remplacez <YOUR_FLEET_CLUSTERID> par l'ID de votre instance Fleet.
```
aliyun adcp UpdateHubClusterFeature --ClusterId <YOUR_FLEET_CLUSTERID> --GatewayEnabled true
```
Exécutez la commande suivante pour vérifier si la fonctionnalité de passerelle multi-cluster est activée :
```
aliyun adcp DescribeHubClusterDetails --ClusterId <YOUR_FLEET_CLUSTERID> |grep -B4 -A1 EnabledMSE`
```
Résultat attendu : si la valeur du paramètre Status est True, la fonctionnalité de passerelle multi-cluster est activée.
```
			{
				"Message": "",
				"Reason": "",
				"Status": "True",
				"Type": "EnabledMSE"
			},
```

Créer une passerelle multi-cluster

Console

Connectez-vous à la console ACK One. Dans le volet de navigation de gauche, sélectionnez Fleet > Multi-cluster Gateway.
Dans le coin supérieur droit de la page Multi-cluster Gateway, cliquez sur la liste déroulante Create a multi-cluster gateway, puis sélectionnez MSE multi-cluster gateway.
Dans le panneau qui s'affiche, modifiez le fichier YAML utilisé pour créer la passerelle multi-cluster selon vos besoins, puis cliquez sur Create.

Command line

Obtenez et notez l'ID du vSwitch de l'instance ACK One Fleet.
1. Exécutez la commande suivante pour interroger l'ID du vSwitch :
```
aliyun adcp DescribeHubClusterDetails --ClusterId <YOUR_FLEET_CLUSTERID>
```
1. Notez l'ID du vSwitch figurant dans le champ VSwitches du résultat.

Créez un fichier nommé mseingressconfig.yaml et ajoutez-y le contenu suivant.

Remplacez ${vsw-id1} par l'ID du vSwitch que vous avez noté. Vous pouvez ajouter une annotation au fichier de configuration de la passerelle pour spécifier les clusters associés à ajouter à la passerelle.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: ackone-gateway
  # Connect associated clusters to the MSE gateway.
  #annotations:
  #  mse.alibabacloud.com/remote-clusters: ${cluster1},${cluster2}
spec:
  common:
    instance:
      replicas: 3
      spec: 2c4g
    network:
      # You can configure both an Internet-facing SLB and an internal-facing SLB. If no SLB instance is specified, an Internet-facing SLB is used by default.
      #publicSLBSpec: slb.s2.small
      #privateSLBSpec: slb.s2.small
      vSwitches:
      - ${vsw-id1}
  ingress:
    local:
      ingressClass: mse
  name: mse-ingress

Exécutez la commande suivante pour créer une passerelle nommée mse-ingress sur l'instance ACK One Fleet :
```
kubectl apply -f mseingressconfig.yaml
```
Exécutez la commande suivante pour vérifier si la passerelle a été créée :
```
kubectl get mseingressconfig ackone-gateway
```
Résultat attendu :
```
NAME             STATUS      AGE
ackone-gateway   Listening   3m15s
```
Le résultat indique que la passerelle est à l'état Listening. Cela signifie que la passerelle cloud-native est créée et en cours d'exécution. La passerelle écoute les Ingresses dont les IngressClasses sont mse.

L'état d'une passerelle créée à partir d'un MseIngressConfig évolue selon la séquence suivante : Pending, Running, puis Listening. Description des états :
- Pending : la passerelle cloud-native est en cours de création. Ce processus peut prendre environ 3 minutes.
- Running : la passerelle cloud-native est créée et en cours d'exécution.
- Listening : la passerelle cloud-native est en cours d'exécution et écoute les Ingresses.
- Failed : la passerelle cloud-native est dans un état anormal. Consultez le message dans le champ Status pour identifier la cause.

Ajouter ou supprimer des clusters associés

Console

Connectez-vous à la console ACK One. Dans le volet de navigation de gauche, sélectionnez Fleet > Multi-cluster Gateway.
Dans la partie supérieure de la page Multi-cluster Gateway, sélectionnez la passerelle multi-cluster à gérer dans la liste déroulante, puis cliquez sur Modify dans le coin supérieur droit.
Dans le panneau qui s'affiche, modifiez le contenu YAML. Modifiez les ID de cluster dans le paramètre annotations et cliquez sur Update.
Exemple de code :
```
annotations:
  mse.alibabacloud.com/remote-clusters: ${cluster1-id},${cluster2-id}
```
- ${cluster1-id} et ${cluster2-id} correspondent aux ID des clusters associés. Séparez plusieurs ID de cluster par des virgules (,). Vous pouvez modifier les ID de cluster pour ajouter ou supprimer des clusters associés.
- Si vous n'associez aucun cluster lors de la création d'une passerelle multi-cluster, le contenu YAML n'inclut pas le paramètre annotations . Par conséquent, pour ajouter des clusters associés, vous devez ajouter l'exemple précédent à l'objet metadata dans le contenu YAML, puis ajouter ou modifier les ID de cluster.

Command line

Modifiez l'annotation correspondante dans l'objet mseingressconfig de l'instance ACK One Fleet pour ajouter ou supprimer des clusters associés. Remplacez ${cluster1-id} et ${cluster2-id} par les ID des clusters associés. Séparez plusieurs ID de cluster par des virgules (,).
```
annotations:
  mse.alibabacloud.com/remote-clusters: ${cluster1-id},${cluster2-id}
```
Si vous n'associez aucun cluster lors de la création d'une passerelle multi-cluster, le contenu YAML n'inclut pas le paramètre annotations . Par conséquent, pour ajouter des clusters associés, vous devez ajouter l'exemple précédent à l'objet metadata dans le contenu YAML, puis ajouter ou modifier les ID de cluster.
Exécutez la commande suivante pour vérifier si les clusters associés ont été ajoutés à la passerelle multi-cluster :
```
kubectl get mseingressconfig ackone-gateway -ojsonpath="{.status.remoteClusters}"
```
Résultat attendu :
```
[{"clusterId":"c7fb82****"},{"clusterId":"cd3007****"}]
```
Le résultat affiche les ID des clusters associés et aucun message d'erreur n'est renvoyé. Cela signifie que les clusters associés ont été ajoutés à la passerelle multi-cluster.
Exécutez la commande suivante pour interroger les clusters associés ajoutés à la passerelle multi-cluster :
```
kubectl get mseingressconfig ackone-gateway
```
Exécutez la commande suivante pour ajouter d'autres clusters associés ou en supprimer.

mse.alibabacloud.com/remote-clusters=${cluster1},${cluster2} indique les clusters associés à ajouter à la passerelle multi-cluster.
```
kubectl annotate mseingressconfig ackone-gateway mse.alibabacloud.com/remote-clusters=${cluster1},${cluster2} --overwrite=true
```

Désactiver la fonctionnalité de passerelle multi-cluster

Important

La suppression des passerelles multi-clusters peut avoir un impact négatif sur vos activités. Procédez avec prudence.
Si vous n'avez plus besoin de passerelles multi-clusters, supprimez-les, puis désactivez la fonctionnalité de passerelle multi-cluster afin d'éviter le gaspillage de ressources.

Console

Connectez-vous à la console ACK One. Dans le volet de navigation de gauche, sélectionnez Fleet > Multi-cluster Gateway.
Sur la page Multi-cluster Gateway, sélectionnez MSE dans la liste déroulante Gateway Type, sélectionnez la passerelle multi-cluster à supprimer dans la liste déroulante Select a gateway, puis cliquez sur Delete dans le coin supérieur droit.
Dans la boîte de dialogue qui s'affiche, saisissez le nom de la passerelle multi-cluster à supprimer, puis cliquez sur Delete.
Confirmez que toutes les passerelles multi-clusters de l'instance ACK One Fleet ont été supprimées, puis cliquez sur Disable MSE Ingresses dans le coin supérieur droit de la page. Dans le message qui s'affiche, cliquez sur OK.

Command line

Exécutez la commande suivante pour supprimer une passerelle multi-cluster :
```
kubectl delete mseingressconfig ackone-gateway
```
Exécutez la commande suivante pour désactiver la fonctionnalité de passerelle multi-cluster :
```
aliyun adcp UpdateHubClusterFeature --ClusterId <YOUR_FLEET_CLUSTERID> --GatewayEnabled false
```