Schritt 1: Erstellen Sie einen „ ClusterIP “-Dienst

Erstellen Sie für jede App-Bereitstellung, die Sie zugänglich machen möchten, einen Kubernetes-Service ClusterIP. Ihre App muss durch einen Kubernetes Service zugänglich gemacht werden, damit sie in den Ingress-Lastausgleich einbezogen wird.

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

Schritt 2: Richten Sie die „ TLS “-Terminierung mit den Zertifikaten unter TLS und den Geheimnissen unter Kubernetes ein

Ihr „ TLS “-Zertifikat muss in jedem Namespace, in dem sich Ihre Apps befinden, als „ Kubernetes “-Geheimnis gespeichert werden.

• Informationen zur Verwendung der von „ IBM “ bereitgestellten Ingress-Subdomain finden Sie unter „ Einrichten von TLS-Secrets für die von „ IBM “ bereitgestellte Ingress-Subdomain “.

• Informationen zur Verwendung einer benutzerdefinierten Domain finden Sie unter „ TLS-Geheimnisse für benutzerdefinierte Subdomains einrichten “.

Schritt 3: Ingress-Ressource erstellen

Erstellen Sie die Ingress-Ressource, um die Routing-Regeln zu definieren, die der Ingress-Controller verwendet, um den Datenverkehr an Ihren App-Service weiterzuleiten.

1. Erstellen Sie die Ingress-Ressource in einer YAML-Datei.

   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
   

Ressourcenfelder

ingressClassName

Der Name der Ingress-Klasse. Die von der „ IBM “ bereitgestellten Ingress-Klassen lauten „ public-iks-traefik “ für öffentliche ALBs und „ private-iks-traefik “ für private ALBs.

tls.hosts

Wenn TLS verwendet werden soll, ersetzen Sie <domain> durch die von IBM bereitgestellte Ingress-Unterdomäne oder Ihre angepasste Domäne.

tls.secretName

Ersetzen Sie „ <tls_secret_name> “ durch den Namen des „ Kubernetes “-Secrets, in dem Ihr „ TLS “-Zertifikat gespeichert ist.

host

Ersetzen Sie <domain> durch die von IBM bereitgestellte Ingress-Unterdomäne oder Ihre angepasste Domäne.

path

Ersetzen Sie <app_path> durch einen Schrägstrich oder durch den Pfad, über den Ihre App empfangsbereit ist. Der Pfad wird an die angegebene Ingress-Domäne angehängt, um eine eindeutige Route zu Ihrer App zu erstellen. Wenn Sie diese Route in einen Web-Browser eingeben, wird der Netzverkehr an die Lastausgleichsfunktion für Anwendungen (ALB) weitergeleitet. Die Lastausgleichsfunktion für Anwendungen (ALB) sucht nach dem zugehörigen Service und sendet Netzverkehr an ihn. Daraufhin leitet der Service den Datenverkehr an die Pods weiter, in denen die App ausgeführt wird.

pathType

Die Methode zum Abgleich des URL-Pfads. Unterstützte Werte sind ImplementationSpecific, Exact oder Prefix. Weitere Informationen und Beispiele zu den einzelnen Pfadtypen finden Sie in der Community-Dokumentation unter Kubernetes.

service.name

Ersetzen Sie app1_service, app2_service usw. durch den Namen der Services, die Sie erstellt haben, um Ihre Apps zugänglich zu machen. Stellen Sie sicher, dass sich die von Ihnen angegebenen Apps im selben Namensraum befinden.

service.name

Ersetzen Sie <app1_service>, <app2_service> usw. durch den Namen der Services, die Sie erstellt haben, um Ihre Apps zugänglich zu machen. Stellen Sie sicher, dass sich die von Ihnen angegebenen Apps im selben Namensraum befinden.

service.port.number

Der Port, den Ihr Service überwacht. Verwenden Sie denselben Port, die Sie beim Erstellen der Kubernetes Service-Instanz für Ihre App definiert haben.

2. Wenden Sie die Ingress-Ressource auf Ihren Cluster an. Stellen Sie sicher, dass die Ressource im selben Namensbereich wie die App-Services bereitgestellt wird, die in der Ressource angegeben wurden.

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

Schritt 4: Überprüfen Sie Ihre Ingress-Konfiguration

1. Listen Sie Ihre ALBs auf und kopieren Sie die IP-Adresse (Classic) oder den Hostnamen (VPC) für eine ALB, auf der das Kubernetes-Ingress-Image ausgeführt wird. Wählen Sie in der Ausgabe eine ALB aus, die über einen Build im Format <community_version>_<ibm_build>_iks verfügt.

   ibmcloud ks ingress alb ls -c CLUSTER
   

2. Verwenden Sie die IP-Adresse (klassisch) oder den Hostnamen (VPC) des ALB sowie den App-Pfad und Ihre Domain, um zu überprüfen, ob Sie Datenverkehr erfolgreich über diesen ALB an Ihre App senden können.

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

   Um beispielsweise eine Anfrage an eine App namens myapp unter Verwendung einer Standard-Ingress-Subdomain zu senden, führen Sie den folgenden Befehl aus.

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

Haben Sie Schwierigkeiten, über Ingress eine Verbindung zu Ihrer App herzustellen? Versuchen Sie, Fehler bei Ingress zu beheben. Sie können den Gesamtzustand und den Status Ihrer Ingress-Komponenten überprüfen, indem Sie ibmcloud ks ingress status-report get -c CLUSTER_NAME_OR_ID ausführen.

Erstellen benutzerdefinierter Domänen für öffentliche ALBs

Befolgen Sie die folgenden Schritte, um eine benutzerdefinierte Domain für öffentliche ALBs zu erstellen.

1. Erstellen Sie eine angepasste Domäne. Arbeiten Sie mit Ihrem DNS-Provider (Domain Name Service) oder IBM Cloud-DNS, um Ihre angepasste Domäne zu registrieren. Wenn sich die Apps, die über Ingress zugänglich gemacht werden sollen, in einem Cluster in unterschiedlichen Namensbereichen befinden, registrieren Sie die angepasste Domäne als Platzhalterdomäne, wie *.custom_domain.net. Bitte beachten Sie, dass Domains in der Version „ Kubernetes “ ( 1.20 ) oder höher auf maximal 130 Zeichen begrenzt sind.

2. Definieren Sie einen Aliasnamen für Ihre Clusterdomäne, indem Sie die von IBM bereitgestellte Unterdomäne als kanonischen Namensdatensatz (CNAME) angeben. Führen Sie ibmcloud ks cluster get --cluster CLUSTER_NAME aus, um die von IBM bereitgestellte Ingress-Domäne zu finden, und suchen Sie nach dem Feld Ingress-Unterdomäne.

   Die Angabe der von IBM bereitgestellten Subdomain als CNAME ist erforderlich, damit bei automatischen Zustandsprüfungen fehlerhafte IP-Adressen aus der DNS-Antwort entfernt werden und um sicherzustellen, dass Ihre benutzerdefinierte Domain aktualisiert wird, wenn Sie ALBs hinzufügen oder entfernen.

Erstellen benutzerdefinierter Domains für private ALBs

Befolgen Sie die folgenden Schritte, um eine benutzerdefinierte Domain für private ALBs zu erstellen. Beachten Sie, dass für die Verwendung von Ingress mit privaten ALBs benutzerdefinierte Domains erforderlich sind.

Wenn Sie über einen klassischen Cluster mit nur einem privaten VLAN verfügen, müssen Sie zunächst Ihr eigenes „ DNS-Dienst, der in Ihrem privaten Netzwerk verfügbar ist “ konfigurieren.

1. Erstellen Sie eine angepasste Domäne über Ihren DNS-Service-Provider. Bitte beachten Sie, dass Ingress-URLs maximal 130 Zeichen lang sein dürfen.

2. Ordnen Sie Ihre angepasste Domäne den privaten ALBs zu, indem Sie ihre IP-Adressen als A-Datensatz (klassische Cluster) oder ihren VPC-Hostnamen als CNAME (VPC-Cluster) hinzufügen. Führen Sie ibmcloud ks ingress alb ls -c CLUSTER_NAME_OR_ID aus, um die IP-Adressen (klassischer Cluster) oder den Hostnamen (VPC-Cluster) der ALB zu suchen.