Container Service for Kubernetes:Configure the network type for Nginx Ingress Controller

Fonctionnement

Dans le cluster, l'instance SLB reçoit les requêtes des clients et les transfère au workload du contrôleur d'entrée Nginx. Ce dernier relaie ensuite les requêtes vers d'autres Services.

Configurer Nginx Ingress pour un accès via les réseaux public et privé

Déployez deux Services pour les pods backend du contrôleur d'entrée Nginx : l'un associé à une instance SLB publique et l'autre à une instance SLB privée. Cette configuration permet de prendre en charge l'accès via les réseaux public et privé.

1. Vérifiez le type de réseau SLB actuel.

   kubectl describe service -n kube-system nginx-ingress-lb | grep "service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type"

   Si la sortie contient intranet, le type actuel est privé. Sinon, il s'agit d'un type public.

2. Créez un nouveau Service afin de garantir la présence des deux types de réseau (public et privé).

   Créez et enregistrez un fichier nommé nginx-ingress-lb-new.yaml. Exécutez kubectl apply -f nginx-ingress-lb-new.yaml pour créer le Service.

   Ajouter un Service de réseau privé

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb-intranet
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
     annotations:
       service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: intranet # Specifies that the SLB instance uses a private network address.
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

   Ajouter un Service de réseau public

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb-internet
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

3. Remplacez <service-name> par le nom de votre nouveau Service dans la commande suivante, puis exécutez-la. Si elle renvoie 200, le nouveau Service fonctionne correctement.

   curl -s -o /dev/null -w "%{http_code}\n" http://$(kubectl get service -n kube-system <service-name> -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

4. Remplacez <service-name> par le nom de votre nouveau Service, puis exécutez kubectl get service <service-name>. Notez l'adresse IP externe du Service et configurez le DNS en fonction du type de Service :

   Nouveau Service de réseau privé

   1. Connectez-vous à la console Alibaba Cloud DNS – Private DNS. Dans l'onglet Authoritative Zone > User Defined Zones, cliquez sur Add Zone. Si vous avez déjà ajouté le domaine, passez à l'étape c.

   2. Dans le champ Authoritative Zone, saisissez votre nom de domaine. Conservez les autres options par défaut et cliquez sur OK.

   3. Cliquez sur le domaine cible. Dans l'onglet Settings, cliquez sur Add Record. Remplissez le formulaire en utilisant les valeurs indiquées dans le tableau ci-dessous. Conservez les autres paramètres par défaut et cliquez sur OK.

      Configuration item	Value
      Record Type	A
      Hostname	Saisissez un préfixe de sous-domaine selon vos besoins.
      Record Value	L'adresse IP du nouveau Service.

   4. Revenez à la liste User Defined Zones. Dans la colonne Actions correspondant à votre domaine cible, sélectionnez Effective Scope. Sous Effective in VPCs, sélectionnez le VPC où réside votre cluster ACK. Cliquez ensuite sur OK.

   Nouveau Service de réseau public

   1. Connectez-vous à la console Alibaba Cloud DNS – Public Authoritative DNS. Cliquez sur votre domaine cible pour ouvrir la page Settings. Cliquez sur le bouton Add Record.

   2. Remplissez le formulaire en utilisant les valeurs indiquées dans le tableau ci-dessous. Conservez les autres paramètres par défaut et cliquez sur OK.

      Configuration item	Value
      Record Type	A.
      Hostname	Saisissez un préfixe de sous-domaine selon vos besoins.
      Record Value	L'adresse IP du nouveau Service.

Modifier le type de réseau

1. Assurez-vous que l'instance SLB existante ne reçoit aucun trafic :

   1. Connectez-vous à la Container Service Management Console. Cliquez sur votre cluster cible. Dans le volet de navigation de gauche, accédez à Network > Services. Recherchez nginx-ingress-lb dans le namespace kube-system. Notez son adresse External IP.

   2. Connectez-vous à la console Classic Load Balancer console. Sélectionnez la même région que celle de votre cluster. Recherchez l'instance CLB dont l'IP Address correspond à l'adresse IP notée à l'étape précédente. Cliquez sur l'instance. Dans l'onglet Monitoring, vérifiez que le nombre de connexions est égal à 0 avant de poursuivre.

2. Supprimez le Service actuellement utilisé par le contrôleur d'entrée Nginx.

   kubectl delete svc -n kube-system nginx-ingress-lb

3. Créez et enregistrez un fichier nommé nginx-ingress-lb.yaml. Exécutez ensuite kubectl apply -f nginx-ingress-lb.yaml pour créer le Service.

   Important

   Le nom du nouveau Service doit être nginx-ingress-lb.

   Service de réseau privé

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
     annotations:
       service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: intranet # Specifies that the SLB instance uses a private network address.
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

   Service de réseau public

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-ingress-lb
     namespace: kube-system
     labels:
       app: nginx-ingress-lb
   spec:
     type: LoadBalancer
     externalTrafficPolicy: "Cluster"
     ports:
     - port: 80
       name: http
       targetPort: 80
     - port: 443
       name: https
       targetPort: 443
     selector:
       app: ingress-nginx

4. Testez le nouveau Service. S'il renvoie 200, le Service fonctionne correctement.

   curl -s -o /dev/null -w "%{http_code}\n" http://$(kubectl get service -n kube-system nginx-ingress-lb -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

5. Exécutez kubectl get service nginx-ingress-lb. Notez l'adresse IP externe du Service et configurez le DNS en fonction du type de Service :

   Nouveau Service de réseau privé

   1. Connectez-vous à la console Alibaba Cloud DNS – Private DNS. Dans l'onglet Authoritative Zone > User Defined Zones, cliquez sur Add Zone. Si vous avez déjà ajouté le domaine, passez à l'étape c.

   2. Dans le champ Authoritative Zone, saisissez votre nom de domaine. Conservez les autres options par défaut et cliquez sur OK.

   3. Cliquez sur le domaine cible. Dans l'onglet Settings, cliquez sur Add Record. Remplissez le formulaire en utilisant les valeurs indiquées dans le tableau ci-dessous. Conservez les autres paramètres par défaut et cliquez sur OK.

      Configuration item	Value
      Record Type	A
      Hostname	Saisissez un préfixe de sous-domaine selon vos besoins.
      Record Value	L'adresse IP du nouveau Service.

   4. Revenez à la liste User Defined Zones. Dans la colonne Actions correspondant à votre domaine cible, sélectionnez Effective Scope. Sous Effective in VPCs, sélectionnez le VPC où réside votre cluster ACK. Cliquez ensuite sur OK.

   Nouveau Service de réseau public

   1. Connectez-vous à la console Alibaba Cloud DNS – Public Authoritative DNS. Cliquez sur votre domaine cible pour ouvrir la page Settings. Cliquez sur le bouton Add Record.

   2. Remplissez le formulaire en utilisant les valeurs indiquées dans le tableau ci-dessous. Conservez les autres paramètres par défaut et cliquez sur OK.

      Configuration item	Value
      Record Type	A.
      Hostname	Saisissez un préfixe de sous-domaine selon vos besoins.
      Record Value	L'adresse IP du nouveau Service.

FAQ

Références

Pour plus de détails sur la configuration des annotations pour une instance SLB existante, consultez la rubrique Utiliser une instance SLB existante.