Github Pages est une solution pour héberger des sites web statiques directement dans ton dépôt Github en poussant les fichiers du site vers la branche gh-pages.
J’utilise cette fonctionnalité pour héberger ce blog.
C’est gratuit et très utile pour héberger tes sites/blog/documentations de projets open-source.
Voici un tutoriel sur la façon de publier le site web Gatsby avec travis.
Assurez-toi d’avoir un dépôt public github avec ton site statique et un compte travis-ci.org.
1. Ajouter le fichier de configuration travis
Définissez la configuration de base de travis-ci pour construire et pousser ton site sur des pages “gh” à chaque nouveau commit sur master.
Ajoutez le fichier .travis-ci.yml dans le répertoire racine de ton projet git.
# C'est la partie obligatoire contenant l'étape de construction pour gatsby
language: node_js
node_js:
- "12"
cache:
yarn: true
directories:
- public
- .cache
script:
- yarn build # Générer des fichiers HTML statiques
# Voici la partie magique
deploy:
# Utiliser le processus de déploiement des pages Github
provider: pages
skip-cleanup: true
# Répertoire où se trouvent les fichiers générés
local_dir: public
# Github security/auth token
github-token: $GITHUB_TOKEN
# Conserve les anciens fichiers/constructions des déploiements précédents
keep-history: true
# La branche Git sur laquelle on souhaite déployer (master, gh-pages, foo...)
target_branch: gh-pages
on:
# Quelle branche déclenchera le déploiement
branch: master
Consultez tous les fournisseurs de déploiement disponibles avec travis.
2. Génère un token Github
Générez un jeton Github sur cette page avec l’autorisation du dépôt et conservez-le en lieu sûr.
3. Configure ton job travis
Active ton dépôt github dans la liste des projets travis sur cette page. Ensuite, sur la page travis de ton projet, va sur “Plus d’options > Paramètres”.
Dans la section “Variables d’environnement”, ajoutez une variable nommée “GITHUB_TOKEN” et utilisez le token généré à l’étape précédente.
4. Activer la fonction Github Pages
Dans la page des paramètres de ton dépôt github, assure-toi d’activer la fonctionnalité des pages github dans la section “Github Pages”.
c’est fini ! Ton prochain commit poussé sur la branche master va déclencher le déploiement de ton site.
J’espère que cela t’aidera à configurer le déploiement de travis pour ton projet.
Si cela t’as plu je vais essayer de faire le même tuto avec les Github Action.