# bovender's personal home page

Site generated with [Hugo][] using the [hermit-v2][] theme.

## Docker-compose commands

Build site:

```bash
docker compose up build
```

Run development server with live refresh and draft as well as future post
rendering enabled:

```bash
docker compose up server
```

Add new posts:

```bash
docker compose up -d server
docker compose exec server new content/posts/2024-07-31-my-new-blog-post.md
```

## CI/CD mit Gitea Actions

Ab 6/2026.

With a little help from Claude.

Damit die "Action" die Dateien auf den Webserver übertragen
kann, muss die Datei `/home/daniel/.ssh/authorized_keys`
folgende Zeile enthalten:

```plain
command="/usr/local/bin/rrsync -wo /var/docker-data/nginx/www",no-agent-forwarding,no-port-forwarding,no-pty,no-user-rc,no-X11-forwarding ssh-ed25519 AAA... gitea-deploy
```

Wobei oben die Stelle mit `AAA...` durch den öfftl. Schlüssel des SSH-Keys
ersetzt werden muss.

In der Gitea-Weboberfläche müssen die "secrets" hinterlegt werden,
zu finden unter `Repository > Einstellungen > Actions > Secrets`.

- `DEPLOY_HOST=bovender.de`
- `DEPLOY_USER=daniel`
- `DEPLOY_KNOWN_HOSTS=[1]`
- `DEPLOY_SSH_KEY=[2]`
- `DEPLOY_SUBDIR=bovender`

Die Ziffer `[1]` ist zu ersetzen mit der Ausgabe von:

```bash
ssh-keyscan bovender.de
```

Die Ziffer `[2]` ist zu ersetzen mit dem privaten
Schlüssel des SSH-Keys. Den Key erstellt man mit

```bash
ssh-keygen -t ed25519 -C "gitea-deploy" -f ~/.ssh/gitea_deploy -N ""
``` 

Es ist wichtig, das `DEPLOY_SUBDIR` zu definieren, hierbei handelt es sich
dann per `rrsync`-Beschränkung um ein Unterverzeichnis von `/var/docker-data/nginx/www`.

## Action trigger

Die Gitea Action wird bei jedem Push auf Main
ausgelöst sowie jeden Tag um Mitternach deutscher
Zeit und auf Knopfdruck in der Gitea-Oberfläche (durch
den Trigger `workflow_dispatch`)

[hermit-v2]: https://github.com/1bl4z3r/hermit-V2
[Hugo]: https:/gohugo.io