Eine Service-Instanz mit Ihrer App verbinden

In diesem Dokument zeigen wir Ihnen, wie Sie eine Service-Instanz mit Ihrer Anwendung verbinden. Mit diesen Services erweitern Sie Ihre Cloud-Umgebung zum Beispiel um Persistenz, Message Queues oder andere hilfreiche Werkzeuge. Cloud Foundry macht diesen Prozess durch Service-Broker besonders einfach. Hier lernen Sie, wie Sie diese nutzen.

Dies ist ein Erste-Schritte-Überblick zum Thema Services in Cloud Foundry. Weiterführende Informationen zum Service-Management finden Sie in der offiziellen Cloud Foundry Dokumentation.

Möchten Sie STACKIT Cloud Foundry zum ersten Mal ausprobieren und haben noch keine cloudfähige Anwendung vorbereitet? Nutzen Sie in diesem Fall eine der Beispielanwendungen aus der Cloud Foundry Open-Source-Community: Cloud Foundry Sample Applications.

Via CLI

In diesem Tab erfahren Sie, wie Sie mit der Cloud Foundry CLI:

• eine Service-Instanz an eine App binden
• eine Service-Instanz entbinden

Eine Service-Instanz an eine App via CLI binden

Wenn Sie einen Data Service an Ihre Anwendung binden, werden die für den Zugriff benötigten Verbindungsdaten automatisch in die Umgebungsvariablen Ihres Application Space injiziert. Wenn ein automatischer Prozess Ihren Data Service aktualisiert und sich dabei Verbindungsdaten ändern, sorgt Cloud Foundry dafür, dass auch die injizierten Credentials entsprechend aktualisiert werden. Das bedeutet: Nach dem Erstellen und Binden einer Service-Instanz müssen Sie nur noch die Verbindungsdaten aus den Umgebungsvariablen auslesen, um den Data Service zu nutzen.

Sie können eine Data-Service-Instanz mit dem folgenden Befehl einfach an Ihre Anwendung binden. Nach erfolgreichem Binding müssen Sie Ihre Anwendung restagen, damit sie die neu injizierten Umgebungsvariablen einliest.

cf bind-service APP_NAME SERVICE_INSTANCE_NAME [-c PARAMETERS_AS_JSON] [--binding-name BINDING_NAME]
cf restage APP_NAME

Es wird dringend empfohlen, das Argument --binding-name zu verwenden und damit einen eindeutigen Binding-Namen zu setzen. Über diesen Namen können Sie die Verbindungsdaten Ihres Data Service in den Umgebungsvariablen eindeutig identifizieren.

Wenn Sie stattdessen den Namen der Service-Instanz oder insbesondere den Servicenamen als Kennung in der Liste der injizierten Verbindungsdaten verwenden, kann das zu Problemen führen, vor allem bei mehreren Data-Service-Bindings.

Nach erfolgreichem Binding sehen Sie in den Umgebungsvariablen Ihres Space ein neues Objekt mit dem Namen VCAP_SERVICES. Darin finden Sie die Liste der an Ihre Anwendung gebundenen Services, wie im folgenden Beispiel.

{
  "VCAP_SERVICES": {
    "service-name": [
      {
        "name": "postgres-database",
        "binding_name": "postgres-database",
        "credentials": {
          ...
        }
      }
    ]
  }
}

Sie können die Umgebungsvariable für den gebundenen Data Service über den gesetzten Binding-Namen gezielt auslesen.

Sie können eine vorhandene Service-Instanz auch über die Manifest-Datei an Ihre Anwendung binden. Erweitern Sie die Manifest-Datei dazu um den Block services. Das sieht zum Beispiel so aus:

manifest.yml

---
applications:
- name: APP_NAME
  services:
  - SERVICE_INSTANCE_NAME

Wenn Sie diese Manifest-Datei pushen, wird die Service-Instanz automatisch an Ihre Anwendung gebunden. Weitere Details finden Sie unter “Wie man Manifest-Dateien nutzt”.

Eine Service-Instanz via CLI entbinden

Wenn Sie eine Service-Instanz nicht mehr benötigen, können Sie diese auch wieder entbinden. Verwenden Sie dazu folgenden Befehl:

cf unbind-service APP_NAME SERVICE_INSTANCE_NAME

Via Stratos (UI)

In diesem Tab erfahren Sie, wie Sie mit der Stratos UI:

• eine Service-Instanz an eine App binden
• eine Service-Instanz entbinden

Eine Service-Instanz an eine App via Stratos binden

Wenn Sie eine Service-Instanz an Ihre Anwendung binden möchten, können Sie dies in der Service-Übersicht Ihres Application Space in der linken Navigation der Console UI erledigen. Navigieren Sie zu Applications, dann zu Services. Dort finden Sie oben die Schaltfläche +, um ein neues Service-Instanz-Binding hinzuzufügen.

Danach wählen Sie, ob Sie eine Instanz eines Marketplace Service oder eines User Provided Service binden möchten. Marketplace Services sind Data Services aus dem Marketplace der Plattform (siehe erstes Kapitel). User Provided Services sind Services, die Sie selbst in Cloud Foundry erstellt und bereitgestellt haben, zum Beispiel ein Routing-Service.

Da wir in diesem Beispiel einen Data Service binden möchten, wählen Sie per Klick auf die Karte den Marketplace Service aus.

Im nächsten Schritt wählen Sie den Servicetyp, den Sie binden möchten. Hier wählen Sie denselben Servicetyp, den Sie zuvor erstellt haben.

Dasselbe gilt für den darauffolgenden Schritt: Wählen Sie exakt den Service-Plan, den Sie für die Erstellung der Service-Instanz verwendet haben. Welcher Service-Plan für eine Instanz verwendet wird, sehen Sie in der allgemeinen Service-Übersicht der Console UI.

Im folgenden Schritt können Sie optionale Binding-Parameter setzen. Im Feld App sollte oberhalb bereits der Name der Anwendung stehen, an die Sie die Service-Instanz binden möchten.

Im letzten Schritt wählen Sie schliesslich die Service-Instanz aus, die gebunden werden soll.

Wenn Sie in diesem Schritt die Option Bind to an Existing Service Instance nicht sehen, haben Sie sehr wahrscheinlich einen falschen Service-Plan oder Servicetyp ausgewählt. Diese Option erscheint nur, wenn für den ausgewählten Servicetyp und Service-Plan bereits eine Service-Instanz vorhanden ist.

Diese Funktion zur Service-Erstellung in diesem Ablauf funktioniert derzeit nicht.

Die Erstellung unserer Data-Service-Instanzen ist asynchron. Der Binding-Prozess der Console UI erwartet an dieser Stelle jedoch eine synchrone Antwort. Wenn Sie hier die Option Create and Bind to a new Service Instance wählen, erscheint eine Fehlermeldung, dass das Binding fehlgeschlagen ist. Ihre Service-Instanz wird dennoch erstellt. Führen Sie danach den Binding-Prozess aus diesem Kapitel erneut aus und wählen Sie dann Bind to an Existing Service Instance.

Im Dropdown-Menü können Sie eine der verfügbaren Service-Instanzen auswählen, die zu den zuvor gesetzten Parametern passt. Über Finish wenden Sie das Binding an. Danach ist der Service mit Ihrer Anwendung verbunden und in der Service-Übersicht Ihres Application Space in der Console UI sichtbar, wie im folgenden Bild gezeigt.

Zusatzlich wurden die Verbindungsdaten Ihrer Data-Service-Instanz über das Objekt VCAP_SERVICES in die Umgebungsvariablen Ihrer Anwendung injiziert, wie im folgenden Bild dargestellt.

Stellen Sie sicher, dass Sie Ihre Anwendung nach dem Binding einer neuen Data-Service-Instanz restagen, damit die Anwendung die neuen Umgebungsvariablen einliest.

Eine Service-Instanz via Stratos entbinden

Sie können Ihre Data-Service-Instanz in der Service-Übersicht der Console UI einfach entbinden. Filtern Sie auf den Space, in dem die Instanz erstellt wurde, und öffnen Sie dann im Panel der betreffenden Service-Instanz das Kontextmenü (drei Punkte), wie im folgenden Bild gezeigt.