68 lines
2.3 KiB
Markdown
68 lines
2.3 KiB
Markdown
# Neue Website der Hardtschule Karlsruhe
|
||
|
||
Ein eigenständiger, responsiver Website-Prototyp auf Basis öffentlich auffindbarer Informationen der bisherigen Schulwebsite, des Webarchivs und der Stadt Karlsruhe.
|
||
|
||
## Lokal ansehen
|
||
|
||
```sh
|
||
npm run dev
|
||
```
|
||
|
||
Danach ist die Seite unter `http://127.0.0.1:4173` erreichbar.
|
||
|
||
## Mit Docker betreiben
|
||
|
||
Das veröffentlichte Image kann direkt aus der Gitea-Container-Registry gestartet werden:
|
||
|
||
```sh
|
||
docker run -d \
|
||
--name hardtschule-website \
|
||
--restart unless-stopped \
|
||
-p 8080:80 \
|
||
git.servercentral.org/jonas/hardtschule-karlsruhe.de:latest
|
||
```
|
||
|
||
Die Website ist anschließend unter `http://localhost:8080` erreichbar. Alternativ genügt mit der enthaltenen Compose-Datei:
|
||
|
||
```sh
|
||
docker compose up -d
|
||
```
|
||
|
||
Falls das Gitea-Paket nicht öffentlich ist, muss auf dem Zielsystem zuvor einmal `docker login git.servercentral.org` ausgeführt werden.
|
||
|
||
### Image lokal bauen
|
||
|
||
```sh
|
||
docker build -t hardtschule-website .
|
||
docker run --rm -p 8080:80 hardtschule-website
|
||
```
|
||
|
||
### Automatischer Build in Gitea
|
||
|
||
Der Workflow unter `.gitea/workflows/docker.yml` baut bei jedem Push auf `main` zwei Tags:
|
||
|
||
- `git.servercentral.org/jonas/hardtschule-karlsruhe.de:latest`
|
||
- `git.servercentral.org/jonas/hardtschule-karlsruhe.de:<commit-sha>`
|
||
|
||
Damit der Workflow das Image veröffentlichen kann:
|
||
|
||
1. Repository-Actions und einen Runner mit dem Label `ubuntu-latest` aktivieren.
|
||
2. In Gitea einen Personal Access Token mit Schreibrecht für Pakete erstellen.
|
||
3. Unter **Repository → Einstellungen → Actions → Secrets** die Secrets `REGISTRY_USERNAME` und `REGISTRY_TOKEN` hinterlegen.
|
||
|
||
Der unveränderliche Commit-Tag erlaubt bei Bedarf ein gezieltes Rollback. `latest` zeigt immer auf den aktuellen Stand von `main`.
|
||
|
||
## Inhaltliche Quellen
|
||
|
||
- bisherige Website und Webarchiv der Hardtschule Karlsruhe
|
||
- Stadt Karlsruhe: Hardtschule – Brandschutz und WC-Sanierung
|
||
- Stadt Karlsruhe: Städtischer Schülerhort an der Hardtschule
|
||
- Werkraum Karlsruhe: Theaterprojekte 2023/24
|
||
|
||
## Vor einer Veröffentlichung
|
||
|
||
- aktuelle Termine, Materiallisten und Pläne ergänzen
|
||
- Kontaktangaben und Zuständigkeiten von der Schule bestätigen lassen
|
||
- Impressum und Datenschutz an Hosting und tatsächliche Dienste anpassen
|
||
- Nutzungsfreigabe für Fotos dokumentieren (Fotos im Prototyp: Dirk Altenkirch / Stadt Karlsruhe)
|