Erstellen eines Dienstes "Privater Pfad" in der Konsole

Führen Sie die folgenden Schritte aus, um einen privaten Pfadservice mit der IBM Cloud-Konsole zu erstellen:

1. Öffnen Sie im Browser die IBM Cloud-Konsole und melden Sie sich bei Ihrem Konto an.

2. Wählen Sie das Symbol Menü Navigation und klicken Sie dann auf Infrastruktur > Netzwerk > Private Trassendienste.

3. Klicken Sie auf Erstellen.

4. Überprüfen Sie die Checkliste auf wichtige Informationen.

5. Stellen Sie im Abschnitt "Position" sicher, dass die folgenden Felder korrekt sind: Wenn dies nicht der Fall ist, klicken Sie zum Aktualisieren auf das Symbol 'Bearbeiten' .

   • Geografie: Der allgemeine Bereich, in dem Sie den Private Path Service erstellen möchten
   • Region: Die Region, in der Sie den Dienst "Private Trasse" erstellen möchten.

6. Geben Sie im Abschnitt Details die folgenden Informationen an:

   • Name: Geben Sie eine eindeutige ID für den Private Path-Service ein, z. B. my-privatepath-service.
   • Ressourcengruppe: Wählen Sie bei Bedarf eine Ressourcengruppe aus.
   • Tags: Optional können Sie alle relevanten Tags hinzufügen, um Ihre Services für private Pfade zu gruppieren.
   • Zugriffsmanagementtags: Optional können Sie Zugriffsmanagementtags zu Ressourcen hinzufügen, um Zugriffssteuerungsbeziehungen zu organisieren. Das einzige unterstützte Format für Zugriffsverwaltungstags ist key:value. Weitere Informationen finden Sie unter Zugriff auf Ressourcen mithilfe von Tags steuern.
   • Virtual Private Cloud: Wählen Sie die VPC aus, auf der der Private Path-Service erstellt werden soll.

7. Wählen Sie im Abschnitt Private Path Network Load Balancer einen Private Path NLB für den Private Path Service aus, oder klicken Sie auf Create, um einen zu erstellen. Gehen Sie folgendermaßen vor, um einen NLB mit privatem Pfad zu erstellen:

   Klicken Sie auf Weiter, um mit dem nächsten Schritt fortzufahren, oder verwenden Sie das Navigationsmenü auf der linken Seite, um zu einem bestimmten Abschnitt zurückzukehren.

   1. Geben Sie im Abschnitt "Details definieren" die folgenden Informationen an:

      • Name: Geben Sie eine eindeutige ID für die NLB des privaten Pfads ein, z. B. my-privatepath-service.
      • Ressourcengruppe: Wählen Sie eine Ressourcengruppe für die NLB des privaten Pfads aus.
      • Tags: Optional können Sie alle relevanten Tags hinzufügen, um Ihre NLBs für den privaten Pfad zu gruppieren.
      • Zugriffsmanagementtags: Optional können Sie Zugriffsmanagementtags zu Ressourcen hinzufügen, um Zugriffssteuerungsbeziehungen zu organisieren. Das einzige unterstützte Format für Zugriffsverwaltungstags ist key:value. Weitere Informationen finden Sie unter Steuerung des Zugriffs auf Ressourcen mit Hilfe von Tags.
      • Teilnetz: Wählen Sie das Teilnetz aus, in dem die NLB für den privaten Pfad erstellt werden soll.

   2. Optional im Abschnitt "Back-End-Pool erstellen":

      • Name: Geben Sie eine eindeutige ID für die NLB des privaten Pfads ein, z. B. my-ppnlb.

      • Wählen Sie die Methode aus, d. h. den Algorithmus für den Lastausgleich. Die nachfolgend genannten Optionen werden angezeigt.

        • Round robin- Leitet Anfragen nacheinander an jede Instanz weiter. Auf diese Weise erhalten alle Instanzen ungefähr gleich viele Clientverbindungen.
        • Gewichtetes Round-Robin-Verfahren- Leitet Anfragen an jede Instanz im Verhältnis zu ihrem zugewiesenen Gewicht weiter. Wenn Sie beispielsweise über die Instanzen A, B und C verfügen und ihre Gewichtungen auf 60, 60 und 30 gesetzt sind, erhalten die Instanzen A und B eine gleiche Anzahl von Verbindungen und die Instanz C erhält halb so viele Verbindungen.

        Gehen Sie im Abschnitt "Statusprüfung" wie folgt vor:

        • Pfad für die Gesundheitsprüfung- Der Pfad für die Gesundheitsprüfung ist nur anwendbar, wenn Sie HTTP als Protokoll für die Gesundheitsprüfung auswählen. Der Pfad für Statusprüfung gibt die URL an, die von der Lastausgleichsfunktion verwendet wird, um die HTTP-Anforderungen für die Statusprüfung an die Instanzen im Pool zu senden. Standardmäßig werden Statusprüfungen an den Rootpfad (/) gesendet.
        • Statusprotokoll: Gibt an, welches Protokoll von der Lastausgleichsfunktion verwendet wird, um Nachrichten für Statusprüfungen an die Instanzen im Pool zu senden.
        • Health port- Der Port, auf dem der Load Balancer Health Check-Anfragen sendet. Standardmäßig werden Statusprüfungen über denselben Port gesendet, der auch für den Datenverkehr an die Instanz verwendet wird.
        • Intervall - Das Intervall in Sekunden zwischen zwei aufeinanderfolgenden Zustandsprüfungsversuchen. Standardmäßig werden Statusprüfungsanforderungen alle 5 Sekunden gesendet.
        • Timeout- Die maximale Zeitspanne, die das System auf eine Antwort auf eine Health Check-Anfrage wartet. Standardmäßig wartet die Lastausgleichsfunktion 2 Sekunden auf eine Antwort.
        • Max retries- Die maximale Anzahl der Zustandsprüfungsversuche, die der Load Balancer unternimmt, bevor eine Instanz für ungültig erklärt wird. Standardmäßig wird für eine Instanz nach zwei fehlgeschlagenen Statusprüfungen ein nicht einwandfreier Zustand attestiert.

        Obwohl der Load Balancer keine Verbindungen mehr an ungesunde Instanzen sendet, überwacht er weiterhin den Zustand dieser Instanzen und nimmt ihre Nutzung wieder auf, wenn sie wieder als gesund befunden werden (d. h. wenn sie zwei aufeinanderfolgende Zustandsprüfungsversuche erfolgreich bestehen).

      Wenn die Instanzen im Pool ungesund sind und Sie glauben, dass Ihre Anwendung korrekt funktioniert, überprüfen Sie die Werte für das Gesundheitsprotokoll und den Gesundheitspfad. Außerdem sollten Sie alle Sicherheitsgruppen überprüfen, die den Instanzen zugeordnet sind, um sicherzustellen, dass die Regeln den Datenverkehr zwischen der Lastausgleichsfunktion und den Instanzen zulassen.

      • Klicken Sie auf Speichern. Wiederholen Sie diesen Schritt, wenn Sie einen weiteren Back-End-Pool erstellen wollen.

   3. Optional können Sie im Abschnitt "Mitglieder anhängen" die folgenden Informationen angeben und dann auf "Anhängen" klicken:

      • Back-End-Pool: Wählen Sie den Back-End-Pool aus, dem Server zugeordnet werden sollen.

      • Subnetz: Suchen Sie in der Tabelle nach bestimmten Subnetzen und aktivieren Sie das Kontrollkästchen neben den Subnetzen, die Sie anhängen möchten. Geben Sie in der Spalte "Port" eine Portnummer für jedes ausgewählte Subnetz ein.

      • Mitgliedstyp: Fügen Sie virtuelle Serverinstanzen, reservierte IPs oder einen Application Load Balancer als Mitglied hinzu. Bei virtuellen Serverinstanzen fügen Sie jeden Typ einzeln hinzu. Ein reserviertes IP-Mitglied kann an einen Bare Metal Server, eine primäre oder sekundäre Schnittstelle einer virtuellen Serverinstanz oder eine virtuelle Netzwerkschnittstelle gebunden sein.

        Wenn Sie einen ALB als Mitgliedsziel an einen NLB-Pool mit privatem Pfad anhängen, können keine weiteren Mitglieder zu diesem Pool hinzugefügt werden.

   4. Optional können Sie im Abschnitt "Front-End-Listener hinzufügen" den Back-End-Pool auswählen, an den Sie Ihren Front-End-Listener anhängen möchten. Wählen Sie dann den Listener-Port-Wert aus und klicken auf Speichern. Wiederholen Sie diesen Schritt, um einen weiteren Front-End-Listener zu erstellen.

   5. Bestätigen Sie im Abschnitt "Überprüfung", dass die von Ihnen übergebenen Informationen korrekt sind. Überprüfen Sie die Zusammenfassung der Bestellung und klicken Sie dann auf Erstellen.

      Es dauert ein paar Minuten, bis Ihr Private Path NLB erstellt ist. Wenn die Lastausgleichsfunktion erstellt wird, ändert sich ihr Status in der Tabelle von Wird erstellt in Aktiv.

8. Klicken Sie im Abschnitt Dienstendpunkt auf Erstellen. Geben Sie einen Namen für den Endpunkt des Dienstes an, mit dem Sie Ihren Privatpfaddienst verbinden möchten. Bestätigen Sie dann den Besitz des FQDN-Domänennamens und klicken Sie auf Hinzufügen. Weitere Informationen finden Sie unter Registrieren und Überprüfen der Eigentümerschaft von Dienstendpunkten(FQDNs).

9. Wählen Sie diese Option, um die zonale Affinität für die Dienstendpunkte zu aktivieren oder zu deaktivieren. Wenn die Zonenaffinität aktiviert ist, verwaltet der Endpunkt die Persistenz für die Zone, nachdem die Verbindung erstellt wurde.

10. Gehen Sie im Abschnitt 'Accountrichtlinien' wie folgt vor:

    • Die Standardrichtlinie ist so festgelegt, dass jede eingehende Verbindungsanforderung geprüft und eine Triage durchgeführt wird. Sie können die Standardrichtlinie ändern, um alle Anforderungen ohne Prüfung zuzulassen oder zurückzuweisen.
    • Um Kontorichtlinien zu erstellen, die sich von der Standardrichtlinie unterscheiden, klicken Sie auf Erstellen. Geben Sie die Konto-ID des Kontos an, für das Sie eine Richtlinie einrichten möchten. Wählen Sie für die Option Kontorichtlinie die Option Prüfen, Zulassen oder Ablehnen.

    Einzelne Accountrichtlinien haben Vorrang vor der Standardrichtlinie.

11. Überprüfen Sie die Übersichtsseite und klicken Sie dann auf Erstellen, um Ihren privaten Trassendienst zu bestellen.

    Nach Abschluss der Bereitstellung gibt der Servicestatus "Privater Pfad" Stable in der Tabelle "Private Pfadservices für VPC" an.

Erstellen eines Privatpfaddienstes über die CLI

Das folgende Beispiel zeigt, wie die Befehlszeilenschnittstelle zum Erstellen eines Private Path-Service verwendet wird.

Zur Vorbereitung müssen Sie Ihre CLI-Umgebung einrichten.

Gehen Sie folgendermaßen vor, um einen Privatpfaddienst über die CLI zu erstellen:

1. Geben Sie den folgenden Befehl ein:

ibmcloud is private-path-service-gateway-create
    [--load balancer LOAD_BALANCER]
    [--service-endpoints SERVICE_ENDPOINTS]
    [--default-access-policy | deny | permit | review]
    [--name NAME]
    [--zonal-affinity | true | false]
    [--output JSON] [-q, --quiet]

Dabei gilt:

--load-balancer

Gibt die ID oder den Namen des Load Balancers für diesen Private Path Service an.

--service-endpoints

Gibt die vollständig qualifizierten Domänennamen für diesen Dienst "Privater Pfad" an. Alle Großbuchstaben werden in Kleinbuchstaben konvertiert.

--default-access-policy

Gibt die Richtlinie an, die für Bindungen von Konten ohne explizite Kontorichtlinie verwendet werden soll. Eine der folgenden Optionen: deny, permit, review (Standardwert: deny)

--name

Gibt den Namen für diesen Dienst der privaten Trasse an.

--zonal-affinity

gibt an, ob dieser Dienst der privaten Trasse eine zonale Affinität hat. Einer von: false, true.

--output

Gibt das Ausgabeformat an. Es wird nur JSON unterstützt. Einer der folgenden Werte: JSON.

-q, --quiet

Ausführliche Ausgabe unterdrücken.

Erstellen eines Dienstes für einen privaten Pfad mit der API

Gehen Sie folgendermaßen vor, um einen Dienst für einen privaten Pfad mit der API zu erstellen:

1. Richten Sie die API-Umgebung ein.

2. Speichern Sie die folgenden Werte in Variablen, damit diese im API-Befehl verwendet werden können:

   • loadBalancerId-Zuerst rufen Sie Ihre Lastausgleichsfunktion ab und füllen Sie dann die Variable:

     export loadBalancerId=<your_loadbalancer_id>
     

3. Wenn alle Variablen initiiert sind, um einen privaten Pfaddienst zu erstellen:

   curl -X POST -sH "Authorization:${iam_token}" \
   "$vpc_api_endpoint/v1/private_path_service_gateways?version=$api_version&generation=2" \
   -d {
     "default_access_policy": "review",
     "load_balancer": {
       "id": "$loadBalancerId"
     },
     "name": "my-ppsg",
     "service_endpoints": ["example.com"],
     "zonal_affinity": false
   }'
   

Erstellen eines privaten Pfaddienstes mit Terraform

Das folgende Beispiel stellt ein Private Path Netzwerk mit Terraform bereit:

resource "ibm_is_private_path_service_gateway" "ppsg" {
    default_access_policy = "deny"
    load_balancer = ibm_is_lb.ppnlb.id
    service_endpoints = ["my-service.example.com"]
    zonal_affinity = false
    name = "my-example-ppsg"
}

Die Dokumentation zu Terraform-Ressourcen finden Sie in der Terraform-Registry.