OCI Object Storage und Oracle API Gateway für statisches Websitehosting einrichten

Einführung

Wenn Sie über eine Webanwendung verfügen, die auf Oracle Cloud Infrastructure (OCI) gehostet werden soll, und das statische Websitehosting einrichten möchten, führen wir in diesem Tutorial die Konfiguration des statischen Hostings einer umfassenden Ahead-of-Time-(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 in Oracle Cloud Infrastructure bereitzustellen und zu verwalten.

Voraussetzungen

Aufgabe 1: Oracle Object Storage-Bucket erstellen

Erstellen Sie zunächst einen neuen Bucket in OCI Object Storage. Dieser Bucket wird zum Hosten Ihrer statischen Website verwendet.

Objektspeicher-Bucket

Aufgabe 2: Verteilungsdateien im Bucket hochladen

Laden Sie die Anwendungsverteilungsdateien in den Bucket hoch, der in der vorherigen Aufgabe erstellt wurde. Die Anwendungsverteilungsdateien befinden sich im Allgemeinen im Ordner /dist des Anwendungsverzeichnisses und sind die Ausgabe des Webpack-Builds.

Verteilungsdateien

Tipp: Wenn Sie die Dateien mit oci-cli hochladen möchten, müssen Sie den Parameter --content-type auto angeben, um sicherzustellen, dass der Content-Type korrekt festgelegt wird.

Aufgabe 3: Vorab authentifizierte Anfrage erstellen

Damit das Oracle API Gateway die Verteilungsdateien über das Internet verarbeiten kann, müssen Sie eine vorab authentifizierte PAR-Anforderung 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 über Ihr Netzwerk zugegriffen werden kann. Sie können aber auch öffentliche IP-Adressen angeben, wenn Internettraffic akzeptiert werden soll. 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.

  1. 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. Create a VCN if one is not already created.

Oracle API Gateway

Aufgabe 5: Oracle API Gateway-Deployment einrichten

Nachdem das Oracle API Gateway erfolgreich erstellt wurde, navigieren Sie zu Deployments, und erstellen Sie ein neues Deployment.

  1. Wählen Sie Von Grund auf erstellen, und setzen Sie das Pfadpräfix auf "/". Dies ist der Basispfad der URL.

    Gateway-Deployment

  2. Richten Sie TLS, CORS usw. hier ein, oder klicken Sie auf Weiter, um zum nächsten Schritt zu gelangen.

  3. Wählen Sie Keine Authentifizierung aus, und klicken Sie auf Weiter. Wir müssen keine Authentifizierung für unsere statische Website hinzufügen.

    Deployment-Autorisierung

Aufgabe 6: Routen hinzufügen

Fügen Sie im API-Deployment-Assistenten Routen hinzu, die den Basispfad für unsere Deployments erweitern.

  1. Geben Sie /{req*} in das Pfadfeld ein.

    Bereitstellungspfad

  2. Wählen Sie GET aus der Dropdown-Liste Methoden.

  3. Wählen Sie Mehrere Backends bearbeiten aus.

    Deployment mehrerer Backends

  4. Wählen Sie Pfad im Auswahlfeld aus.

    Bereitstellungspfad

  5. Klicken Sie auf Backend definieren.

  6. 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.

    Backend-Definition

  7. Erstellen Sie eine js-Dateiregel, 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[req]} 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]}

  8. Klicken Sie auf Erstellen.

    Backend-Definition

  9. Erstellen Sie nach Bedarf ähnliche Regeln für CSS-, HTML-, TXT- und JSON-Dateien.

    Backend definieren alle

  10. Click Next and complete the creation of Oracle API Gateway and wait for it to get updated.

7. Aufgabe: Test

Rufen Sie die Deployment-URL ab, und geben Sie sie in Ihren Webbrowser ein. In diesem Fall sollte Ihre Anwendung angezeigt werden.

Hinweise:

  1. Wenn die Anwendung nicht geladen wird, prüfen Sie, ob Ihre Sicherheitsliste oder Netzwerksicherheitsgruppe in Ihrem VCN Traffic zu Oracle API Gateway zulässt.

  2. Vergessen Sie nicht, alle verschiedenen Dateitypen Ihrer Anwendung in der Backend-Definition hinzuzufügen.

  3. 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.

Bestätigungen

Autor – Mayank Kakani (OCI Cloud Architect)

Weitere Lernressourcen

Sehen Sie sich weitere Übungen zu docs.oracle.com/learn an, oder greifen Sie auf weitere kostenlose Lerninhalte im Oracle Learning YouTube-Kanal zu. Besuchen Sie außerdem education.oracle.com/learning-explorer, um ein Oracle Learning Explorer zu werden.

Die Produktdokumentation finden Sie im Oracle Help Center.