Routen und Domains konfigurieren

Auf dieser Seite wird beschrieben, wie Routen und Domains in Kf funktionieren und wie Entwickler und Administratoren Routen und Domains für eine auf dem Kf-Cluster bereitgestellte Anwendung konfigurieren.

Sie müssen Domain und Routen erstellen, um externen Zugriff auf Ihre Anwendung zu gewähren.

Internes Routing

Kf-Anwendungen können intern mit anderen Anwendungen im Cluster direkt über das von Cloud Service Mesh bereitgestellte Mesh-Netzwerk kommunizieren, ohne das Clusternetzwerk zu verlassen. Standardmäßig wird der gesamte Traffic mithilfe von gegenseitigem TLS verschlüsselt.

Alle im Kf-Cluster bereitgestellten Anwendungen haben standardmäßig einen internen Endpunkt. Sie können die Adresse app-name.space-name.svc.cluster.local für die interne Kommunikation zwischen Anwendungen verwenden. Zur Verwendung dieser internen Adresse sind keine weiteren Schritte erforderlich. Gegenseitiges TLS ist für interne Routen standardmäßig aktiviert. Beachten Sie, dass diese interne Adresse nur über die Pods zugänglich ist, auf denen die Anwendungen ausgeführt werden, und nicht von außerhalb des Clusters.

App-Lastenausgleich

Der Traffic wird von Istio mithilfe einer Round-Robin-Richtlinie an fehlerfreie Instanzen einer Anwendung weitergeleitet. Derzeit kann diese Richtlinie nicht geändert werden.

Routenfunktionen

Routen steuern das Ingress-Gateway des Clusters, wo Traffic bereitgestellt werden soll und was geschieht, wenn unter der angegebenen Adresse keine Anwendungen verfügbar sind. Wenn auf einer Route keine App verfügbar ist und die Route eine Anfrage erhält, wird standardmäßig ein HTTP 503-Statuscode zurückgegeben.

Routen bestehen aus drei Teilen: Host, Domain und Pfad. Beispiel für den URI payroll.mydatacenter.example.com/login:

  • Der Host ist payroll.
  • Die Domain ist mydatacenter.example.com.
  • Der Pfad ist /login

Routen müssen eine Domain enthalten, aber der Host und der Pfad sind optional. Mehrere Routen können denselben Host und dieselbe Domain verwenden, wenn sie unterschiedliche Pfade angeben. Mehrere Apps können dieselbe Route nutzen und der Traffic wird zwischen ihnen aufgeteilt. Dies ist nützlich, wenn Sie alte Blau/Grün-Bereitstellungen unterstützen müssen. Wenn mehrere Apps an verschiedene Pfade gebunden sind, ist die Priorität vom längsten zum kürzesten Pfad.

Routen verwalten

In den folgenden Abschnitten wird beschrieben, wie die kf-Befehlszeile zum Verwalten von Routen verwendet wird.

Routen auflisten

Entwickler können Routen für den aktuellen Raum mit dem Befehl kf routes auflisten.

$ kf routes
Getting Routes in Space: my-space
Found 2 Routes in Space my-space

HOST    DOMAIN       PATH    APPS
echo    example.com  /       echo
*       example.com  /login  uaa

Route erstellen

Entwickler können Routen mit dem Befehl kf create-route erstellen.

# Create a Route in the targeted Space to match traffic for myapp.example.com/*
$ kf create-route example.com --hostname myapp

# Create a Route in the Space myspace to match traffic for myapp.example.com/*
$ kf create-route -n myspace example.com --hostname myapp

# Create a Route in the targeted Space to match traffic for myapp.example.com/mypath*
$ kf create-route example.com --hostname myapp --path /mypath

# You can also supply the Space name as the first parameter if you have
# scripts that rely on the old cf style API.
$ kf create-route myspace example.com --hostname myapp # myapp.example.com

Wenn nach der Erstellung einer Route keine Apps daran gebunden sind, wird für alle übereinstimmenden Anfragen ein HTTP 503-Statuscode zurückgegeben.

Route Ihrer Anwendung zuordnen

Entwickler können ihre Anwendung mit dem Befehl kf map-route über eine Route zugänglich machen.

$ kf map-route MYAPP mycluster.example.com --host myapp --path mypath

Zuordnung einer Route aufheben

Entwickler können ihre App mithilfe des Befehls kf unmap-route aus der Route entfernen.

$ kf unmap-route MYAPP mycluster.example.com --host myapp --path mypath

Route löschen

Entwickler können eine Route mit dem Befehl kf delete-route löschen.

$ kf delete-route mycluster.example.com --host myapp --path mypath

Wenn Sie eine Route löschen, wird der Traffic nicht mehr an alle Anwendungen weitergeleitet, die die Route überwachen.

Routen deklarativ in Ihrem App-Manifest verwalten

Routen können deklarativ in Ihrer App-Manifestdatei verwaltet werden. Sie werden erstellt, wenn sie noch nicht vorhanden sind.

---
applications:
- name: my-app
  # ...
  routes:
  - route: example.com
  - route: www.example.com/path

Weitere Informationen zu den unterstützten Routenattributen finden Sie in der Manifestdokumentation.

Routing-CRDs

Es gibt vier Typen, die für das Routing relevant sind:

  • VirtualService
  • Route
  • Dienst
  • App

Jede App hat einen Dienst, bei dem es sich um einen abstrakten Namen handelt, der allen ausgeführten Instanzen Ihrer App zugewiesen wird. Der Name des Dienstes ist mit dem Namen der App identisch. Eine Route stellt eine einzelne externe URL dar. Routen überwachen kontinuierlich Änderungen an Anwendungen. Wenn eine Anwendung angefordert wird, dass sie einer Route hinzugefügt wird, aktualisiert die Route die Liste der Apps und dann den VirtualService. Ein VirtualService stellt eine einzelne Domain dar und führt eine Liste aller Routen in einem Space zusammen, die zu dieser Domain gehören.

Istio liest die Konfiguration in VirtualServices, um zu bestimmen, wie der Traffic weitergeleitet wird.