GitLab Pages

Mit GitLab Pages lassen sich statische Websites direkt aus einem Repository in GitLab veröffentlichen.

Diese Websites werden automatisch mit GitLab CI/CD-Pipelines bereitgestellt und unterstützen Generatoren für statische Websites wie z.B. Sphinx Hugo, Jekyll oder Gatsby. Sie können mit benutzerdefinierten Domains und SSL/TLS-Zertifikaten verbunden werden.

Erste Schritte

  1. zunächst erstellt ihr eine .gitlab-ci.yml-Datei, für Sphinx z.B. mit folgendem Inhalt:

    gitlab-ci.yml
     1image: python:latest
 2
 3stages:
 4  - deploy
 5
 6pages:
 7  stage: deploy
 8  rules:
 9    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
10  before_script:
11    - python -m pip install furo sphinxext-opengraph sphinx-copybutton sphinx_inline_tabs
12  script:
13    - cd docs && make html
14  after_script:
15    - mv docs/_build/html/ ./public/
16  artifacts:
17    paths:
18      - public
    Zeile 6

    Am Job-Namen pages erkennt GitLab, dass ihr eine GitLab Pages-Website bereitstellen wollt.

    Zeilen 15, 18

    GitLab stellt eure Website immer aus einem bestimmten Ordner namens public in eurem Repository zur Verfügung.

  2. GitLab Pages bietet Standard-Domänennamen, die auf eurem Account oder Gruppennamen und Projekt basieren. Daraus werden vorhersehbare URLs erzeugt. Für die cusy-GitLab-Instanz ist dies pages.cusy.io. Wenn euer Projekt erreichbar ist unter https://ce.cusy.io/GROUPNAME/PROJECTNAME, dann sind die zugehörigen GitLab-Pages erreichbar unter https://GROUPNAME.pages.cusy.io/PROJECTNAME.

    Siehe auch

    GitLab Pages unterstützt auch benutzerdefinierte Domains. Weitere Informationen findet ihr unter GitLab Pages custom domains.