Skip to content

docs(deployment): commands first, and fix what was wrong - #56

Merged
dgnaglo merged 1 commit into
mainfrom
docs/deployment-commands-first
Oct 8, 2026
Merged

dgnaglo merged 1 commit into
mainfrom
docs/deployment-commands-first

Conversation

@dgnaglo

@dgnaglo dgnaglo commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

Why

The Docker Compose page had no command, and several deployment pages gave commands that do not work. Each page now leads with the commands, in order.

What changed

Page Before After
dockercompose no command requirements, 4 steps, everyday commands, profiles, troubleshooting
virtual-machine root docker-compose.yml (the Hostman file), no secrets step correct paths, secrets, check, warning until apowerb/apowerb-hosting#99
kubernetes k8s/ called obsolete; issuer e-mail not mentioned; no clone step install without Helm; replace the issuers' e-mail; clone first
helmchart helm template fails (measured); no th2forecast; truncated upgrade flags added; th2forecast row; full upgrade command
hostman, portainer generic real steps, from the root compose file
podman podman run of the API alone podman compose with the stack, marked not tested
digitalocean, cloud-run Dockerfile to select / image to build, neither exists what a deployment needs, marked not tested; credit sections kept
introduction, quickstart kubectl path; Traefik link fixed

Azure App Service is untouched: it is being rewritten in a separate session.

Checks

  • mint validate: build validation passed
  • mint broken-links: no broken links found
  • Helm commands run locally against helm/apowerb-chart @ apowerb-hosting 8f02d43: the documented helm template failed on postgres.password is empty; with the added flags it renders 16 objects; the smaller stack renders 8, as the page says.
  • docker compose config on the overlay: see fix(traefik): stop publishing the API and the interface in plain HTTP apowerb-hosting#99.
  • Not run end to end on a live host in this PR: Podman, Portainer, DigitalOcean and Cloud Run are marked as not tested.

The Docker Compose page had no command at all. It now gives the install as
four steps, the everyday commands, the optional profiles and the usual
failures.

Fixed along the way, each checked against apowerb-hosting:
- virtual-machine: the overlay command named the root docker-compose.yml,
  which is the Hostman file; secrets generation was missing.
- podman: a bare `podman run apowerb/apowerb` has no database and no key.
- digitalocean / cloud-run: no Dockerfile to select, no image to build;
  replaced by what a deployment needs, marked as not yet tested.
- hostman / portainer: real steps from the root compose file.
- kubernetes: k8s/ is not obsolete, it installs the full stack without
  Helm; the issuers ship a maintainer's e-mail; the clone step was missing.
- helmchart: `helm template` failed without postgres.password and
  backend.env.encryptKey (measured); th2forecast was missing; the upgrade
  that adds the redirect dropped values-secrets.yaml.
- dockercompose: GHCR packages answer 403 to anonymous pulls, removed.
- quickstart: the Traefik link pointed at the Compose page.

Azure App Service is left out: it is being rewritten separately.
@dgnaglo
dgnaglo merged commit 5dcdfc7 into main Oct 8, 2026
2 checks passed
@dgnaglo
dgnaglo deleted the docs/deployment-commands-first branch October 8, 2026 10:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant