# ${REPO_NAME}

Aus der Vorlage
[deploy-kit](https://gitea.lucas-orth.de/lucas.orth/deploy-kit) erzeugt.

## Einrichten

**1. Port setzen.** Den App-Namen hat Gitea beim Anlegen aus dem
Repo-Namen eingesetzt. Offen ist nur noch der Port:

```bash
sed -i "s/__PORT__/3000/g" docker-compose.yml Dockerfile
```

Auf den Port anpassen, auf dem die App tatsaechlich lauscht.

**2. Dockerfile anpassen.** Die Vorlage ist fuer Node mit TypeScript-Build.

**3. Build- und Test-Schritte** in `.gitea/workflows/deploy.yml`
einkommentieren.

**4. Healthcheck** in `docker-compose.yml` auf einen echten Endpoint zeigen
lassen. Er ist das Gate des Deploy-Schritts - zeigt er ins Leere, schlaegt
jeder Deploy fehl.

**5. Secret `DOTENV`** anlegen: Einstellungen -> Actions -> Secrets, mit dem
kompletten `.env`-Inhalt, mehrzeilig.

**6. Proxy Host** im Nginx Proxy Manager:
`${REPO_NAME}.lucas-orth.de` -> `${REPO_NAME}` : Port aus Schritt 1.

**7. Deployen:**

```bash
git tag v1.0.0 && git push origin v1.0.0
```

## Pruefen, bevor der erste Tag faellt

```bash
grep -n '__APP__\|__PORT__\|\${REPO_NAME}' docker-compose.yml Dockerfile
```

Kein Treffer heisst: alles ersetzt.

Falls in `docker-compose.yml` `${IMAGE_TAG:-latest}` verstuemmelt ist, hat
die Template-Ersetzung zu viel angefasst - dann `docker-compose.yml` aus
`.gitea/template` streichen und die Platzhalter von Hand setzen.

## Konventionen

**DEPLOY.md** - verbindlich, liegt im Projekt.

**MIGRATION.md** gilt nur, wenn diese App vorher schon manuell auf dem
Server lief. Bei einem neuen Projekt kann die Datei geloescht werden.