Hinweis:
- Dieses Tutorial erfordert Zugriff auf Oracle Cloud. Informationen zum Anmelden für einen kostenlosen Account finden Sie unter Erste Schritte mit Oracle Cloud Infrastructure Free Tier.
- Es verwendet Beispielwerte für Oracle Cloud Infrastructure-Zugangsdaten, -Mandanten und -Compartments. Wenn Sie Ihre Übung abgeschlossen haben, ersetzen Sie diese Werte durch die Werte, die für Ihre Cloud-Umgebung spezifisch sind.
Privates OCI Streaming-Thema hinter einem API-Gateway mit OCI-REST-API-Aufruf konsumieren
Einführung
Der Oracle Cloud Infrastructure-(OCI-)Streaming-Service stellt eine vollständig verwaltete, skalierbare und dauerhafte Lösung zur Aufnahme und Nutzung von Datenstreams mit hohem Volumen in Echtzeit bereit. Verwenden Sie OCI Streaming für jeden Anwendungsfall, in dem kontinuierlich und sequenziell Daten in einem Publish-Subscribe-Messagingmodell erzeugt und verarbeitet werden.
In diesem Szenario müssen wir ein privates OCI Streaming-Thema mit einem öffentlichen API-Gateway bereitstellen und konsumieren, um den Zugriff zu kontrollieren und zu sichern.
Zielsetzung
In diesem Tutorial wird gezeigt, wie Sie das OCI-Streaming-Thema mit API-Gateway-REST-API-Aufrufen konsumieren.
Voraussetzungen
- Oracle-Account mit Zugriffsberechtigungen auf Admin-Ebene
- Ein Compartment zum Erstellen Ihrer Ressourcen
- Lokales OCI-CLI-Setup. Wenn Sie Hilfe benötigen, lesen Sie CLI-Tutorial installieren
- VCN mit zwei Subnetzen (privat und öffentlich) finden Sie unter Netzwerk-Tutorial erstellen
- Stellen Sie sicher, dass die Subnetze über die richtigen Ingress-Regeln für Servicegateway und Port 443 für private und öffentliche Subnetze verfügen.
- OCI Streaming-Thema OCI-Stream-Tutorial erstellen
- Lokale Python-Version 3 zum Testen installiert
Aufgabe 1: Details aus OCI Streaming abrufen
-
Gehen Sie zu Ihrem Stream, und notieren Sie die OCID. Klicken Sie unter Messaging auf Analysen und KI, klicken Sie auf Streaming, und wählen Sie Ihren Stream aus.
-
Beachten Sie die OCID und den Nachrichtenendpunkt, die Sie für Ihr API-Gateway benötigen.
Aufgabe 2: Öffentliches API-Gateway erstellen
-
Klicken Sie auf Entwicklerservices, und klicken Sie unter API-Management auf Gateways, und klicken Sie auf Gateway erstellen.
Aufgabe 3: Deployment für das API-Gateway erstellen
-
Wählen Sie das in Aufgabe 2 erstellte API-Gateway aus, klicken Sie auf Deployments, und klicken Sie dann auf Deployment erstellen.
-
Erstellen Sie jetzt das Präfix, indem Sie your_ocid_for_stream durch die folgende Stream-OCID ersetzen. Geben Sie den Namen als publicTopic ein.
/20180418/streams/your_ocid_for_stream
-
Klicken Sie anschließend auf Weiter.
-
Klicken Sie anschließend auf Weiter.
-
Route 1 für groupCursors erstellen: Erstellen Sie die URL mit dem Endpunkt und der Stream-OCID, die Sie in Aufgabe 2 dieses Tutorials erfasst haben, und erstellen Sie die URL.
<streaming_endpoint>/20180418/streams/<stream_ocid>/groupCursors
Hinweis: Um den Stream zu konsumieren, verwendet die OCI-REST-API für Streaming zwei Endpunkte groupCursors und Nachrichten, die Sie erstellen müssen. Geben Sie jetzt die erforderlichen Informationen wie Pfad, Methoden, Backend-Typ wie folgt an:
-
Klicken Sie auf +Another route, und fügen Sie Route 2 für Nachrichten hinzu: Verwenden Sie dieselbe URL, aber mit dem anderen Endpunkt am Ende als /messages.
-
Gehen Sie zu publicTopic, und notieren Sie sich den Endpunkt des API-Gateways.
Aufgabe 4: Testnachrichten auf dem Streaming generieren
-
Gehen Sie zur Seite "Streaming", und klicken Sie auf Testnachricht erstellen.
-
Diese Nachrichten werden in Aufgabe 5 verwendet.
Aufgabe 5: OCI-Streaming über REST-API hinter dem API-Gateway konsumieren
-
Laden Sie den Python-Beispielnutzungscode consume_rest_api_oci_lab.py herunter.
-
Ändern Sie die Werte für den API Gateway-Endpunkt und die Stream-OCID, wie mit den Werten angegeben, die Sie zuvor in diesem Tutorial erfasst haben.
-
Führen Sie Ihren Python-Code aus, um zu prüfen, ob er funktioniert.
python3 consume_rest_api_oci_lab.py
Verwandte Links
Bestätigungen
- Autor - Joao Tarla (Oracle LAD A-Team Solution Engineer)
Weitere Lernressourcen
Sehen Sie sich andere Übungen zu docs.oracle.com/learn an, oder greifen Sie auf weitere kostenlose Lerninhalte im Oracle Learning YouTube-Kanal zu. Besuchen Sie außerdem die Website education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.
Produktdokumentation finden Sie im Oracle Help Center.
Consume a private OCI Streaming topic behind an API Gateway using OCI REST API call
F80887-01
April 2023
Copyright © 2023, Oracle and/or its affiliates.