Note
Les captures d’écran de cette page montrent le panneau en espagnol : elles sont prises une seule fois, sur l’interface espagnole. Votre panneau affiche les mêmes écrans avec les libellés français employés dans ce texte — les boutons sont au même endroit.
Projets : publier depuis votre dépôt
Ce que vous obtenez : vous connectez un dépôt git et, à chaque push, votre site se construit et se publie tout seul. Avec HTTPS, sans rien toucher et sans envoyer de fichiers par FTP.
C’est ce qu’il vous faut si votre site est généré par un framework —Astro, Vite, Next exporté, Hugo, Jekyll…— et que vous travaillez avec git. Si vous êtes plutôt WordPress ou PHP, c’est Créer un site web, pas ceci.
Créer votre premier projet
Dans le menu, . La première fois, vous ne verrez que Connecter un dépôt.
Dans Nouveau projet, vous choisissez d’où vient le code :
Depuis votre fournisseur git — vous connectez GitHub, GitLab ou Bitbucket et vous choisissez le dépôt. Chaque push sur la branche de production publie une nouvelle version.
Ou commencez avec un modèle — nous le copions sur votre compte git, pas sur le nôtre, et nous le déployons. Le dépôt est à vous dès la première minute. C’est pour cela qu’il faut connecter le fournisseur avant.
Ensuite vous choisissez le domaine, et vous pouvez le laisser pour plus tard : le sous-domaine gratuit fonctionne dès le premier déploiement.
Le premier déploiement
Dès que vous connectez, la construction démarre. Sur l’écran du projet vous voyez les déploiements et, en cliquant sur l’un d’eux, son journal en direct.
En cas d’échec, le journal est tronqué en conservant la fin, là où se trouve l’erreur, et chaque erreur connue est accompagnée d’un lien En savoir plus sur cette erreur.
Note
Pas besoin de deviner la configuration. Nous regardons ce qu’il y a dans le dépôt et nous détectons le framework tout seuls. Vous pourrez le forcer ensuite dans Réglages.
Votre domaine
Dans l’onglet Domaines de chaque projet :
Le sous-domaine gratuit est toujours là et n’expire pas.
Ajouter un domaine : achetez-le sur place et il se rattache tout seul, ou faites pointer celui que vous avez déjà.
Vous verrez l’état d’avancement : Vérification du DNS, Émission du certificat, Actif. Il n’y a rien à faire entre l’un et l’autre : il suffit d’attendre.
Un projet déjà publié, avec son dépôt, le commit et le temps qu’il a pris.
Changer la façon de construire
Dans Réglages :
Réglage |
À quoi ça sert |
|---|---|
Framework |
Laissez Détection automatique (recommandé) sauf s’il se trompe. |
Branche de production |
La branche qui publie. Les autres ne publient rien. |
Commande d’installation |
En général |
Commande de build |
Ce qui génère le site. En général |
Répertoire de sortie |
Où sont déposés les fichiers. |
Sous-dossier du dépôt |
Si le projet n’est pas à la racine (un monorepo). |
Revenir en arrière
Chaque déploiement est conservé et peut être promu en production. Quand vous le faites, l’écran prévient : La production est figée sur un déploiement antérieur.
Warning
Tant qu’elle est figée, un nouveau push ne publie rien. C’est volontaire : sinon, le commit suivant annulerait votre retour en arrière sans prévenir, avec le site hors service. Pour revenir à la normale, promouvez le dernier déploiement.
Variables d’environnement
Celles dont votre build a besoin. Elles sont stockées chiffrées et ne sont plus affichées une fois enregistrées : on peut les remplacer, pas les lire.
Problèmes fréquents
- J’ai fait un push et rien ne s’est passé
Vérifiez la branche : seule celle de production publie. Et vérifiez que la connexion avec votre fournisseur git est toujours autorisée.
- La construction réussit mais le site est blanc
C’est presque toujours le Répertoire de sortie. Regardez où votre framework dépose les fichiers et indiquez-le dans Réglages.
- Je veux utiliser le domaine que j’ai déjà
Ajoutez-le dans Domaines et faites pointer le DNS là où on vous l’indique. Si c’est vous qui gérez le DNS, Le DNS de votre domaine explique les enregistrements.