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.
OCI Object Storage und Oracle API Gateway für statisches Website-Hosting einrichten
Einführung
Wenn Sie eine Webanwendung haben, die Sie auf Oracle Cloud Infrastructure (OCI) hosten möchten und statisches Website-Hosting einrichten möchten, führen Sie in diesem Tutorial die Konfiguration des statischen Hostings einer AOT-kompilierten JavaScript-Webanwendung mit OCI Object Storage und Oracle API Gateway durch. Der gleiche Ansatz kann auf jedes Szenario angewendet werden, in dem Sie eine statische Datei über HTTP bereitstellen möchten, sei es für eine einfachere App oder statische Webseiten und Ihren Benutzern auf der OCI-Plattform eine zuverlässige Online-Erfahrung zu geringeren Kosten bieten.
Ziele
Erfahren Sie, wie Sie mit OCI Object Storage und Oracle API Gateway statische Websites hosten, um Webinhalte effizient auf Oracle Cloud Infrastructure bereitzustellen und zu verwalten.
Voraussetzungen
- Zugriff auf einen Oracle Cloud-Mandanten.
- Eine AOT-kompatible Anwendung (unterstützte Frameworks und Bibliotheken sind Angular 2+, ReactJs, NestJs, VueJs, Ionic usw.)
Aufgabe 1: Oracle Object Storage-Bucket erstellen
Beginnen wir mit dem Erstellen eines neuen Buckets in OCI Object Storage. Dieser Bucket wird zum Hosten Ihrer statischen Website verwendet.
Aufgabe 2: Verteilungsdateien in den Bucket hochladen
Laden Sie die Anwendungsverteilungsdateien in den Bucket hoch, der in der vorherigen Aufgabe erstellt wurde. Ihre Anwendungsverteilungsdateien befinden sich in der Regel im Ordner /dist
Ihres Anwendungsverzeichnisses und sind die Ausgabe des Webpack-Builds.
Aufgabe 3: Vorab authentifizierte Anforderung erstellen
Damit Oracle API Gateway die Verteilungsdateien über das Internet bereitstellen kann, müssen Sie eine vorab authentifizierte Anforderung PAR für den Objektspeicher-Bucket erstellen, in dem Verteilungsdateien gespeichert werden.
Dies wird bei der Konfiguration des API-Gateways verwendet.
Aufgabe 4: Oracle API Gateway erstellen
Mit dem Oracle API Gateway-Service können Sie APIs mit privaten Endpunkten veröffentlichen, auf die Sie über Ihr Netzwerk zugreifen können. Sie können aber auch öffentliche IP-Adressen dafür angeben. Die Endpunkte unterstützen API-Validierung, Anforderungs- und Antworttransformation, CORS, Authentifizierung und Autorisierung sowie Anforderungsbegrenzung. Weitere Informationen finden Sie unter Überblick über Oracle API Gateway.
- Navigieren Sie zu OCI-Menü, Entwicklerservices, API-Gateway, und klicken Sie auf Erstellen.
Hinweis: Sie benötigen ein virtuelles Cloud-Netzwerk, um dieses Oracle API Gateway bereitzustellen. Erstellen Sie ein VCN, falls es noch nicht erstellt wurde.
Aufgabe 5: Oracle API Gateway-Deployment einrichten
Nachdem Oracle API Gateway erfolgreich erstellt wurde, navigieren Sie zu Deployments, und erstellen Sie ein neues Deployment.
-
Wählen Sie Von Grund auf erstellen, und setzen Sie das Pfadpräfix auf "/". Dies ist der Basispfad der URL.
-
Richten Sie TLS, CORS usw. hier ein, oder klicken Sie auf Next, um zum nächsten Schritt zu gelangen.
-
Wählen Sie Keine Authentifizierung, und klicken Sie auf Weiter. Wir müssen keine Autorisierung für unsere statische Website hinzufügen.
Aufgabe 6: Routen hinzufügen
Fügen Sie im API-Deployment-Assistenten Routen hinzu, die den Basispfad für unsere Deployments erweitern.
-
Geben Sie /{req*} in das Pfadfeld ein.
-
Wählen Sie in der Dropdown-Liste Methods die Option GET.
-
Wählen Sie Hinzufügen mehrerer Backends bearbeiten aus.
-
Wählen Sie im Auswahlfeld Pfad aus.
-
Klicken Sie auf Backend definieren.
-
Erstellen Sie eine Standardregel, geben Sie Name als Standard, Übereinstimmungstyp als Beliebig von ein, und aktivieren Sie das Kontrollkästchen Standard festlegen. Wählen Sie als Backend HTTP aus, und geben Sie die Objektspeicher-URL für die Seite index.html in das Feld Url ein, und klicken Sie auf Erstellen.
-
Erstellen Sie eine Dateiregel
js
, geben Sie Name als js-Regel, Übereinstimmungstyp als Platzhalter und *.js als Platzhalterausdruck ein, wählen Sie als Backend HTTP aus, und geben Sie die Objektspeicher-Bucket-URL gefolgt von der Seite {request.path[request]} im Feld Url ein, und klicken Sie auf Erstellen. Ihre URL sieht in etwa wie folgt aus:https://{namespace}.objectstorage.{region}.oci.customer-oci.com/n/{namespace}/b/{bucket-name}/o/${request.path[req]}
-
Klicken Sie auf Erstellen.
-
Erstellen Sie ähnliche Regeln für CSS-, HTML-, TXT- und Json-Dateien nach Ihren Wünschen.
-
Klicken Sie auf Weiter, schließen Sie die Erstellung von Oracle API Gateway ab, und warten Sie, bis es aktualisiert wird.
Aufgabe 7: Test
Rufen Sie die Deployment-URL ab, und geben Sie sie in Ihren Webbrowser ein. Dadurch wird Ihre Anwendung angezeigt.
Hinweise:
Wenn die Anwendung nicht geladen wird, prüfen Sie, ob Sie die richtige Policy für den Zugriff auf den Objektspeicher-Bucket durch Oracle API Gateway hinzugefügt haben.
Vergessen Sie nicht, alle verschiedenen Dateitypen Ihrer Anwendung in der Backend-Definition hinzuzufügen.
Nur AOT (Ahead of Time) kompilierte Anwendungen und statische Websites können mit dieser Technik eingerichtet werden. Stellen Sie sicher, dass Ihre Anwendung in nativem Javascript-Code kompiliert ist.
Danksagungen
Autor - Mayank Kakani (OCI Cloud Architect)
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. Besuchen Sie außerdem education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.
Produktdokumentation finden Sie im Oracle Help Center.
Set Up OCI Object Storage and Oracle API Gateway for Static Website Hosting
F87240-02
October 2023
Copyright © 2023, Oracle and/or its affiliates.