Publication sur une page Gitlab

1. Description

Il est possible de créer un pipeline CI/CD Gitlab pour construire et publier automatiquement le site web static sur une Page Gitlab.

2. Documentation

• https://tw-docs.com/docs/static-site-generators/docusaurus-gitlab-pages/
• https://gitlab.com/pages/docusaurus

3. Création d'un pipeline CI/CD Gitlab

• Créer le fichier .gitlab-ci.yml

.gitlab-ci.yml

# doc: https://gitlab.com/pages/docusaurus

# node >=18
image: node:18-alpine3.20

# Allow caching for faster deployment
cache:
  paths:
    - node_modules/
    
# Pipeline stages
stages:
  - build
  - deploy

# Build web site
build:
  stage: build
  before_script:
    - apk update && apk --no-cache add git
    # https://bwgjoseph.com/docusaurus-how-to-enable-showlastupdate-feature-when-deployed-via-gitlab-ci
    - git --version
  script:
    - yarn install
    - yarn build
    - mv build public
  artifacts:
    paths:
      - public

# Deploy web site on Gitlab Pages
pages:
  stage: deploy
  script:
    - echo "Publication sur Gitlab Pages"    
  artifacts:
    paths:
      - public
  only:
    - main
  pages: true

4. Déploiement du site web

• Après avoir commit votre site web sur Gitlab, le pipeline CI/CD devrait s'exécuter automatiquement, construire le site web et le déployer sur la Page Gitlab.

5. Test de la Page Gitlab

• Ouvrir l'URL : https://tzshare.gitlab.io/homelabasdoc/
• Avec l'arborescence créée précédemment et la configuration effectuée, le site web ressemble à la capture d'écran suivante.

• Exemple du menu Outils