Netlify

L’application Netlify intègre l’application Web Contentful à Netlify. Lors du déploiement des modifications de contenu de Contentful à Netlify via la livraison continue, les éditeurs peuvent suivre la progression du processus de création à partir de l’application Web.

Aperçu

L’application Netlify offre les fonctionnalités suivantes :

• Permet aux utilisateurs d’un espace de déclencher la création d’un site Netlify

• Affiche l’état de la compilation dans l’application Web Contentful, permettant aux éditeurs de voir les mises à jour de la compilation en temps réel.

Prérequis

Pour utiliser cette application, vous avez besoin de :

• Un site Web qui répond aux exigences suivantes :

  • Généré à l’aide d’un générateur de site statique (par exemple, Middleman, Hugo, etc.).

  • Extraction de contenu de Contentful.

  • Poussé vers un dépôt distant afin que Netlify puisse récupérer le code du site lors de la création.

• Une configuration Netlify comprenant les éléments suivants :

  • Un compte sur Netlify.

  • Un site sur Netlify qui est connecté au dépôt mentionné ci-dessus (le site doit être activé pour un déploiement continu).

Sous le capot

En interne, l’application effectue les opérations suivantes :

1. S’authentifie avec Netlify via OAuth.

2. Vous demande de sélectionner des sites à partir de votre compte Netlify pour les créer.

3. Crée un hook de build entrant qui déclenche automatiquement le build Netlify.

4. Informe Contentful si la compilation change d’état (par exemple, succès ou échec).

5. Ajoute un nouveau widget de barre latérale dans Contentful qui peut déclencher la création et ouvrir le site.

Utilisation

Étape 1 : Installer et configurer

Cliquez sur Connecter... pour vous authentifier avec Netlify :

Cela autorise l’application à agir en votre nom dans les interactions d’API de Contentful à Netlify.

Étape 2 : Configurer les sites Netlify pour les créer à partir de Contentful

Utilisez la liste déroulante pour choisir un site sur Netlify que vous souhaitez créer. Notez que le site doit avoir un déploiement continu activé. En général, il est logique d’avoir deux sites :

• Un premier site où vous construisez gatsby-netlify-contentful et utiliserez l’étiquette Production

• Un deuxième site où vous construisez gatsby-netlify-contentful-preview et utiliserez l’étiquette Aperçu

Il n’est pas obligatoire d’avoir un site de production et un site d’aperçu, mais cela est fortement recommandé. En utilisant cette configuration, vous pouvez vous assurer que vos modifications sont correctes avant de les envoyer en production.

Étape 3 : Utiliser le widget de build Netlify à partir de l’éditeur d’entrées

L’application Netlify crée un widget personnalisé pour l’expérience d’aperçu du contenu.

Le widget affiche un bouton Build qui :

• Affiche l’état du build.

• Indique qui a déclenché le dernier build et quand.

Il affiche également un bouton Ouvrir le site qui ouvre l’URL de votre site Netlify choisi à l’étape de configuration.

FAQ

Que se passe-t-il avec le jeton OAuth que l’application Web Contentful a obtenu lors de la configuration de l’application Netlify ?

Le jeton n’est utilisé que pendant la phase de configuration de l’application et n’est pas conservé. Par conséquent, vous devez vous authentifier à nouveau chaque fois que vous souhaitez modifier la configuration de l’application.

Qui pourra déclencher les builds Netlify avec cette application ?

L’installation et la configuration de l’application Netlify ne sont accessibles qu’aux administrateurs. Cependant, le nouveau widget de build fourni par l’application est accessible à tous les utilisateurs ayant accès au contenu.