Migrate Terway EIPs to ack-extend-network-controller - Container Service for Kubernetes

L'EIP Terway est obsolète et n'est plus maintenu. Utilisez le module complémentaire ack-extend-network-controller pour gérer les EIP. Cette rubrique explique comment migrer les EIP de Terway vers ack-extend-network-controller sans interruption de service.

Prérequis

Un cluster géré ACK ou un cluster dédié ACK avec Terway comme plug-in réseau doit être disponible. Consultez les rubriques Créer un cluster géré ACK et Créer un cluster dédié ACK (n'est plus disponible).
Vous avez configuré les autorisations RAM requises pour les EIP.

Impact

Important

La migration s'effectue sans interruption et n'affecte ni les informations sur l'EIP ni les charges de travail.

Si votre cluster utilise des EIP Terway, suivez ce guide pour migrer vers ack-extend-network-controller.
Si votre cluster n'utilise pas d'EIP Terway, ignorez cette migration.

Aperçu de la migration

Lorsque vous activez la migration des EIP dans Terway, celui-ci crée une ressource PodEIP pour chaque EIP associée à un pod. Une ressource PodEIP gère les informations relatives à l'EIP d'un pod. Après la migration, ack-extend-network-controller prend en charge la gestion des EIP.

Pour activer la fonctionnalité EIP dans Terway, consultez la section Cas d'utilisation de l'attribution automatique d'EIP.

Procédure

Vérifiez qu'ack-extend-network-controller n'est pas installé dans votre cluster. Si c'est le cas, désinstallez-le.
1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.
2. Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Applications > Helm.
3. Sur la page Helm, recherchez le Release Name ack-extend-network-controller. S'il existe, cliquez sur Delete dans la colonne Actions pour le désinstaller.
Mettez à niveau le plug-in réseau Terway vers la version 6.0 ou ultérieure.

Consultez la section Gérer les composants.

Modifiez le ConfigMap de Terway pour activer la migration des EIP.

Important

Lorsque vous activez la migration des EIP, Terway crée une ressource PodEIP pour chaque EIP associée à un pod et cesse de gérer les EIP.

Modifiez le ConfigMap de Terway :

kubectl edit cm eni-config -n kube-system

Modifiez la configuration dans eni_conf.

Paramètre	Valeur	Description
enable_eip_pool	"true"	S'il n'est pas configuré ou défini sur `"false"`, la fonctionnalité `eip` n'est pas activée et aucune migration n'est requise.
enable_eip_migrate	true	Définissez la valeur sur `true` pour activer la migration.

Exemple de configuration. Ne modifiez pas les autres paramètres.

# The preceding content is omitted.
  eni_conf: |
    {
      "version": "1",
      "enable_eip_pool": "true",
      "enable_eip_migrate": true,
      "vswitch_selection_policy": "ordered"
    }
# The following content is omitted.

Après avoir modifié la configuration, redémarrez les pods Terway :
```
kubectl delete pod -n kube-system -l app=terway-eniip
```
Une fois les pods redémarrés, Terway migre automatiquement les EIP du cluster vers ack-extend-network-controller.

Vérifiez l'état de la migration dans les journaux de Terway. La présence de la chaîne eip migrate finished indique que l'opération a réussi.
1. Obtenez les noms des pods Terway :
```
kubectl get pods -n kube-system | grep terway
```
  La sortie liste les noms des pods Terway.
2. Consultez les journaux d'un pod Terway :
```
kubectl logs -n kube-system <pod_name> # Replace <pod_name> with the name of your Terway pod.
```
  La présence de eip migrate finished dans la sortie confirme que la migration est terminée.
```
Ds:[sg-2ze360hfgjtsemo2wyyj] InstanceID:i-2zed                              5 VSwitchSelectionPolic
I1013 03:44:40.082505 daemon.go:1596] subSys=network-service eip migrate finished
```
Vérifiez que les ressources personnalisées (CR) PodEIP ont été créées dans le cluster.

Interrogez une CR migrée. Chaque CR porte le même nom et se trouve dans le même espace de noms que le pod correspondant.
```
kubectl get podeip -n {namespace} {name} # Replace {namespace} and {name} with the namespace and name of the pod associated with an EIP.
```
Installez ack-extend-network-controller depuis la Marketplace et activez la fonctionnalité EIP. Consultez la section Installer ack-extend-network-controller depuis la Marketplace.

Vérifiez si l'état de la ressource PodEIP est mis à jour :

kubectl get podeip -n {namespace} {name} -o yaml # Replace {namespace} and {name} with the namespace and name of the pod associated with an EIP.

Un champ status non vide indique que la fonction EIP fonctionne correctement.
Un champ status vide indique un problème. Vérifiez la configuration et les journaux d'ack-extend-network-controller.

Exemple de sortie :

Exemple de sortie PodEIP

apiVersion: alibabacloud.com/v1beta1
kind: PodEIP
metadata:
  creationTimestamp: "2023-10-24T08:24:37Z"
  finalizers:
  - podeip-controller.alibabacloud.com/finalizer
  generation: 1
  name: example-xxx-xx
  namespace: default
  resourceVersion: "44013"
  uid: 4744a7af-***-***-ad06-***17aecce
spec:
  allocationID: eip-xxxxxx
  allocationType:
    releaseStrategy: Follow
    type: Auto
status:
  eipAddress: 47.XX.XX.XX
  internetChargeType: PayByTraffic
  isp: BGP
  networkInterfaceID: eni-xxxxxxx
  podLastSeen: "2023-10-24T08:31:22Z"
  privateIPAddress: 192.XX.XX.XX
  resourceGroupID: rg-xxxxxx
  status: InUse

Paramètres :

Paramètre	Description
spec.allocationType.type	`Static` : Le pod utilise un ID EIP spécifié. `Auto` : Terway crée automatiquement l'EIP.
spec.allocationType.releaseStrategy	`Follow` : L'EIP est libéré lorsque le pod est supprimé. Pour les charges de travail sans état, l'association EIP-pod n'est pas maintenue. `TTL` : L'EIP est libéré après une durée spécifiée. Utilisez cette option pour maintenir l'association EIP-pod pour les charges de travail avec état.

Pour désactiver la fonctionnalité EIP dans Terway :
1. Définissez enable_eip_migrate sur false, ou supprimez-le.
2. Définissez enable_eip_pool sur "false" ou supprimez-le.
3. Redémarrez les pods Terway.