iJUG Pages – Demo mit Custom Domain

Dieses Repository zeigt eine statische Webseite mit eigener Domain auf iJUG Pages, einer vom iJUG e. V. betriebenen git-pages Instanz.

Live-Demo: https://test.ijug.eu/

Repository: demos/custom-domain

Aufbau

Die Dateien der Webseite liegen im Verzeichnis public:

public/
├── index.html   # Inhalt und Struktur
├── styles.css   # Gestaltung und responsives Layout
├── script.js    # Anzeige der aktuellen Domain und Kopierfunktion
└── logo.svg     # Logo des iJUG e. V.

Die Webseite benötigt keinen Build-Schritt und keine zusätzlichen Abhängigkeiten. CSS und JavaScript sind in eigene Dateien ausgelagert.

Lokal ansehen

Mit installiertem JDK ab Java 25 lässt sich die Webseite aus dem Repository-Verzeichnis starten:

jwebserver -p 8000 -d public

Anschließend im Browser http://localhost:8000/ öffnen. Mit Strg+C wird der Server beendet.

Die auf der Webseite angezeigte Adresse wird dynamisch aus window.location.host gelesen. Lokal erscheint daher localhost:8000, auf der Live-Demo die Custom Domain.

Eigene Webseite mit Custom Domain

1. Dieses Repository auf der iJUG Forgejo-Instanz forken.

2. Die Inhalte im Verzeichnis public anpassen.

3. Die gewünschte Custom Domain für iJUG Pages vorbereiten und diese erforderlichen DNS-Einträge vornehmen:

   _git-pages-forge-allowlist.<domainname.tld>. TXT "https://git.ijug.eu/<username>/<reponame>.git"

   <domainname.tld>. IN CNAME ijug.page.

4. Im eigenen Repository unter Einstellungen → Aktionen → Variablen eine Variable mit dem Namen PAGES_SITE anlegen. Als Wert die vollständige Adresse der eigenen Webseite inklusive Protokoll eintragen.

5. Das erste Deployment mit einer Adresse ausführen, die mit http:// beginnt, beispielsweise:

   http://<domainname.tld>/
   

6. Nach dem ersten erfolgreichen Deployment wird automatisch ein TLS-Zertifikat generiert und es kann die Variable auf https:// umgestellt werden, beispielsweise:

   https://<domainname.tld>/
   

   Anschließend ein weiteres Deployment auslösen.

Den Platzhalter durch die eigene Domain ersetzen. Für das erste Deployment muss PAGES_SITE http:// verwenden; danach ist auch https:// möglich.

Deployment mit Forgejo Actions

Der Workflow .forgejo/workflows/publish.yml startet bei einem Push auf main und kann außerdem manuell über workflow_dispatch ausgeführt werden.

Die Action actions/git-pages@v2 veröffentlicht das Verzeichnis public/. Sie verwendet die Repository-Variable PAGES_SITE als Zieladresse:

with:
  site: ${{ vars.PAGES_SITE }}
  token: ${{ forgejo.token }}
  source: public/

Die Zieladresse wird damit über die Repository-Einstellungen festgelegt und muss nicht im Workflow geändert werden.

Weiterführende Links

• iJUG e. V.
• Quellcode dieser Demo