Logo

GitLab Pages nutzen

Zuletzt aktualisiert: 19.02.2026 2 Min. Auf GitLab bearbeiten
Auf dieser Seite
Zusammenfassung

git.nrw bietet GitLab Pages zum Hosten statischer Webseiten direkt aus Ihren Repositories, was die Veröffentlichung von Dokumentation oder persönlichen Projektseiten erleichtert. Sie können auch eigene Domains für Ihre Seiten konfigurieren, die gebrandete und extern erreichbare URLs wie „my-website-12345.pages.git.nrw" oder „testuser.git.nrw/my-website" ermöglichen.

Details

GitLab Pages stellt eine kostenlose, statische Webseite bereit, die direkt aus einem Repository in git.nrw generiert wird und vordefinierte Inhalte Ihres Projekts anzeigt.

Um eine Webseite mit Pages zu veröffentlichen, verwenden Sie einen beliebigen Static-Site-Generator wie Gatsby, Jekyll, Hugo, Middleman, Harp, Hexo oder Brunch. Pages unterstützt auch Webseiten, die direkt in HTML, CSS und JavaScript geschrieben sind. Dynamische serverseitige Verarbeitung (wie .php und .asp) wird nicht unterstützt.

Sie finden Anleitungen zum Einstieg sowie Tutorials und weitere Informationen in der GitLab-Dokumentation.

Zum Bereitstellen Ihrer Seite verwendet GitLab sein integriertes Tool GitLab CI/CD , um Ihre Seite zu erstellen und auf dem GitLab-Pages-Server zu veröffentlichen. Die Abfolge von Skripten, die GitLab CI/CD dafür ausführt, wird in einer Datei namens .gitlab-ci.yml definiert.

Standardmäßig deployt GitLab Ihre Webseite aus einem bestimmten Ordner namens public in Ihrem Repository. Sie können auch einen eigenen Ordner für das Deployment mit Pages festlegen .

Beispiel mit einfachem HTML

Um ein kurzes Beispiel mit HTML zu zeigen, veröffentlichen wir alle webseitenbezogenen Inhalte (hier alle .html-Dateien) in einem bestimmten Verzeichnis, wenn ein push auf unseren main-Branch erfolgt.

  1. Erstellen Sie die .gitlab-ci.yml-Datei, ein neues public-Verzeichnis in Ihrem main-Branch sowie eine index.html-Datei im neuen Verzeichnis
  2. Fügen Sie einfachen Formatierungscode in die .html-Datei ein
  3. Fügen Sie Folgendes in die .gitlab-ci.yml-Datei ein:
pages:
  stage: deploy
  script:
    - echo "Nothing to build"
  artifacts:
    paths:
      - public
  only:
    - main
  1. Pushen Sie auf main

Jetzt werden bei jedem Push auf Ihren main-Branch die Inhalte Ihres public-Verzeichnisses veröffentlicht. Sie können die verschiedenen Pages Ihres Projekts unter Deploy -> Pages in der linken Seitenleiste einsehen.

Standardmäßig wird für jede Pages-Webseite Ihres Projekts eine eindeutige Domain erstellt, die etwa so aussehen sollte:

https://<Name Ihres Projekts>-abcde1.pages.git.nrw/