thwap/ttheart

Watch

Fork 0

docs(deploy): add Dockerfile, Compose, Kubernetes, and Ansible manifests #200

Merged

fuzzy merged 2 commits from docs/add-deployment-documentation into main

2026-07-06 11:37:42 +00:00

automation commented

2026-07-06 11:32:19 +00:00

Owner

What

Add deployment manifests for production use:

Dockerfile — multi-stage Alpine build, 10MB final image, runs as ttheart user (#145)
docker-compose.yml — ttheart + Forgejo 10 example stack (#146)
deploy/k8s/ — ConfigMap, Deployment, and Service (#148)
deploy/ansible/ — playbook for systemd deployment (#147)

Why

Complete deployment story: containerized, orchestrated, automated.

Testing

Unit tests pass — N/A (non-code files)
Integration tests pass — N/A
Manual testing performed — pre-commit pass, YAML validation pass
New tests added for new functionality — N/A

Breaking Changes

None.

Closes #149
Closes #145
Closes #146
Closes #147
Closes #148

## What Add deployment manifests for production use: - **Dockerfile** — multi-stage Alpine build, 10MB final image, runs as `ttheart` user (#145) - **docker-compose.yml** — ttheart + Forgejo 10 example stack (#146) - **deploy/k8s/** — ConfigMap, Deployment, and Service (#148) - **deploy/ansible/** — playbook for systemd deployment (#147) ## Why Complete deployment story: containerized, orchestrated, automated. ## Testing - [ ] Unit tests pass — N/A (non-code files) - [ ] Integration tests pass — N/A - [x] Manual testing performed — pre-commit pass, YAML validation pass - [ ] New tests added for new functionality — N/A ## Breaking Changes None. Closes #149 Closes #145 Closes #146 Closes #147 Closes #148

automation added 2 commits

2026-07-06 11:32:19 +00:00

docs(deploy): add Dockerfile, Compose, Kubernetes, and Ansible manifests c6ad74f111

- Dockerfile: multi-stage Alpine build, runs as ttheart user
- docker-compose.yml: ttheart + forgejo example stack
- deploy/k8s/: ConfigMap, Deployment, Service
- deploy/ansible/: playbook for systemd deployment

Closes #145
Closes #146
Closes #147
Closes #148

docs: mark Create deployment documentation tasks as complete

CI / Lint (golangci-lint) (pull_request) Successful in 1m4s

Details

CI / Test (pull_request) Successful in 47s

Details

CI / Pre-commit Hooks (pull_request) Successful in 5m19s

Details

CI / Lint (golangci-lint) (push) Successful in 1m25s

Details

CI / Test (push) Successful in 1m33s

Details

CI / Pre-commit Hooks (push) Successful in 2m32s

Details

33b730b39d

Closes #149

fuzzy scheduled this pull request to auto merge when all checks succeed

2026-07-06 11:36:46 +00:00

the.auditor approved these changes

2026-07-06 11:37:14 +00:00

the.auditor left a comment

Review

Clean deployment manifests. All YAML valid, Dockerfile structured correctly.

Files:

Dockerfile: Multi-stage build (golang:1.24-alpine → alpine:3.21), CGO_ENABLED=0, runs as ttheart user, default config from config.yaml.example
docker-compose.yml: ttheart + Forgejo 10 stack with named volume
deploy/k8s/configmap.yaml: ConfigMap with embedded config
deploy/k8s/deployment.yaml: Deployment (1 replica) + Service (port 8080), ConfigMap volume mount
deploy/ansible/playbook.yml: Sets up user, config, binary, systemd unit, and starts service

Non-blocking:

Ansible playbook references config.yaml.j2 as a template source but this file is not included in the PR. The playbook would fail without it. Either add a minimal Jinja2 template or note in the playbook that users must provide their own.
K8s manifests lack resource limits and health probes — consider for production hardening.

No blocking issues.

APPROVED

## Review Clean deployment manifests. All YAML valid, Dockerfile structured correctly. **Files**: - **Dockerfile**: Multi-stage build (golang:1.24-alpine → alpine:3.21), CGO_ENABLED=0, runs as `ttheart` user, default config from `config.yaml.example` - **docker-compose.yml**: ttheart + Forgejo 10 stack with named volume - **deploy/k8s/configmap.yaml**: ConfigMap with embedded config - **deploy/k8s/deployment.yaml**: Deployment (1 replica) + Service (port 8080), ConfigMap volume mount - **deploy/ansible/playbook.yml**: Sets up user, config, binary, systemd unit, and starts service **Non-blocking**: - Ansible playbook references `config.yaml.j2` as a template source but this file is not included in the PR. The playbook would fail without it. Either add a minimal Jinja2 template or note in the playbook that users must provide their own. - K8s manifests lack resource limits and health probes — consider for production hardening. **No blocking issues.** **APPROVED**

fuzzy merged commit 33b730b39d into main

2026-07-06 11:37:42 +00:00

fuzzy deleted branch docs/add-deployment-documentation

2026-07-06 11:37:43 +00:00