Netlify

Die Netlify-App integriert die Contentful Web-App mit Netlify. Wenn Content-Änderungen von Contentful zu Netlify über eine kontinuierliche Bereitstellung übermittelt werden, können Editor*innen den Fortschritt des Build-Prozesses innerhalb der Web-App verfolgen.

Die Netlify-App bietet die folgenden Funktionen:

• Nutzer*innen eines Space können einen Build einer Netlify-Site auslösen.

• Zeigt den Build-Status in der Contentful Web-App an, sodass Editor*innen Build-Updates in Echtzeit sehen können.

Um diese App zu verwenden, benötigen Sie:

• Eine Website, die die folgenden Anforderungen erfüllt:

  • Sie muss mit einem statischen Website-Generator (z. B. Middleman, Hugo usw.) erstellt worden sein.

  • Sie muss Content aus Contentful abrufen.

  • Sie muss in ein Remote-Repository gepusht sein, damit Netlify den Code der Website beim Erstellen abrufen kann.

• Ein Netlify-Setup mit folgenden Elementen:

  • Ein Konto auf Netlify.

  • Eine Website auf Netlify, die mit dem oben genannten Repository verbunden ist (die Website muss für die kontinuierliche Bereitstellung aktiviert sein).

Intern führt die App die folgenden Schritte aus:

1. Authentifiziert sich bei Netlify über OAuth.

2. Sie werden aufgefordert, Websites aus Ihrem Netlify-Konto auszuwählen, die erstellt werden sollen.

3. Erstellt einen eingehenden Build-Hook, um den Netlify-Build auszulösen.

4. Sie benachrichtigt Contentful, wenn der Build den Status ändert (z. B. erfolgreich oder fehlgeschlagen).

5. Fügt ein neues Seitenleisten-Widget in Contentful hinzu, das den Build auslösen und die Website öffnen kann.

Schritt 1: Installieren und konfigurieren

Klicken Sie auf Verbinden …, um sich bei Netlify zu authentifizieren:

Dadurch wird die App autorisiert, in Ihrem Namen API-Interaktionen zwischen Contentful und Netlify vorzunehmen.

Schritt 2: Konfigurieren Sie Netlify-Websites, um sie aus Contentful zu erstellen

Verwenden Sie das Dropdown-Menü, um eine Website auf Netlify auszuwählen, die Sie erstellen möchten. Beachten Sie, dass die Website die kontinuierliche Bereitstellung aktiviert haben muss. Normalerweise ist es sinnvoll, zwei Websites zu haben:

• Eine erste Site, auf der Sie gatsby-netlify-contentful erstellen und das Label Produktion verwenden

• Eine zweite Site, auf der Sie gatsby-netlify-contentful-preview erstellen und das Label Vorschau verwenden

Eine Produktions- und Vorschau-Website ist keine Voraussetzung, wird jedoch dringend empfohlen. Mit diesem Setup können Sie sicherstellen, dass Ihre Änderungen richtig erscheinen, bevor Sie sie in die Produktion überführen.

Schritt 3: Verwenden Sie das Netlify-Build-Widget im Eintragseditor

Die Netlify-App erstellt ein benutzerdefiniertes Widget für die Content-Vorschau.

Das Widget zeigt eine Build-Schaltfläche und:

• Den Status des Builds.

• Wer den letzten Build ausgelöst hat und wann.

Sie zeigt auch eine Schaltfläche Website öffnen an, die die URL Ihrer Netlify-Website öffnet, die im Konfigurationsschritt ausgewählt wurde.

Was passiert mit dem OAuth-Token, das die Contentful Web-App während der Konfiguration der Netlify-App erhalten hat?

Das Token wird nur während der Konfigurationsphase der App verwendet und nicht gespeichert. Daher müssen Sie sich jedes Mal neu authentifizieren, wenn Sie die Konfiguration der App ändern möchten.

Wer kann Netlify-Builds mit dieser App auslösen?

Die Installation und Konfiguration der Netlify-App ist nur für Admins zugänglich. Das von der App bereitgestellte neue Build-Widget ist jedoch für alle Nutzer*innen mit Content-Zugriff zugänglich.