0036 (ADR-013): What lives in common and what is an appliance #41

New issue

Open

opened 2026-09-30 10:10:58 -03:00 by marcos-mendez · 0 comments

marcos-mendez commented

2026-09-30 10:10:58 -03:00

(Migrated from github.com)

Decision (maintainer, 2026-09-30). Used by two or more images: an overlay in common with conf/inithook scripts. A named combination with identity: an appliance. Overlays: wireguard, etcd (stopped), vip, syncthing; crowdsec, coraza, anubis (disabled); nginx; php-fpm, python, ruby, nodejs, go; postgresql, mariadb, redis, elasticsearch/opensearch; installer extensions. Appliances: Keel Core, Web, PostgreSQL, MariaDB, Redis, Elasticsearch, PHP (replaces LAMP/LAPP), Python, Ruby, Node. Apps: WordPress, Nextcloud, Odoo, Mastodon, Ghost, Discourse, Gitea/Forgejo. Apache is not in common (retired).

Handbook: docs/decisions/0036-common-versus-appliance.md (handbook#26)

Amends: 0010 (components were one repository each; now overlays in common, shipped as .deb under 0039), 0013 (apache-php, lamp, lapp superseded), 0022 (LNPP = Keel Python + PostgreSQL), 0006 (appliance list).

Review notes (resolved by the maintainer, 2026-09-30)

Existing unit work under 0010 (unit-redis, keel-mariadb#14, keel-postgresql#10). Resolved by following the decision: the content moves into common as overlays, shipped as .deb under 0039.
Package facts (Debian archive and WNPP, 2026-09-30): etcd-server 3.5.16, syncthing 1.29.5, tayga 0.9.2, crowdsec 1.4.6-10 in trixie; Anubis (ITP #1102132) and Garage (ITP #1118368) not in Debian, candidates to contribute via tracker#15; Coraza no package, no ITP.

First tasks

Inventory common's 37 overlays against this table: keep, rename, retire.
Packaging pattern for an overlay as a .deb (one example: wireguard).

**Decision (maintainer, 2026-09-30).** Used by two or more images: an overlay in `common` with conf/inithook scripts. A named combination with identity: an appliance. Overlays: wireguard, etcd (stopped), vip, syncthing; crowdsec, coraza, anubis (disabled); nginx; php-fpm, python, ruby, nodejs, go; postgresql, mariadb, redis, elasticsearch/opensearch; installer extensions. Appliances: Keel Core, Web, PostgreSQL, MariaDB, Redis, Elasticsearch, PHP (replaces LAMP/LAPP), Python, Ruby, Node. Apps: WordPress, Nextcloud, Odoo, Mastodon, Ghost, Discourse, Gitea/Forgejo. Apache is not in common (retired). **Handbook:** `docs/decisions/0036-common-versus-appliance.md` (handbook#26) **Amends:** 0010 (components were one repository each; now overlays in common, shipped as .deb under 0039), 0013 (`apache-php`, `lamp`, `lapp` superseded), 0022 (LNPP = Keel Python + PostgreSQL), 0006 (appliance list). **Review notes** (resolved by the maintainer, 2026-09-30) - [x] Existing unit work under 0010 (`unit-redis`, keel-mariadb#14, keel-postgresql#10). Resolved by following the decision: the content moves into common as overlays, shipped as .deb under 0039. - [x] Package facts (Debian archive and WNPP, 2026-09-30): etcd-server 3.5.16, syncthing 1.29.5, tayga 0.9.2, crowdsec 1.4.6-10 in trixie; Anubis (ITP #1102132) and Garage (ITP #1118368) not in Debian, candidates to contribute via tracker#15; Coraza no package, no ITP. **First tasks** - [ ] Inventory common's 37 overlays against this table: keep, rename, retire. - [ ] Packaging pattern for an overlay as a .deb (one example: wireguard).