Szenario

Das Szenario für dieses Lernprogramm vereinfacht das Web-Hosting auf seine Grundlagen, um die beteiligten Schritte hervorzuheben. Obwohl nicht jede Konfigurationsoption in diesem Lernprogramm behandelt wird, führt das ordnungsgemäße Durcharbeiten dieses Lernprogramms zu Inhalten, auf die über das Web zugegriffen werden kann.

Vorbemerkungen

Stellen Sie sicher, dass Sie über das verfügen, was Sie starten müssen:

• Ein Konto für IBM Cloud Platform
• Eine Instanz von IBM Cloud Object Storage
• Inhalt in fester Form, wie Text (HTML wäre perfekt) und Bilddateien

Überprüfen Sie, ob Sie den entsprechenden Zugriff auf die Instanz von IBM Cloud Object Storage haben, die Sie verwenden werden, oder auf die entsprechenden Berechtigungen für die Buckets, die Sie für dieses Lernprogramm verwenden werden.

Zur Verwendung der IBM Cloud-CLI in diesem Lernprogramm müssen Sie das Object Storage-Plug-in konfigurieren, um die Serviceinstanz, die Sie verwenden wollen, und die Standardregion anzugeben, in der Ihr neues Bucket erstellt werden soll.

Für öffentlichen Zugriff konfiguriertes Bucket erstellen

Das Erstellen eines Buckets für eine statische Website erfordert öffentlichen Zugriff. Es gibt eine Reihe von Optionen für die Konfiguration des öffentlichen Zugriffs. Insbesondere wird durch die Verwendung der IAM-Rolle ObjectReader verhindert, dass der Inhalt des Buckets aufgelistet wird, ohne dass der statische Inhalt im Internet angezeigt werden kann. Wenn Sie das Anzeigen der Inhaltsliste zulassen wollen, verwenden Sie die IAM-Rolle ContentReader für Ihr Bucket.

ibmcloud cos bucket-create --bucket <bucketname>

Inhalt in Ihr Bucket hochladen

Der Inhalt Ihrer gehosteten statischen Website-Dateien konzentriert sich natürlich auf Informationen und Medien. Ein gängiger Ansatz zum Erstellen von Inhalten für statische Websites sind Open-Source-Generatoren, die unter StaticGenaufgelistet sind. Für die Zwecke dieses Lernprogramms werden nur zwei Dateien benötigt:

• Eine in der Regel in HTML geschriebene Indexseite mit dem Namen index.html, die standardmäßig für Besucher Ihrer Site geladen wird.
• Eine Fehlerseite, auch in HTML und hier namens error.html. Normalerweise wird die Fehlerseite geladen, wenn ein Besucher versucht, auf ein Objekt zuzugreifen, das nicht vorhanden ist oder keinen öffentlichen Zugriff hat.

Andere Dateien wie Bilder, PDFs oder Videos können ebenfalls in Ihr Bucket hochgeladen werden (dieses Lernprogramm konzentriert sich jedoch nur auf eine Mindestgruppe von Anforderungen).

Stellen Sie im Rahmen dieses Lernprogramms die HTML-Seiten für den Index und die Fehlerbehandlung in ein lokales Verzeichnis. Ersetzen Sie den Platzhalterinhalt wie im Beispielbefehl gezeigt, um Ihre HTML-Dateien hochzuladen:

ibmcloud cos object-put --bucket BUCKET_NAME --key KEY [--body FILE_PATH]

Möglicherweise haben Sie die Basiskonfiguration für das Hosting Ihrer statischen Website bereits abgeschlossen. Dateien können direkt in die Konsole hochgeladen werden, nachdem Sie Ihr Bucket benannt und konfiguriert haben. Beachten Sie, dass der Schritt optional ist, wie in Abbildung 4 dargestellt, und jederzeit vor dem Testen Ihrer neuen gehosteten Website auftreten kann.

Für den Rest des Lernprogramms wird angenommen, dass der Objektschlüssel für die Indexseite index.html und der Schlüssel für das Fehlerdokument error.html ist, obwohl jeder geeignete Dateiname für das Suffix oder den Schlüssel verwendet werden kann.

Optionen für Ihre Website konfigurieren

Es gibt mehr Optionen, als dieses Lernprogramm beschreiben kann, und für den Zweck dieses Lernprogramms müssen wir nur die Konfiguration festlegen, um mit der Verwendung der statischen Website-Funktion zu beginnen.

Erstellen Sie eine JSON-Datei mit den entsprechenden Konfigurationsdaten:

{
  "ErrorDocument": {
    "Key": "error.html"
  },
  "IndexDocument": {
    "Suffix": "index.html"
  }
}

Ersetzen Sie den Platzhalterinhalt wie im Beispielbefehl gezeigt, um die Website zu konfigurieren:

ibmcloud cos bucket-website-put --bucket BUCKET_NAME --website-configuration file://<filename.json>

Möglicherweise haben Sie diesen Schritt während der Erstellung Ihres Buckets ausgeführt, da die Basiskonfiguration für Ihre gehostete statische Website bestimmt, wann und wie Inhalt angezeigt wird. Für Besucher Ihrer Website, die keinen Schlüssel oder keine Webseite bereitstellen, wird stattdessen die Standarddatei angezeigt. Wenn Ihre Benutzer auf einen Fehler stoßen, bestimmt der Schlüssel für die Fehlerseite, welche Inhalte Besucher erhalten. Die Konfigurationsoptionen für die Standard-und Fehlerseiten werden zur Referenz wiederholt.

http://<bucketname>.s3-web.<endpoint>/

Nächste Schritte

Eine ausführliche Beschreibung der Konfigurationsoptionen für IBM Cloud Object Storage gehostete statische Websites finden Sie in der API-Dokumentation.