Hinweis:
- Dieses Tutorial erfordert Zugriff auf Oracle Cloud. Informationen zum Registrieren eines kostenlosen Accounts 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 spezifische Werte für Ihre Cloud-Umgebung.
Statische Website mit Oracle Cloud Infrastructure API Gateway bereitstellen
Einführung
Oracle Cloud Infrastructure (OCI) API Gateway ist ein serverloser, vollständig verwalteter Service in OCI, mit dem API-Endpunkte und Webanwendungen geschützt werden können. Es bietet viele Sicherheitsfunktionen wie Ratenbegrenzung, Autorisierungsdurchsetzung, dynamisches Routing, SSL-Durchsetzung usw. In diesem Tutorial erläutern wir, wie wir eine statische Website an OCI API Gateway pushen können, um als Website zu dienen
Ziele
- Stellen Sie eine statische Website für OCI API Gateway bereit, die als Website dient.
Voraussetzungen
-
Zugriff auf OCI API Gateway mit den entsprechenden Berechtigungen zum Konfigurieren des API-Gateways und des Deployments.
-
Eine statische Website, die hinter OCI API Gateway ausgeführt werden kann.
Aufgabe 1: Statische Website vorbereiten
Stellen Sie sicher, dass Sie Ihre statischen Website-Inhalte bereit haben. Dazu gehören HTML-, CSS-, Javascript-Dateien und alle anderen Assets, die auf Ihrer Website enthalten sind.
Aufgabe 2: Python-Skript ausführen, um eine json
-Datei zu erstellen
Laden Sie das Python-Skript von hier herunter: ap_gw.py. Das Skript akzeptiert zwei Eingaben: ein Verzeichnis, das alle Ihre statischen Website-Dateien enthält, und das Verzeichnis (mit dem Dateinamen), in dem die Datei json
gespeichert wird. Die ausgegebene json
-Datei kann dann im OCI-API-Gateway als Spezifikation hochgeladen werden, die separate Pfade für jede Datei erstellt, und die entsprechenden Pfade können innerhalb der Dateien neu formatiert werden, um das spezifische HTML, CSS, Javascript oder eine andere Datei zu erreichen, die hinter dem API-Gateway gehostet wird. Das OCI-API-Gateway hat eine Einschränkung, dass die maximal zulässige Bodygröße 4096 Byte beträgt. Wenn also beim Ausführen des Skripts die Bodygröße im Bodyabschnitt beim Erstellen der json
4096 Byte überschreitet, löst das Skript einen Fehler aus, und die Ausführung stoppt. Im Folgenden finden Sie ein Beispiel dafür, wie das Skript unter Windows ausgeführt werden kann.
Hinweis:
C:\Website
ist der Pfad, in dem sich die Websitedateien befinden.C:\Test\output.json
ist der Pfad, in dem die Dateijson
gespeichert wird.
Aufgabe 3: OCI-API-Gateway konfigurieren und Datei json
als API-Spezifikation im OCI-API-Gateway hochladen
-
Melden Sie sich bei der OCI-Konsole an, und navigieren Sie zu Entwicklerservices, API-Management und API-Gateway.
-
Gehen Sie unter Gateways zu Ihrem API-Gateway, in das Sie dieses Deployment ausführen möchten. Wenn Sie kein API-Gateway erstellt haben, klicken Sie auf Gateway erstellen, um ein API-Gateway zu erstellen.
-
Wählen Sie auf der Seite Gatewaydetails in der Liste Ressourcen die Option Deployment aus, und klicken Sie auf Deployment erstellen.
-
Geben Sie auf der Seite Einfache Details die folgenden Informationen ein, und klicken Sie auf Weiter. Darüber hinaus können Sie bei Bedarf auch Authentifizierung und andere Steuerelemente hinzufügen.
- Wählen Sie Vorhandene Deployment-API hochladen aus.
- Name: Geben Sie einen Deployment-Namen ein.
- Pfadpräfix: Geben Sie einen eindeutigen Pfad ein. Beispiel,
/
. - Spezifikation: Laden Sie die in Aufgabe 2 erstellte Datei
json
hoch.
-
Prüfen Sie das Deployment auf der Seite Überprüfen, und klicken Sie auf Erstellen.
Sobald dies erledigt ist, können Sie die Homepage Ihrer Website oder die index.html (oder einen anderen Pfad, je nachdem, welcher für Ihre Website zutrifft) durchsuchen. Jetzt können Sie die Homepage Ihrer Website oder die index.html
(oder einen anderen anwendbaren Pfad für Ihre Website) durchsuchen. Ihre Website wird jetzt hinter dem OCI-API-Gateway ausgeführt, auf das normalerweise über eine URL wie https://xxxxxxxxxxx.apigateway.us-ashburn-1.oci.customer-oci.com/index.html
zugegriffen werden kann.
Verwandte Links
Danksagungen
- Autor - Aqib Javid Bhat (Senior Cloud Engineer)
Weitere Lernressourcen
Lernen Sie andere Übungen auf docs.oracle.com/learn kennen, oder greifen Sie auf weitere kostenlose Lerninhalte im Oracle Learning YouTube Channel zu. Außerdem können Sie education.oracle.com/learning-explorer besuchen, um Oracle Learning Explorer zu werden.
Die Produktdokumentation finden Sie im Oracle Help Center.
Deploy a Static Website using Oracle Cloud Infrastructure API Gateway
G11487-01
July 2024