Étape 1 : Créer un service « ClusterIP »

Pour chaque déploiement d'application que vous souhaitez exposer, créez un service Kubernetes ClusterIP. Votre application doit être exposée par un service Kubernetes pour être incluse dans l'équilibrage de charge Ingress.

kubectl expose deploy <app_deployment_name> --name my-app-svc --port <app_port> -n <namespace>

Étape 2 : Configurer la terminaison d' TLS avec les certificats TLS et les secrets Kubernetes

Votre certificat « TLS » doit être enregistré en tant que secret « Kubernetes » dans chaque espace de noms où se trouvent vos applications.

• Pour utiliser le sous-domaine Ingress fourni par IBM, consultez la section « Configuration des secrets TLS pour le sous-domaine Ingress fourni par IBM ».

• Pour utiliser un domaine personnalisé, consultez la section « Configuration des secrets d' TLS pour les sous-domaines personnalisés ».

Etape 3 : Créez la ressource Ingress

Créez la ressource Ingress afin de définir les règles de routage que le contrôleur Ingress utilise pour acheminer le trafic vers votre service d'application.

1. Créez la ressource Ingress dans un fichier YAML.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: my-ingress-resource
   spec:
     ingressClassName: public-iks-traefik
     tls:
     - hosts:
       - <domain_name>
       secretName: <tls_secret_name>
     rules:
     - host: HOSTNAME
       http:
         paths:
         - path: <app_path_1>
           pathType: Prefix
           backend:
             service:
               name: <app_service_1>
               port:
                 number: 80
         - path: <app_path_2>
           pathType: Prefix
           backend:
             service:
               name: <app_service_2>
               port:
                 number: 80
   

Champs de ressources

ingressClassName

Le nom de la classe Ingress. Les classes Ingress fournies par l' IBM sont public-iks-traefik pour les ALB publics et private-iks-traefik pour les ALB privés.

tls.hosts

Pour utiliser TLS, remplacez <domain> par le sous-domaine Ingress fourni par IBM ou votre domaine personnalisé.

tls.secretName

Remplacez « <tls_secret_name> » par le nom du secret « Kubernetes » dans lequel est stocké votre certificat « TLS ».

host

Remplacez <domain> par le sous-domaine Ingress fournir par IBM ou votre domaine personnalisé.

path

Remplacez <app_path> par une barre oblique ou le chemin que votre application écoute. Le chemin est ajouté au domaine Ingress spécifié afin de créer un itinéraire unique vers votre application. Lorsque vous indiquez cette route dans un navigateur Web, le trafic réseau est acheminé vers l'équilibreur de charge d'application. L'équilibreur de charge d'application recherche le service associé et lui envoie le trafic réseau. Le service transfère ensuite le trafic aux pods sur lesquels s'exécute l'application.

pathType

Méthode de correspondance de chemin d'URL. Les valeurs prises en charge sont ImplementationSpecific, Exact ou Prefix. Pour plus d'informations et des exemples sur chaque type de chemin d'accès, consultez la documentation de la communauté sur l' Kubernetes.

service.name

Remplacez app1_service et app2_service, et ainsi de suite, par le nom des services que vous avez créés pour exposer vos applications. Assurez-vous que les applications que vous spécifiez se trouvent dans le même espace de noms.

service.name

Remplacez <app1_service> et <app2_service>, et ainsi de suite, par le nom des services que vous avez créés pour exposer vos applications. Assurez-vous que les applications que vous spécifiez se trouvent dans le même espace de noms.

service.port.number

Port sur lequel votre service est à l'écoute. Utilisez le même port que celui que vous avez défini lors de la création du service Kubernetes pour votre application.

2. Appliquez la ressource Ingress à votre cluster. Veillez à ce que la ressource se déploie dans le même espace de noms que les services d'application que vous avez spécifiés dans la ressource.

   kubectl apply -f community-ingress-resource.yaml -n <namespace>
   

Étape 4 : Vérifiez la configuration d'Ingress

1. Répertoriez vos ALB et copiez l'adresse IP (classique) ou le nom d'hôte (VPC) d'un ALB exécutant l'image Ingress Kubernetes. Dans la sortie, choisissez un ALB ayant une génération dans le format <community_version>_<ibm_build>_iks.

   ibmcloud ks ingress alb ls -c CLUSTER
   

2. Utilisez l'adresse IP de l'ALB (classique) ou son nom d'hôte (VPC), le chemin d'accès à l'application et votre domaine pour vérifier que vous pouvez bien acheminer le trafic vers votre application via cet ALB.

   curl http://<ALB_IP>/<app_path> -H "Host: <ingress_subdomain>"
   

   Par exemple, pour envoyer une requête à une application appelée myapp en utilisant un sous-domaine Ingress par défaut, exécutez la commande suivante.

   curl http://169.X.X.X/myapp -H "Host: mycluster-a1b2cdef345678g9hi012j3kl4567890-0000.us-south.containers.appdomain.cloud"
   

Vous rencontrez des difficultés pour connecter votre application via Ingress ? Essayez de procéder au traitement des incidents liés à Ingress. Vous pouvez vérifier l'intégrité et l'état de vos composants Ingress en exécutant ibmcloud ks ingress status-report get -c CLUSTER_NAME_OR_ID.

Création de domaines personnalisés pour les ALB publiques

Suivez les étapes suivantes pour créer un domaine personnalisé pour les ALB publiques.

1. Créez un domaine personnalisé Pour enregistrer votre domaine personnalisé, travaillez en collaboration avec votre fournisseur DNS (Domain Name Service) ou IBM Cloud DNS. Si les applications que vous souhaitez exposer via Ingress se trouvent dans différents espaces de noms sur un cluster, enregistrez le domaine personnalisé en tant que domaine générique, par exemple *.custom_domain.net. Veuillez noter que la longueur des noms de domaine est limitée à 130 caractères maximum dans la version 1.20 ou ultérieure d' Kubernetes.

2. Définissez un alias pour votre domaine personnalisé en spécifiant le sous-domaine fourni par IBM sous forme d'enregistrement de nom canonique (CNAME). Pour rechercher le domaine Ingress fourni par IBM, exécutez ibmcloud ks cluster get --cluster CLUSTER_NAME et recherchez la zone Sous-domaine Ingress.

   Il est nécessaire de définir le sous-domaine fourni par IBM en tant que CNAME pour que les contrôles d'intégrité automatiques puissent exclure les adresses IP défaillantes de la réponse DNS, et pour garantir la mise à jour de votre domaine personnalisé lorsque vous ajoutez ou supprimez des ALB.

Création de domaines personnalisés pour les ALB privés

Suivez les étapes suivantes pour créer un domaine personnalisé pour les ALB privées. Notez que l'utilisation d'Ingress avec des ALB privés nécessite des domaines personnalisés.

Si vous disposez d'un cluster classique comportant uniquement un VLAN privé, vous devez d'abord configurer votre propre service DNS accessible depuis votre réseau privé.

1. Créez un domaine personnalisé via votre fournisseur de service DNS. Notez que les URL Ingress doivent comporter 130 caractères au maximum.

2. Mappez votre domaine personnalisé aux équilibreurs de charge d'application privés en ajoutant leurs adresses IP en tant qu'enregistrements A (clusters classiques) ou leur nom d'hôte VPC en tant qu'enregistrement CNAME (clusters VPC). Pour rechercher les adresses IP des ALB (classiques) ou le nom d'hôte (VPC), exécutez ibmcloud ks ingress alb ls -c CLUSTER_NAME_OR_ID.