Archived
Compare commits
179
Commits
49caca5700
..
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
caa6c3001a | ||
|
|
7751662bb4 | ||
|
|
cb855416db | ||
|
|
faad7cc962 | ||
|
|
afe2fce12d | ||
|
|
7c6eb8c2a9 | ||
|
|
65cf245fbd | ||
|
|
eb13c88e73 | ||
|
|
daf02789ac | ||
|
|
2954bcf671 | ||
|
|
e733382f6c | ||
|
|
80bdeb8d9d | ||
|
|
dd9d798bae | ||
|
|
2073f953dd | ||
|
|
6d85b51b52 | ||
|
|
f88e45b783 | ||
|
|
cc794c3896 | ||
|
|
dccff1d61c | ||
|
|
f17a8ee22c | ||
|
|
8bb9ee242e | ||
|
|
46abc20577 | ||
|
|
065d59d68b | ||
|
|
d47635879a | ||
|
|
f27d98b57f | ||
|
|
656df7fb41 | ||
|
|
b68d90bad5 | ||
|
|
d25ffd8957 | ||
|
|
c127e8a709 | ||
|
|
fb07135179 | ||
|
|
eb68cdc425 | ||
|
|
031ed3ac37 | ||
|
|
93b24200b1 | ||
|
|
951b37e78a | ||
|
|
5e47ae2777 | ||
|
|
cc015fe9a2 | ||
|
|
d9cce278e6 | ||
|
|
e455438325 | ||
|
|
f303ddd6a7 | ||
|
|
c89b8129ec | ||
|
|
c98b2d8232 | ||
|
|
3a9b3786c5 | ||
|
|
1131eceb94 | ||
|
|
586be50567 | ||
|
|
d0e08b8fc1 | ||
|
|
487117b31a | ||
|
|
82fa90d843 | ||
|
|
ef1e7432ee | ||
|
|
427ea20e43 | ||
|
|
3298219ccf | ||
|
|
b30c7f3a8a | ||
|
|
374511c123 | ||
|
|
313f7f1c21 | ||
|
|
6aa78525c2 | ||
|
|
5e0de23ff7 | ||
|
|
3c655dabcf | ||
|
|
60e59f95a8 | ||
|
|
cdf37fb2c9 | ||
|
|
f56b734cb4 | ||
|
|
10c4373c0e | ||
|
|
2619d86dc1 | ||
|
|
1b679a4f09 | ||
|
|
02033cd3f9 | ||
|
|
d932bc57d0 | ||
|
|
c4cfa8081f | ||
|
|
90c9094a6f | ||
|
|
36c5f2b1e3 | ||
|
|
7bc2729ef6 | ||
|
|
9d79f828e4 | ||
|
|
22b3659cdf | ||
|
|
4440fddb2b | ||
|
|
d74000fbd0 | ||
|
|
9efdb5c781 | ||
|
|
e7fd52616d | ||
|
|
b7b4b4d36d | ||
|
|
40f5a3ce0d | ||
|
|
8e43118661 | ||
|
|
0e76f3cef1 | ||
|
|
8d18ab7059 | ||
|
|
6a959d85c3 | ||
|
|
79c583eca3 | ||
|
|
7fcafed3f9 | ||
|
|
0b67830d7f | ||
|
|
d878a0f9b8 | ||
|
|
9c38910a67 | ||
|
|
4a38a9421d | ||
|
|
5d32693925 | ||
|
|
696cecfecb | ||
|
|
c0360a14b9 | ||
|
|
5589594d2c | ||
|
|
0bd41b2fb1 | ||
|
|
5f10d0366e | ||
|
|
9f98101c5d | ||
|
|
0c20676590 | ||
|
|
59e2c2b9a3 | ||
|
|
61d49e85a3 | ||
|
|
8f84ed6d83 | ||
|
|
24cbb02bff | ||
|
|
685a472572 | ||
|
|
9de1bee542 | ||
|
|
306e2c14db | ||
|
|
63b47b59b5 | ||
|
|
52bd2d9fa2 | ||
|
|
034ad17cf9 | ||
|
|
ef2846562b | ||
|
|
52e2102f93 | ||
|
|
a9b21912db | ||
|
|
c9e4aeb8d6 | ||
|
|
96a44d5da6 | ||
|
|
0d936677e5 | ||
|
|
5c38b92bc8 | ||
|
|
fc5c882193 | ||
|
|
a4501d4034 | ||
|
|
c0958d8f02 | ||
|
|
2a97864a06 | ||
|
|
bd23339edd | ||
|
|
f8091a5c76 | ||
|
|
6a2639f931 | ||
|
|
fae5e119d1 | ||
|
|
872038d0c9 | ||
|
|
7a6db9fcfd | ||
|
|
d6a8979d55 | ||
|
|
a9a8a708d3 | ||
|
|
749c0d500d | ||
|
|
8f112af65b | ||
|
|
580e9b9aed | ||
|
|
c77db36865 | ||
|
|
e11dc22999 | ||
|
|
862ddd42f8 | ||
|
|
d0e7e52150 | ||
|
|
f0aa9941d8 | ||
|
|
6789451bd6 | ||
|
|
b8d9e62954 | ||
|
|
9f36dabcdc | ||
|
|
3c78e9c140 | ||
|
|
40a976f712 | ||
|
|
451be4ab0d | ||
|
|
b848d6b807 | ||
|
|
4695839df4 | ||
|
|
cb92ebc70e | ||
|
|
5c3bc0317c | ||
|
|
c7dd9f2229 | ||
|
|
7258d150ad | ||
|
|
020d6ecb79 | ||
|
|
b3cc235164 | ||
|
|
b422a55c02 | ||
|
|
b6d2e4ee62 | ||
|
|
438cf57127 | ||
|
|
6ada434618 | ||
|
|
2a6c905eb8 | ||
|
|
9ad21c5846 | ||
|
|
2bab864d5e | ||
|
|
ebae1ed990 | ||
|
|
5e49b6774b | ||
|
|
228413d780 | ||
|
|
7279ade925 | ||
|
|
a826c85e08 | ||
|
|
1918b83061 | ||
|
|
fa54b956a7 | ||
|
|
d69c74e537 | ||
|
|
0654d9673f | ||
|
|
ff0c413d06 | ||
|
|
f69028963b | ||
|
|
624d7be17c | ||
|
|
b17adee7cc | ||
|
|
27c5c3f631 | ||
|
|
361d2dc87b | ||
|
|
2499924afc | ||
|
|
b2ff514a71 | ||
|
|
b5cfdde00f | ||
|
|
d99e2767b5 | ||
|
|
7f8e920fa1 | ||
|
|
c10b834be0 | ||
|
|
f08a567933 | ||
|
|
85d7859b14 | ||
|
|
d06c53ef0b | ||
|
|
85cf56fcaf | ||
|
|
a576dfdaa0 | ||
|
|
cf516ab1f4 | ||
|
|
e7feec9146 |
No files matched your search
@@ -0,0 +1,71 @@
|
||||
name: Generate Docs
|
||||
|
||||
on:
|
||||
workflow_dispatch:
|
||||
schedule:
|
||||
- cron: "0 */6 * * *"
|
||||
|
||||
jobs:
|
||||
generate:
|
||||
runs-on: ubuntu-latest
|
||||
env:
|
||||
DOCKER_HOST: tcp://docker-socket-proxy:2375
|
||||
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v4
|
||||
with:
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Install docker CLI
|
||||
run: |
|
||||
apt-get update
|
||||
apt-get install -y docker.io docker-compose
|
||||
|
||||
- name: Generate docs
|
||||
run: |
|
||||
scripts/docs/generate-all.sh
|
||||
|
||||
- name: Validate generated docs
|
||||
run: |
|
||||
set -e
|
||||
|
||||
test -s docs/generated/docker-compose.resolved.yml
|
||||
test -s docs/generated/host-topology.md
|
||||
test -s docs/public/physical-topology.svg
|
||||
test -s docs/public/docker-traefik-dynu.svg
|
||||
|
||||
! grep -R "Host inventory JSON not found" docs/public docs/diagrams
|
||||
! grep -R "Generate terraform inventory" docs/public docs/diagrams
|
||||
|
||||
# Ensure no obvious secrets leaked
|
||||
! grep -R -E -i "password|token|api[_-]?key|secret" docs/public \
|
||||
|| (echo "Secret-like string detected"; exit 1)
|
||||
|
||||
- name: Commit changes
|
||||
run: |
|
||||
git config user.name "docs-bot"
|
||||
git config user.email "docs-bot@local"
|
||||
|
||||
git add docs/generated docs/diagrams docs/public data/terraform/proxmox-inventory.json || true
|
||||
|
||||
if git diff --cached --quiet; then
|
||||
echo "No changes to commit"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
git commit -m "docs: regenerate documentation artifacts"
|
||||
|
||||
- name: Push to Gitea
|
||||
run: |
|
||||
git push origin HEAD:main
|
||||
|
||||
- name: Push to GitHub mirror
|
||||
env:
|
||||
GITHUB_TOKEN: ${{ secrets.GITHUB_PUSH_TOKEN }}
|
||||
GITHUB_MIRROR_REPO: ${{ vars.GITHUB_MIRROR_REPO }}
|
||||
run: |
|
||||
test -n "$GITHUB_TOKEN"
|
||||
test -n "$GITHUB_MIRROR_REPO"
|
||||
git remote add github "https://$GITHUB_TOKEN@github.com/$GITHUB_MIRROR_REPO.git" || true
|
||||
git push github HEAD:main
|
||||
@@ -0,0 +1,24 @@
|
||||
name: Validate Docs (Gitea)
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [ main ]
|
||||
paths:
|
||||
- "docs/**"
|
||||
|
||||
jobs:
|
||||
validate:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Validate docs
|
||||
run: |
|
||||
set -e
|
||||
|
||||
test -d docs/public
|
||||
test -s docs/public/physical-topology.svg
|
||||
|
||||
! grep -R "Host inventory JSON not found" docs/public
|
||||
! grep -R "Generate terraform inventory" docs/public
|
||||
@@ -0,0 +1,35 @@
|
||||
name: Validate committed public docs
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
pull_request:
|
||||
branches: [main]
|
||||
workflow_dispatch:
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
validate-public-docs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- name: Ensure committed docs/public exists
|
||||
run: |
|
||||
test -d docs/public
|
||||
test -n "$(find docs/public -mindepth 1 -print -quit)"
|
||||
- name: Install MkDocs
|
||||
run: |
|
||||
python3 -m pip install --user mkdocs
|
||||
- name: Validate docs content
|
||||
run: |
|
||||
set -e
|
||||
test -s docs/public/physical-topology.svg
|
||||
test -s docs/public/docker-traefik-dynu.svg
|
||||
! grep -R "Host inventory JSON not found" docs/public
|
||||
! grep -R "Generate terraform inventory" docs/public
|
||||
! rg -n -i "password|token|api[_-]?key|secret" docs/public
|
||||
- name: Build MkDocs site
|
||||
run: |
|
||||
python3 -m mkdocs build -f mkdocs-public.yml --strict
|
||||
@@ -0,0 +1,84 @@
|
||||
name: Publish documentation site
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
workflow_dispatch:
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
pages: write
|
||||
id-token: write
|
||||
|
||||
concurrency:
|
||||
group: github-pages
|
||||
cancel-in-progress: true
|
||||
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Checkout repository
|
||||
uses: actions/checkout@v4
|
||||
|
||||
- name: Ensure committed docs/public exists
|
||||
run: |
|
||||
test -d docs/public
|
||||
test -n "$(find docs/public -mindepth 1 -print -quit)"
|
||||
|
||||
- name: Install Graphviz
|
||||
run: |
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y graphviz
|
||||
dot -V
|
||||
|
||||
- name: Validate sanitized diagram artifacts
|
||||
run: |
|
||||
test -f docs/public/physical-topology.svg
|
||||
test -f docs/public/docker-traefik-dynu.svg
|
||||
! rg -n "Graphviz dot not found" docs/public/*.svg
|
||||
! rg -n "lan\.ddnsgeek\.com" docs/public/*.svg docs/public/*.md
|
||||
! rg -n -i "password|token|api_key|secret" docs/public/*.svg
|
||||
|
||||
- name: Install MkDocs
|
||||
run: |
|
||||
python3 -m pip install --user mkdocs
|
||||
|
||||
- name: Build public MkDocs site
|
||||
run: |
|
||||
python3 -m mkdocs build -f mkdocs-public.yml --strict
|
||||
|
||||
- name: Verify published content excludes internal/generated docs
|
||||
run: |
|
||||
test -d site-public
|
||||
test ! -e site-public/generated
|
||||
test ! -e site-public/docker
|
||||
|
||||
- name: Verify expected 404-only paths are not generated
|
||||
run: |
|
||||
test ! -e site-public/generated/compose-inventory/index.html
|
||||
test ! -e site-public/generated/prometheus-rules/index.html
|
||||
test ! -e site-public/docker/index.html
|
||||
|
||||
- name: Configure GitHub Pages
|
||||
uses: actions/configure-pages@v5
|
||||
|
||||
- name: Upload GitHub Pages artifact
|
||||
uses: actions/upload-pages-artifact@v3
|
||||
with:
|
||||
path: site-public
|
||||
|
||||
deploy:
|
||||
runs-on: ubuntu-latest
|
||||
needs: build
|
||||
|
||||
environment:
|
||||
name: github-pages
|
||||
url: ${{ steps.deployment.outputs.page_url }}
|
||||
|
||||
steps:
|
||||
- name: Deploy to GitHub Pages
|
||||
id: deployment
|
||||
uses: actions/deploy-pages@v4
|
||||
+25
-1
@@ -4,13 +4,14 @@
|
||||
#!**/Dockerfile
|
||||
#!docker-compose.yml
|
||||
**/data/
|
||||
apps/gitea/runner-data/
|
||||
**/db/
|
||||
**/database/
|
||||
apps/nextcloud/config/
|
||||
core/crowdsec/config/
|
||||
**/.env
|
||||
!monitoring/node-red/data/
|
||||
apps/stockfill/
|
||||
apps/stockfill
|
||||
apps/shift-recorder/
|
||||
|
||||
!apps/searxng/
|
||||
@@ -24,6 +25,29 @@ monitoring/influxdb/*
|
||||
!monitoring/influxdb/docker-compose.yml
|
||||
secrets/*
|
||||
!secrets/.env.secrets.example
|
||||
!secrets/inventory.json
|
||||
!.env.example
|
||||
core/traefik/certs/*
|
||||
!core/traefik/certs/.gitkeep
|
||||
site/
|
||||
|
||||
# Docs generation artifacts intentionally tracked
|
||||
!data/terraform/proxmox-inventory.json
|
||||
!infrastructure/terraform/dynu/generated/
|
||||
!infrastructure/terraform/dynu/generated/dynu_dns_records_inventory.json
|
||||
!docs/generated/
|
||||
!docs/generated/docker-compose.resolved.yml
|
||||
!docs/generated/host-topology.md
|
||||
!docs/diagrams/
|
||||
!docs/diagrams/*.svg
|
||||
!docs/public/
|
||||
!docs/public/*.md
|
||||
!docs/public/*.svg
|
||||
|
||||
# Terraform local/state artifacts
|
||||
**/.terraform/
|
||||
**/.terraform.lock.hcl
|
||||
*.tfstate
|
||||
*.tfstate.*
|
||||
*.tfvars
|
||||
*.tfvars.json
|
||||
@@ -0,0 +1,80 @@
|
||||
# Codex instructions for this repository
|
||||
|
||||
This repository contains:
|
||||
- Docker Compose infrastructure
|
||||
- Terraform configuration
|
||||
- Ansible configuration
|
||||
|
||||
## General rules
|
||||
|
||||
Prefer validation and linting over execution.
|
||||
Do not make assumptions about runtime access.
|
||||
Do not run destructive commands.
|
||||
Do not install repo changes unless explicitly requested.
|
||||
|
||||
## Docker / Compose rules
|
||||
|
||||
This environment does not have Docker daemon access.
|
||||
Do not use commands that require `/var/run/docker.sock`.
|
||||
|
||||
Allowed:
|
||||
- `docker compose config`
|
||||
- `docker compose -f <file> config`
|
||||
- `./services-up.sh --profile all config`
|
||||
|
||||
Not allowed:
|
||||
- `docker compose up`
|
||||
- `docker compose down`
|
||||
- `docker compose run`
|
||||
- `docker compose exec`
|
||||
- `docker build`
|
||||
- `docker pull`
|
||||
|
||||
When validating Docker changes:
|
||||
1. Prefer `./services-up.sh --profile all config` if available.
|
||||
2. If that does not fit the task, use `docker compose -f ... config`.
|
||||
3. Only create temporary placeholder env files if validation requires them.
|
||||
4. Do not commit placeholder env files unless explicitly requested.
|
||||
|
||||
## Terraform rules
|
||||
|
||||
Allowed:
|
||||
- `terraform fmt -check -recursive`
|
||||
- `terraform init -backend=false -input=false`
|
||||
- `terraform validate`
|
||||
- `tflint`
|
||||
|
||||
Do not apply infrastructure changes unless explicitly requested.
|
||||
Do not run:
|
||||
- `terraform apply`
|
||||
- `terraform destroy`
|
||||
|
||||
If `terraform init` fails because access to `registry.terraform.io` is forbidden, do not summarize the error vaguely. Report the exact stderr. Continue with:
|
||||
- `terraform fmt -check -recursive`
|
||||
- static review of changed `.tf` files
|
||||
|
||||
Only run `terraform validate` when provider installation is available locally or registry access succeeds.
|
||||
|
||||
## Ansible rules
|
||||
|
||||
Allowed:
|
||||
- `ansible-lint`
|
||||
- `ansible-playbook --syntax-check <playbook>`
|
||||
|
||||
Do not run playbooks against real hosts unless explicitly requested.
|
||||
|
||||
## Shell / YAML rules
|
||||
|
||||
Allowed:
|
||||
- `shellcheck`
|
||||
- `yamllint`
|
||||
- `yq`
|
||||
- `jq`
|
||||
|
||||
## Expected workflow
|
||||
|
||||
When making changes:
|
||||
1. Edit the smallest necessary set of files.
|
||||
2. Run the safest available validation commands.
|
||||
3. Report validation results clearly.
|
||||
4. If validation is blocked by missing secrets, env files, or remote/provider access, say so explicitly instead of guessing.
|
||||
@@ -1,49 +0,0 @@
|
||||
# Deployment prerequisites (required)
|
||||
|
||||
Before running `docker compose up`, you **must** provision runtime secrets.
|
||||
|
||||
## 1) Create non-committed secret files
|
||||
|
||||
```bash
|
||||
cp secrets/.env.secrets.example secrets/stack-secrets.env
|
||||
chmod 600 secrets/stack-secrets.env
|
||||
```
|
||||
|
||||
Create these Docker secret files (all ignored by git):
|
||||
|
||||
- `secrets/nextcloud_db_root_password.txt`
|
||||
- `secrets/nextcloud_db_password.txt`
|
||||
- `secrets/nextcloud_admin_password.txt`
|
||||
- `secrets/nextcloud_smtp_password.txt`
|
||||
- `secrets/nextcloud_redis_password.txt`
|
||||
- `secrets/passbolt_db_password.txt`
|
||||
- `secrets/gramps_db_password.txt`
|
||||
- `secrets/influxdb_init_password.txt`
|
||||
- `secrets/prometheus_kuma_basic_auth_password.txt`
|
||||
|
||||
Recommended permissions:
|
||||
|
||||
```bash
|
||||
chmod 600 secrets/*.txt
|
||||
```
|
||||
|
||||
## 2) Rotate previously committed credentials
|
||||
|
||||
These values were previously hardcoded and must be rotated in upstream systems immediately:
|
||||
|
||||
- Database credentials (Nextcloud, Passbolt, Gramps, InfluxDB).
|
||||
- Nextcloud SMTP app password.
|
||||
- Authelia reset JWT secret, session secret, storage encryption key.
|
||||
- Traefik CrowdSec LAPI key.
|
||||
- Gotify admin password.
|
||||
- Prometheus Uptime Kuma basic-auth password.
|
||||
|
||||
## 3) Start stack
|
||||
|
||||
After secrets are provisioned:
|
||||
|
||||
```bash
|
||||
docker compose -f core/docker-compose.yml up -d
|
||||
docker compose -f monitoring/prometheus/docker-compose.yml up -d
|
||||
docker compose -f apps/nextcloud/docker-compose.yml up -d
|
||||
```
|
||||
@@ -1,8 +1,83 @@
|
||||
# Docker + Traefik Homelab Stack
|
||||
# Homelab Docker + Terraform Inventory Repository
|
||||
|
||||
This repository defines a multi-compose Docker environment with Traefik as ingress, app workloads, and a monitoring/alerting plane.
|
||||
This repository is both:
|
||||
|
||||
## High-Level Architecture
|
||||
1. **operational** (Docker Compose application/runtime definition), and
|
||||
2. **documentary/inventory-oriented** (Terraform capture of Proxmox VMs, host metadata, and selected Docker objects).
|
||||
|
||||
If you only read one section, read **[Source-of-truth boundaries](docs/source-of-truth.md)** first.
|
||||
|
||||
---
|
||||
|
||||
## Quick navigation
|
||||
|
||||
- Architecture overview: [docs/architecture.md](docs/architecture.md)
|
||||
- Repository layout: [docs/repo-structure.md](docs/repo-structure.md)
|
||||
- Source-of-truth boundaries and guardrails: [docs/source-of-truth.md](docs/source-of-truth.md)
|
||||
- Docker environment composition and `services-up.sh`: [docs/docker-environment.md](docs/docker-environment.md)
|
||||
- Terraform workflows (brownfield import/reconciliation): [docs/terraform-workflows.md](docs/terraform-workflows.md)
|
||||
- Infrastructure inventory intent and outputs: [docs/infrastructure-inventory.md](docs/infrastructure-inventory.md)
|
||||
- Dynu DNS read-only inventory workflow: [docs/dynu-dns-inventory.md](docs/dynu-dns-inventory.md)
|
||||
- Generated host topology doc: [docs/generated/host-topology.md](docs/generated/host-topology.md)
|
||||
- Ansible bootstrap workflows: [docs/ansible-workflows.md](docs/ansible-workflows.md)
|
||||
- Deployment prerequisites and secrets setup: [docs/deployment-prerequisites.md](docs/deployment-prerequisites.md)
|
||||
- Secrets inventory: [docs/security-secrets.md](docs/security-secrets.md)
|
||||
|
||||
Codex helper scripts:
|
||||
|
||||
- Initial Codex environment/bootstrap setup: [scripts/codex-setup.sh](scripts/codex-setup.sh)
|
||||
- Codex environment maintenance/refresh: [scripts/codex-maintenance.sh](scripts/codex-maintenance.sh)
|
||||
|
||||
Infrastructure subtrees:
|
||||
|
||||
- Ansible foundation docs: [infrastructure/ansible/README.md](infrastructure/ansible/README.md)
|
||||
- Terraform root docs: [infrastructure/terraform/README.md](infrastructure/terraform/README.md)
|
||||
- Terraform Docker mirror: [infrastructure/terraform/docker/README.md](infrastructure/terraform/docker/README.md)
|
||||
- Terraform Proxmox inventory: [infrastructure/terraform/proxmox/README.md](infrastructure/terraform/proxmox/README.md)
|
||||
|
||||
---
|
||||
|
||||
## Operating model
|
||||
|
||||
### Docker Compose (runtime authority)
|
||||
|
||||
- Compose files under `core/`, `apps/`, and `monitoring/` describe runtime services.
|
||||
- `services-up.sh` composes the environment by discovering compose files and applying common env/network inputs.
|
||||
- For service runtime behavior, start from Compose files and `services-up.sh` (not Terraform).
|
||||
|
||||
|
||||
### Ansible (bootstrap foundation)
|
||||
|
||||
- Ansible under `infrastructure/ansible/` is a phase-1 foundation for inventory/configuration scaffolding.
|
||||
- It supports safe validation (inventory parsing and playbook syntax checks) while hosts/devices are onboarded gradually.
|
||||
- It does not replace Compose runtime authority or Terraform reconciliation authority at this stage.
|
||||
|
||||
### Terraform (inventory and reconciliation authority)
|
||||
|
||||
- Terraform under `infrastructure/terraform/` is used to codify and reconcile existing infrastructure.
|
||||
- Current repo usage emphasizes **brownfield import-first workflows** and safe reconciliation.
|
||||
- Terraform captures:
|
||||
- Proxmox VM configuration for existing VMs.
|
||||
- Physical host metadata in locals/outputs.
|
||||
- Documentation-oriented Docker container mirroring (limited, selective).
|
||||
|
||||
Terraform here is **not** a replacement for Docker Compose deployment.
|
||||
|
||||
---
|
||||
|
||||
## Guardrails
|
||||
|
||||
- Do not run destructive Terraform commands casually.
|
||||
- Do not treat generated Terraform config as final without manual review.
|
||||
- Do not commit real secrets, credentials, or local state.
|
||||
- Keep one-resource-per-file patterns where already established in Terraform subdirectories.
|
||||
- Prefer shaping outputs for documentation/tooling consumption over dumping raw provider objects.
|
||||
|
||||
See [docs/source-of-truth.md](docs/source-of-truth.md) and [docs/terraform-workflows.md](docs/terraform-workflows.md) for concrete do/don't guidance.
|
||||
|
||||
---
|
||||
|
||||
## High-level architecture
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
@@ -43,21 +118,71 @@ flowchart TB
|
||||
Prometheus --> Gotify
|
||||
```
|
||||
|
||||
For a request-flow/network view and architecture notes, see [docs/architecture.md](docs/architecture.md).
|
||||
For request-flow and network detail, see [docs/architecture.md](docs/architecture.md).
|
||||
|
||||
## Prometheus Runtime Inventory Export
|
||||
Regenerate derived docs/diagrams from inventory:
|
||||
## Public docs publication workflow
|
||||
|
||||
Public docs are generated on the Docker host and committed to this repository. GitHub Actions only publishes committed content from `docs/public`.
|
||||
|
||||
1. Generate public docs locally from the repository root:
|
||||
|
||||
```bash
|
||||
./scripts/generate-public-docs.sh
|
||||
```
|
||||
|
||||
2. Inspect the generated changes:
|
||||
|
||||
```bash
|
||||
git diff -- docs/public docs/generated docs/diagrams
|
||||
```
|
||||
|
||||
3. Commit the generated public docs (and any supporting generated files you intend to version):
|
||||
|
||||
```bash
|
||||
git add docs/public docs/generated docs/diagrams
|
||||
git commit -m "docs: regenerate public docs"
|
||||
```
|
||||
|
||||
4. Push your branch:
|
||||
|
||||
```bash
|
||||
git push
|
||||
```
|
||||
|
||||
Only files under `docs/public` are published by GitHub Pages. Internal/generated documentation is not published unless it is deliberately copied/sanitized into `docs/public`.
|
||||
|
||||
### Regenerating architecture docs (Prometheus + Dynu DNS)
|
||||
|
||||
```bash
|
||||
python3 scripts/render_prometheus_docs.py --inventory-file docs/runtime/prometheus-inventory.json
|
||||
# Refresh Dynu live inventory and generated resources/import helpers
|
||||
cd infrastructure/terraform/dynu
|
||||
terraform apply -refresh-only
|
||||
python3 scripts/generate-brownfield-records.py --overwrite
|
||||
|
||||
# Regenerate architecture docs from Prometheus + Dynu inventory
|
||||
cd ../../..
|
||||
python3 scripts/render_prometheus_docs.py \
|
||||
--inventory-file docs/runtime/prometheus-inventory.json \
|
||||
--dynu-dns-inventory-file infrastructure/terraform/dynu/generated/dynu_dns_records_inventory.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Use `scripts/export_prometheus_inventory.py` to snapshot Prometheus-observed runtime inventory into versionable artifacts for docs/diagram workflows.
|
||||
## Codex setup and maintenance scripts
|
||||
|
||||
```bash
|
||||
export PROMETHEUS_URL="https://prometheus.example.com"
|
||||
python3 scripts/export_prometheus_inventory.py --output-dir docs/runtime
|
||||
```
|
||||
The repository includes helper scripts for Codex sessions that need local tooling and safe placeholder secret material for validation-only workflows:
|
||||
|
||||
This writes raw API snapshots and a normalized inventory JSON under `docs/runtime/`, and updates `docs/prometheus-inventory.md`.
|
||||
- `scripts/codex-setup.sh`
|
||||
- Installs baseline CLI dependencies (shell/yaml/terraform/ansible tooling).
|
||||
- Prepares `secrets/stack-secrets.env` from templates and creates dummy file-based secret placeholders based on `secrets/inventory.json`.
|
||||
- Installs/refreshed baseline Ansible collections when `infrastructure/ansible/collections/requirements.yml` is present.
|
||||
- Runs safe Ansible bootstrap checks (version, inventory parse, playbook syntax check) without live connectivity operations.
|
||||
- Prints installed tool versions for quick verification.
|
||||
|
||||
- `scripts/codex-maintenance.sh`
|
||||
- Refreshes Python-based linting/automation tooling.
|
||||
- Reconciles placeholder secret files against current `secrets/inventory.json` (creates missing, removes stale).
|
||||
- Rebuilds `secrets/stack-secrets.env` with dummy values for compose-config validation.
|
||||
- Refreshes Ansible collections and repeats safe inventory/syntax validation checks.
|
||||
|
||||
Both scripts are intended for local validation environments and should not be treated as production provisioning automation.
|
||||
@@ -1,40 +0,0 @@
|
||||
# Security Secrets Inventory
|
||||
|
||||
This inventory is aligned with `secrets/.env.secrets.example` and documents only the values that are expected to be set in the non-committed secrets env file (`secrets/stack-secrets.env`).
|
||||
|
||||
## Secrets expected in `secrets/.env.secrets.example`
|
||||
|
||||
| Variable | Used by | Purpose / Notes |
|
||||
|---|---|---|
|
||||
| `NEXTCLOUD_DB_USER` | `apps/nextcloud/docker-compose.yml` | Nextcloud database username (non-secret identifier but environment-specific). |
|
||||
| `NEXTCLOUD_ADMIN_USER` | `apps/nextcloud/docker-compose.yml` | Initial Nextcloud admin username. |
|
||||
| `NEXTCLOUD_SMTP_FROM_ADDRESS` | `apps/nextcloud/docker-compose.yml` | SMTP sender local-part for outbound mail configuration. |
|
||||
| `NEXTCLOUD_SMTP_DOMAIN` | `apps/nextcloud/docker-compose.yml` | SMTP sender domain for outbound mail configuration. |
|
||||
| `NEXTCLOUD_SMTP_NAME` | `apps/nextcloud/docker-compose.yml` | Derived from address + domain in the example file. |
|
||||
| `PASSBOLT_DB_NAME` | `apps/passbolt/docker-compose.yml` | Passbolt database name. |
|
||||
| `PASSBOLT_DB_USER` | `apps/passbolt/docker-compose.yml` | Passbolt database username. |
|
||||
| `PASSBOLT_GPG_SERVER_KEY_FINGERPRINT` | `apps/passbolt/docker-compose.yml` | Passbolt server GPG key fingerprint. |
|
||||
| `GRAMPS_DB_NAME` | `apps/gramps/docker-compose.yml` | Gramps database name. |
|
||||
| `GRAMPS_DB_USER` | `apps/gramps/docker-compose.yml` | Gramps database username. |
|
||||
| `GRAMPS_DB_PASSWORD` | `apps/gramps/docker-compose.yml` | Gramps database password. |
|
||||
| `GRAMPS_INITIAL_ADMIN` | `apps/gramps/docker-compose.yml` | Gramps initial admin username/email (deployment-specific). |
|
||||
| `GRAMPS_INITIAL_ADMIN_PASSWORD` | `apps/gramps/docker-compose.yml` | Gramps initial admin password. |
|
||||
| `GRAMPS_DB_URI` | `apps/gramps/docker-compose.yml` | Derived connection string in the example file. |
|
||||
| `GOTIFY_DEFAULTUSER_NAME` | `monitoring/gotify/docker-compose.yml` | Gotify default username. |
|
||||
| `GOTIFY_DEFAULTUSER_PASS` | `monitoring/gotify/docker-compose.yml` | Gotify default user password. |
|
||||
| `INFLUXDB_INIT_USERNAME` | `monitoring/prometheus/docker-compose.yml` | InfluxDB initial username. |
|
||||
| `PIHOLE_PASSWORD` | `monitoring/prometheus/docker-compose.yml` | Exporter auth / Pi-hole integration password. |
|
||||
|
||||
## Managed outside `.env.secrets.example`
|
||||
|
||||
The following sensitive values are intentionally not duplicated in `secrets/.env.secrets.example` because they are provided via Docker secrets (`*_FILE`) or other mounted secret files:
|
||||
|
||||
- Database/root passwords for Nextcloud, Passbolt, and supporting services that are wired through Docker secrets.
|
||||
- Redis runtime password (`--requirepass`) loaded from a Docker secret.
|
||||
- `DOCKER_INFLUXDB_INIT_PASSWORD` loaded from Docker secret in monitoring.
|
||||
- Uptime Kuma basic auth password loaded via `password_file` in Prometheus config.
|
||||
- Core stack secrets injected via env substitution in committed config files, such as:
|
||||
- `AUTHELIA_JWT_SECRET`
|
||||
- `AUTHELIA_SESSION_SECRET`
|
||||
- `AUTHELIA_STORAGE_ENCRYPTION_KEY`
|
||||
- `CROWDSEC_LAPI_KEY`
|
||||
@@ -0,0 +1,55 @@
|
||||
# Gitea
|
||||
|
||||
## Gitea Actions
|
||||
|
||||
Gitea Actions is enabled by setting:
|
||||
|
||||
- `GITEA__actions__ENABLED=true`
|
||||
|
||||
## Runner service
|
||||
|
||||
The repository includes a dedicated Gitea Actions runner service named:
|
||||
|
||||
- `gitea-runner`
|
||||
|
||||
The runner uses Docker through the existing Docker socket proxy:
|
||||
|
||||
- `DOCKER_HOST=tcp://docker-socket-proxy:2375`
|
||||
|
||||
The runner intentionally **does not** mount:
|
||||
|
||||
- `/var/run/docker.sock`
|
||||
|
||||
## Registration token
|
||||
|
||||
Generate a runner registration token from the Gitea UI:
|
||||
|
||||
- Site Administration → Actions → Runners
|
||||
- or Repo → Settings → Actions → Runners
|
||||
|
||||
Put the token in your env/secrets file:
|
||||
|
||||
- `GITEA_RUNNER_REGISTRATION_TOKEN=...`
|
||||
|
||||
## Start the runner
|
||||
|
||||
- `./services-up.sh --profile gitea up -d gitea-runner`
|
||||
- or `./services-up.sh --profile all up -d gitea-runner`
|
||||
|
||||
## Logs
|
||||
|
||||
- `docker logs -f gitea-runner`
|
||||
|
||||
## Labels
|
||||
|
||||
Common workflow label:
|
||||
|
||||
- `runs-on: ubuntu-latest`
|
||||
|
||||
This should match the configured labels, for example:
|
||||
|
||||
- `GITEA_RUNNER_LABELS=ubuntu-latest:docker://node:20-bookworm,...`
|
||||
|
||||
## Security note
|
||||
|
||||
The runner can control Docker through `docker-socket-proxy`. This is safer than mounting the raw Docker socket directly, but workflows still have meaningful control over Docker. Only trusted repositories/users should be allowed to run workflows on this runner.
|
||||
@@ -9,8 +9,10 @@ services:
|
||||
- USER_GID=${GITEA_USER_GID}
|
||||
- GITEA__database__DB_TYPE=${GITEA_DB_TYPE}
|
||||
- GITEA__server__ROOT_URL=${GITEA_ROOT_URL}
|
||||
- GITEA__actions__ENABLED=true
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/apps/gitea/data:/data
|
||||
# - ${PROJECT_ROOT}/apps/gitea/data:/data
|
||||
- ${DOCKER_VOLUMES}/gitea/data:/data
|
||||
networks:
|
||||
- traefik
|
||||
|
||||
@@ -23,6 +25,7 @@ services:
|
||||
- "traefik.http.services.gitea.loadbalancer.server.port=3000"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "traefik.docker.network=core_traefik"
|
||||
- "wud.watch=true"
|
||||
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "curl -fsS http://localhost:3000/api/healthz >/dev/null"]
|
||||
@@ -31,6 +34,27 @@ services:
|
||||
retries: 6
|
||||
start_period: 120s
|
||||
|
||||
gitea-runner:
|
||||
profiles: ["apps","all","gitea","ci"]
|
||||
container_name: gitea-runner
|
||||
image: gitea/act_runner:latest
|
||||
restart: always
|
||||
depends_on:
|
||||
- gitea
|
||||
- docker-socket-proxy
|
||||
environment:
|
||||
- GITEA_INSTANCE_URL=${GITEA_ROOT_URL}
|
||||
- GITEA_RUNNER_REGISTRATION_TOKEN=${GITEA_RUNNER_REGISTRATION_TOKEN}
|
||||
- GITEA_RUNNER_NAME=${GITEA_RUNNER_NAME}
|
||||
- GITEA_RUNNER_LABELS=${GITEA_RUNNER_LABELS}
|
||||
- DOCKER_HOST=${DOCKER_SOCKET_PROXY_HOST}
|
||||
volumes:
|
||||
# - ${PROJECT_ROOT}/apps/gitea/runner-data:/data
|
||||
- ${DOCKER_VOLUMES}/gitea/runner:/data
|
||||
networks:
|
||||
- traefik
|
||||
- docker-socket-proxy
|
||||
|
||||
#volumes:
|
||||
# gitea_data:
|
||||
|
||||
|
||||
+121
-49
@@ -1,58 +1,58 @@
|
||||
services:
|
||||
gramps-db:
|
||||
profiles: ["apps","all","gramps"]
|
||||
image: postgres:13
|
||||
container_name: gramps-db
|
||||
restart: always
|
||||
env_file:
|
||||
- ${SECRETS_ENV_FILE}
|
||||
environment:
|
||||
POSTGRES_USER: ${GRAMPS_DB_USER}
|
||||
POSTGRES_PASSWORD_FILE: /run/secrets/gramps_db_password
|
||||
POSTGRES_DB: ${GRAMPS_DB_NAME}
|
||||
secrets:
|
||||
- gramps_db_password
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/apps/gramps/db:/var/lib/postgresql
|
||||
networks:
|
||||
- gramps
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "pg_isready -h gramps-db -p 5432 -U $$POSTGRES_USER -d $$POSTGRES_DB"]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 12
|
||||
start_period: 30s
|
||||
|
||||
grampsweb:
|
||||
profiles: ["apps","all","gramps"]
|
||||
image: ghcr.io/gramps-project/grampsweb:latest
|
||||
container_name: gramps-web
|
||||
depends_on:
|
||||
- gramps-db
|
||||
- gramps-redis
|
||||
- grampsweb_celery
|
||||
restart: always
|
||||
env_file:
|
||||
- ${SECRETS_ENV_FILE}
|
||||
# env_file:
|
||||
# - ${SECRETS_ENV_FILE}
|
||||
environment:
|
||||
DB_URI: ${GRAMPS_DB_URI}
|
||||
GRAMPSWEB_LOGLEVEL: ${GRAMPSWEB_LOGLEVEL}
|
||||
# default admin user created on first run:
|
||||
INITIAL_ADMIN: ${GRAMPS_INITIAL_ADMIN}
|
||||
INITIAL_ADMIN_PASSWORD: ${GRAMPS_INITIAL_ADMIN_PASSWORD}
|
||||
# optional: storage paths inside container
|
||||
GRAMPSWEB_MEDIAPATH: ${GRAMPSWEB_MEDIAPATH}
|
||||
GRAMPSWEB_TREE: "${GRAMPSWEB_TREE}"
|
||||
TZ: ${TZ}
|
||||
GRAMPSWEB_TREE: ${GRAMPSWEB_TREE}
|
||||
GRAMPSWEB_BASE_URL: ${GRAMPSWEB_BASE_URL}
|
||||
GRAMPSWEB_SECRET_KEY: ${GRAMPSWEB_SECRET_KEY}
|
||||
GRAMPSWEB_REGISTRATION_DISABLED: ${GRAMPSWEB_REGISTRATION_DISABLED}
|
||||
GRAMPSWEB_EMAIL_HOST: ${GRAMPSWEB_EMAIL_HOST}
|
||||
GRAMPSWEB_EMAIL_PORT: ${GRAMPSWEB_EMAIL_PORT}
|
||||
GRAMPSWEB_EMAIL_HOST_USER: ${GRAMPSWEB_EMAIL_HOST_USER}
|
||||
GRAMPSWEB_EMAIL_HOST_PASSWORD: ${GRAMPSWEB_EMAIL_HOST_PASSWORD}
|
||||
GRAMPSWEB_EMAIL_USE_SSL: ${GRAMPSWEB_EMAIL_USE_SSL}
|
||||
GRAMPSWEB_EMAIL_USE_STARTTLS: ${GRAMPSWEB_EMAIL_USE_STARTTLS}
|
||||
GRAMPSWEB_DEFAULT_FROM_EMAIL: ${GRAMPSWEB_DEFAULT_FROM_EMAIL}
|
||||
GRAMPSWEB_CELERY_CONFIG__broker_url: redis://gramps-redis:6379/0
|
||||
GRAMPSWEB_CELERY_CONFIG__result_backend: redis://gramps-redis:6379/0
|
||||
GRAMPSWEB_RATELIMIT_STORAGE_URI: redis://gramps-redis:6379/1
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/apps/gramps/data/users:/app/users
|
||||
- ${PROJECT_ROOT}/apps/gramps/data/media:/app/media
|
||||
- ${PROJECT_ROOT}/apps/gramps/data/cache:/app/cache
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/users:/app/users
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/index:/app/indexdir
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/thumbnail_cache:/app/thumbnail_cache
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/cache:/app/cache
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/secret:/app/secret
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/db:/root/.gramps/grampsdb
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/media:/app/media
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/tmp:/tmp
|
||||
|
||||
- ${DOCKER_VOLUMES}/gramps-data/users:/app/users
|
||||
- ${DOCKER_VOLUMES}/gramps-data/index:/app/indexdir
|
||||
- ${DOCKER_VOLUMES}/gramps-data/thumbnail_cache:/app/thumbnail_cache
|
||||
- ${DOCKER_VOLUMES}/gramps-data/cache:/app/cache
|
||||
- ${DOCKER_VOLUMES}/gramps-data/secret:/app/secret
|
||||
- ${DOCKER_VOLUMES}/gramps-data/db:/root/.gramps/grampsdb
|
||||
- ${DOCKER_VOLUMES}/gramps-data/media:/app/media
|
||||
- ${DOCKER_VOLUMES}/gramps-data/tmp:/tmp
|
||||
|
||||
labels:
|
||||
- "traefik.http.routers.gramps.rule=Host(`familytree.lan.ddnsgeek.com`)"
|
||||
- "traefik.enable=true"
|
||||
- "traefik.http.routers.gramps.entrypoints=websecure"
|
||||
- "traefik.http.routers.gramps.tls.certresolver=myresolver"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "traefik.http.services.gramps.loadbalancer.server.port=5000"
|
||||
- "traefik.docker.network=core_traefik"
|
||||
- "traefik.http.routers.gramps.rule=Host(`familytree.lan.ddnsgeek.com`)"
|
||||
- "traefik.enable=true"
|
||||
- "traefik.http.routers.gramps.entrypoints=websecure"
|
||||
- "traefik.http.routers.gramps.tls.certresolver=myresolver"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "traefik.http.services.gramps.loadbalancer.server.port=5000"
|
||||
- "traefik.docker.network=core_traefik"
|
||||
- "wud.watch=true"
|
||||
networks:
|
||||
- traefik
|
||||
- gramps
|
||||
@@ -65,9 +65,81 @@ services:
|
||||
retries: 6
|
||||
start_period: 60s
|
||||
|
||||
grampsweb_celery:
|
||||
profiles: ["apps","all","gramps"]
|
||||
image: ghcr.io/gramps-project/grampsweb:latest
|
||||
container_name: gramps-web-celery
|
||||
command: celery -A gramps_webapi.celery worker --loglevel=INFO --concurrency=2
|
||||
depends_on:
|
||||
- gramps-redis
|
||||
restart: always
|
||||
# env_file:
|
||||
# - ${SECRETS_ENV_FILE}
|
||||
environment:
|
||||
TZ: ${TZ}
|
||||
GRAMPSWEB_TREE: ${GRAMPSWEB_TREE}
|
||||
GRAMPSWEB_BASE_URL: ${GRAMPSWEB_BASE_URL}
|
||||
GRAMPSWEB_SECRET_KEY: ${GRAMPSWEB_SECRET_KEY}
|
||||
GRAMPSWEB_REGISTRATION_DISABLED: ${GRAMPSWEB_REGISTRATION_DISABLED}
|
||||
GRAMPSWEB_EMAIL_HOST: ${GRAMPSWEB_EMAIL_HOST}
|
||||
GRAMPSWEB_EMAIL_PORT: ${GRAMPSWEB_EMAIL_PORT}
|
||||
GRAMPSWEB_EMAIL_HOST_USER: ${GRAMPSWEB_EMAIL_HOST_USER}
|
||||
GRAMPSWEB_EMAIL_HOST_PASSWORD: ${GRAMPSWEB_EMAIL_HOST_PASSWORD}
|
||||
GRAMPSWEB_EMAIL_USE_SSL: ${GRAMPSWEB_EMAIL_USE_SSL}
|
||||
GRAMPSWEB_EMAIL_USE_STARTTLS: ${GRAMPSWEB_EMAIL_USE_STARTTLS}
|
||||
GRAMPSWEB_DEFAULT_FROM_EMAIL: ${GRAMPSWEB_DEFAULT_FROM_EMAIL}
|
||||
GRAMPSWEB_CELERY_CONFIG__broker_url: redis://gramps-redis:6379/0
|
||||
GRAMPSWEB_CELERY_CONFIG__result_backend: redis://gramps-redis:6379/0
|
||||
GRAMPSWEB_RATELIMIT_STORAGE_URI: redis://gramps-redis:6379/1
|
||||
volumes:
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/users:/app/users
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/index:/app/indexdir
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/thumbnail_cache:/app/thumbnail_cache
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/cache:/app/cache
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/secret:/app/secret
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/db:/root/.gramps/grampsdb
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/media:/app/media
|
||||
# - ${PROJECT_ROOT}/apps/gramps/data/tmp:/tmp
|
||||
|
||||
- ${DOCKER_VOLUMES}/gramps-data/users:/app/users
|
||||
- ${DOCKER_VOLUMES}/gramps-data/index:/app/indexdir
|
||||
- ${DOCKER_VOLUMES}/gramps-data/thumbnail_cache:/app/thumbnail_cache
|
||||
- ${DOCKER_VOLUMES}/gramps-data/cache:/app/cache
|
||||
- ${DOCKER_VOLUMES}/gramps-data/secret:/app/secret
|
||||
- ${DOCKER_VOLUMES}/gramps-data/db:/root/.gramps/grampsdb
|
||||
- ${DOCKER_VOLUMES}/gramps-data/media:/app/media
|
||||
- ${DOCKER_VOLUMES}/gramps-data/tmp:/tmp
|
||||
labels:
|
||||
- "wud.watch=true"
|
||||
|
||||
networks:
|
||||
- gramps
|
||||
healthcheck:
|
||||
test:
|
||||
- CMD-SHELL
|
||||
- pgrep -f "celery.*gramps_webapi.celery.*worker" >/dev/null
|
||||
interval: 30s
|
||||
timeout: 5s
|
||||
retries: 6
|
||||
start_period: 60s
|
||||
|
||||
gramps-redis:
|
||||
profiles: ["apps","all","gramps"]
|
||||
image: valkey/valkey:9-trixie
|
||||
container_name: gramps-redis
|
||||
restart: always
|
||||
networks:
|
||||
- gramps
|
||||
healthcheck:
|
||||
test:
|
||||
- CMD-SHELL
|
||||
- valkey-cli -h 127.0.0.1 -p 6379 ping | grep -q PONG
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 6
|
||||
start_period: 10s
|
||||
labels:
|
||||
- "wud.watch=true"
|
||||
|
||||
networks:
|
||||
gramps:
|
||||
|
||||
secrets:
|
||||
gramps_db_password:
|
||||
file: ${PROJECT_ROOT}/secrets/gramps_db_password.txt
|
||||
@@ -1,19 +1,5 @@
|
||||
FROM nextcloud:production
|
||||
|
||||
#RUN groupadd -r doods && useradd -m -s /bin/bash -d /opt/doods -g doods doods
|
||||
#RUN chsh -s /usr/sbin/nologin root
|
||||
|
||||
#RUN chown -R doods:doods /opt/doods
|
||||
|
||||
#ENV PATH "${PATH}:/opt/doods"
|
||||
|
||||
#ENV HOME /opt/doods
|
||||
|
||||
#USER root
|
||||
|
||||
RUN apt-get update && \
|
||||
apt-get install -y ffmpeg && \
|
||||
apt-get clean && \
|
||||
rm -rf /var/lib/apt/lists/*
|
||||
|
||||
#USER www-data
|
||||
@@ -1,6 +1,7 @@
|
||||
services:
|
||||
nextcloud-webapp:
|
||||
profiles: ["apps","all","nextcloud"]
|
||||
image: nextcloud:production
|
||||
build:
|
||||
context: ${PROJECT_ROOT}/apps/nextcloud
|
||||
container_name: nextcloud-webapp
|
||||
@@ -9,10 +10,15 @@ services:
|
||||
# env_file:
|
||||
# - ${SECRETS_ENV_FILE}
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/apps/nextcloud/data:/var/www/html/data:rw
|
||||
- ${PROJECT_ROOT}/apps/nextcloud/config:/var/www/html/config:rw
|
||||
# - ${PROJECT_ROOT}/apps/nextcloud/data:/var/www/html/data:rw
|
||||
- ${NEXTCLOUD_DATA}:/var/www/html/data:rw
|
||||
# - ${PROJECT_ROOT}/apps/nextcloud/config:/var/www/html/config:rw
|
||||
- ${DOCKER_VOLUMES}/nextcloud/config:/var/www/html/config:rw
|
||||
- type: tmpfs
|
||||
target: /tmp:exec
|
||||
# - ${PROJECT_ROOT}/apps/nextcloud/entrypoint.sh:/entrypoint.sh
|
||||
# - ${PROJECT_ROOT}/apps/nextcloud/custom_apps:/var/www/html/custom_apps
|
||||
- ${DOCKER_VOLUMES}/nextcloud/custom_apps:/var/www/html/custom_apps
|
||||
depends_on:
|
||||
- nextcloud-db
|
||||
- nextcloud-redis
|
||||
@@ -34,11 +40,11 @@ services:
|
||||
- SMTP_PASSWORD_FILE=/run/secrets/nextcloud_smtp_password
|
||||
- REDIS_HOST=${NEXTCLOUD_REDIS_HOST}
|
||||
- REDIS_HOST_PORT=${NEXTCLOUD_REDIS_HOST_PORT}
|
||||
- REDIS_HOST_PASSWORD_FILE=/run/secrets/nextcloud_redis_password
|
||||
# - REDIS_HOST_PASSWORD_FILE=/run/secrets/nextcloud_redis_password
|
||||
secrets:
|
||||
- nextcloud_db_password
|
||||
- nextcloud_smtp_password
|
||||
- nextcloud_redis_password
|
||||
# - nextcloud_redis_password
|
||||
networks:
|
||||
- traefik
|
||||
- nextcloud
|
||||
@@ -57,6 +63,7 @@ services:
|
||||
- "traefik.http.middlewares.nextcloud-webfinger.redirectregex.regex=https://(.*)/.well-known/webfinger"
|
||||
- "traefik.http.middlewares.nextcloud-webfinger.redirectregex.replacement=https://$${1}/nextcloud/index.php/.well-known/webfinger"
|
||||
- "traefik.docker.network=core_traefik"
|
||||
- "wud.watch=true"
|
||||
healthcheck:
|
||||
test:
|
||||
- CMD-SHELL
|
||||
@@ -71,16 +78,17 @@ services:
|
||||
start_period: 180s
|
||||
|
||||
nextcloud-db:
|
||||
image: mariadb:11.4
|
||||
image: mariadb:${NEXTCLOUD_DB_VERSION}
|
||||
restart: always
|
||||
profiles: ["apps","all","nextcloud"]
|
||||
container_name: nextcloud-db
|
||||
hostname: nextcloud_db
|
||||
command: --transaction-isolation=READ-COMMITTED --log-bin=binlog --binlog-format=ROW
|
||||
command: --transaction-isolation=READ-COMMITTED --log-bin=binlog --binlog-format=ROW --log_bin_trust_function_creators=true
|
||||
# env_file:
|
||||
# - ${PROJECT_ROOT}/secrets/stack-secrets.env
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/apps/nextcloud/database:/var/lib/mysql:rw
|
||||
# - ${PROJECT_ROOT}/apps/nextcloud/database:/var/lib/mysql:rw
|
||||
- ${DOCKER_DATABASES}/nextcloud/mysql:/var/lib/mysql:rw
|
||||
environment:
|
||||
- MYSQL_ROOT_PASSWORD_FILE=/run/secrets/nextcloud_db_root_password
|
||||
- MYSQL_PASSWORD_FILE=/run/secrets/nextcloud_db_password
|
||||
@@ -97,30 +105,38 @@ services:
|
||||
- nextcloud
|
||||
labels:
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "wud.watch=true"
|
||||
- 'wud.tag.include=^11\.4(?:\.\d+)?$'
|
||||
# - "wud.tag.exclude=${NEXTCLOUD_DB_VERSION}-*"
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "mariadb-admin ping -u $$MYSQL_USER --password=$$(cat /run/secrets/nextcloud_db_password) --silent"]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 12
|
||||
start_period: 60s
|
||||
|
||||
|
||||
nextcloud-redis:
|
||||
image: "redis"
|
||||
profiles: ["apps","all","nextcloud"]
|
||||
command: ["sh", "-c", "redis-server --requirepass \"$$(cat /run/secrets/nextcloud_redis_password)\" --appendonly yes --save 60 1000"]
|
||||
# command: ["sh", "-c", "redis-server --requirepass \"$$(cat /run/secrets/nextcloud_redis_password)\" --appendonly yes --save 60 1000"]
|
||||
command: ["sh", "-c", "redis-server --appendonly yes --save 60 1000"]
|
||||
hostname: redis
|
||||
container_name: nextcloud-redis
|
||||
secrets:
|
||||
- nextcloud_redis_password
|
||||
# secrets:
|
||||
# - nextcloud_redis_password
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/apps/nextcloud/data/redis:/data:rw
|
||||
# - ${PROJECT_ROOT}/apps/nextcloud/data/redis:/data:rw
|
||||
- ${DOCKER_DATABASES}/nextcloud/redis:/data:rw
|
||||
restart: always
|
||||
networks:
|
||||
- nextcloud
|
||||
labels:
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "wud.watch=true"
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "redis-cli -a \"$$(cat /run/secrets/nextcloud_redis_password)\" PING | grep -q PONG"]
|
||||
# test: ["CMD-SHELL", "redis-cli -a \"$$(cat /run/secrets/nextcloud_redis_password)\" PING | grep -q PONG"]
|
||||
test: ["CMD-SHELL", "redis-cli PING | grep -q PONG"]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 6
|
||||
@@ -138,5 +154,5 @@ secrets:
|
||||
file: ${PROJECT_ROOT}/secrets/nextcloud_admin_password.txt
|
||||
nextcloud_smtp_password:
|
||||
file: ${PROJECT_ROOT}/secrets/nextcloud_smtp_password.txt
|
||||
nextcloud_redis_password:
|
||||
file: ${PROJECT_ROOT}/secrets/nextcloud_redis_password.txt
|
||||
# nextcloud_redis_password:
|
||||
# file: ${PROJECT_ROOT}/secrets/nextcloud_redis_password.txt
|
||||
Executable
+13
@@ -0,0 +1,13 @@
|
||||
#!/bin/bash
|
||||
set -e
|
||||
|
||||
OCC="/var/www/html/occ"
|
||||
|
||||
php $OCC app:install memories || true
|
||||
php $OCC app:enable memories || true
|
||||
|
||||
php $OCC app:install recognize || true
|
||||
php $OCC app:enable recognize || true
|
||||
|
||||
|
||||
exec apache2-foreground
|
||||
@@ -2,7 +2,7 @@ services:
|
||||
passbolt-db:
|
||||
profiles: ["apps","all","passbolt"]
|
||||
container_name: passbolt-db
|
||||
image: mariadb:12
|
||||
image: mariadb:latest
|
||||
restart: always
|
||||
# env_file:
|
||||
# - ${PROJECT_ROOT}/secrets/stack-secrets.env
|
||||
@@ -14,7 +14,8 @@ services:
|
||||
secrets:
|
||||
- passbolt_db_password
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/apps/passbolt/data/database:/var/lib/mysql
|
||||
# - ${PROJECT_ROOT}/apps/passbolt/data/database:/var/lib/mysql
|
||||
- ${DOCKER_DATABASES}/passbolt:/var/lib/mysql
|
||||
networks:
|
||||
- passbolt
|
||||
healthcheck:
|
||||
@@ -24,7 +25,8 @@ services:
|
||||
retries: 12
|
||||
start_period: 60s
|
||||
labels:
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "wud.watch=true"
|
||||
|
||||
passbolt-webapp:
|
||||
image: passbolt/passbolt:latest-ce
|
||||
@@ -45,8 +47,12 @@ services:
|
||||
secrets:
|
||||
- passbolt_db_password
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/apps/passbolt/data/gpg:/etc/passbolt/gpg
|
||||
- ${PROJECT_ROOT}/apps/passbolt/data/jwt:/etc/passbolt/jwt
|
||||
# - ${PROJECT_ROOT}/apps/passbolt/data/gpg:/etc/passbolt/gpg
|
||||
# - ${PROJECT_ROOT}/apps/passbolt/data/jwt:/etc/passbolt/jwt
|
||||
|
||||
- ${DOCKER_VOLUMES}/passbolt-data/gpg:/etc/passbolt/gpg
|
||||
- ${DOCKER_VOLUMES}/passbolt-data/jwt:/etc/passbolt/jwt
|
||||
|
||||
command:
|
||||
[
|
||||
"/usr/bin/wait-for.sh",
|
||||
@@ -66,6 +72,7 @@ services:
|
||||
- "traefik.http.routers.passbolt.tls.certresolver=myresolver"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "traefik.docker.network=core_traefik"
|
||||
- "wud.watch=true"
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "curl -fsS http://localhost/healthcheck/status | grep -qx OK"]
|
||||
interval: 30s
|
||||
|
||||
@@ -13,13 +13,14 @@ services:
|
||||
networks:
|
||||
- traefik
|
||||
labels:
|
||||
- "traefik.http.routers.searxng.rule=Host(`searxng.lan.ddnsgeek.com`)"
|
||||
- "traefik.enable=true"
|
||||
- "traefik.http.routers.searxng.entrypoints=websecure"
|
||||
- "traefik.http.routers.searxng.tls.certresolver=myresolver"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "traefik.http.routers.searxng.rule=Host(`searxng.lan.ddnsgeek.com`)"
|
||||
- "traefik.enable=true"
|
||||
- "traefik.http.routers.searxng.entrypoints=websecure"
|
||||
- "traefik.http.routers.searxng.tls.certresolver=myresolver"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
# - "traefik.http.routers.searxng.middlewares=crowdsec@file,secHeaders@file,error-pages-middleware"
|
||||
- "traefik.http.services.searxng.loadbalancer.server.port=8080"
|
||||
- "traefik.http.services.searxng.loadbalancer.server.port=8080"
|
||||
- "wud.watch=true"
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "python3 -c \"import urllib.request,sys; r=urllib.request.urlopen('http://127.0.0.1:8080/', timeout=3); sys.exit(0 if 200<=r.status<400 else 1)\""]
|
||||
interval: 20s
|
||||
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
+5
-1
@@ -16,7 +16,8 @@ services:
|
||||
|
||||
volumes:
|
||||
- ~/.docker/config.json:/root/.docker/config.json:ro
|
||||
- ${PROJECT_ROOT}/monitoring/docker-exporter/data:/data:rw
|
||||
# - ${PROJECT_ROOT}/monitoring/docker-exporter/data:/data:rw
|
||||
- ${DOCKER_VOLUMES}/docker-update-exporter-data:/data:rw
|
||||
- ${PROJECT_ROOT}:/compose:ro
|
||||
# - ${PROJECT_ROOT}/default-environment.env:/compose/default-environment.env:ro
|
||||
# - ${PROJECT_ROOT}/default-network.yml:/compose/default-network.yml:ro
|
||||
@@ -53,3 +54,6 @@ services:
|
||||
timeout: 5s
|
||||
retries: 3
|
||||
start_period: 10s
|
||||
#volumes:
|
||||
# docker-update-exporter-data:
|
||||
# external: true
|
||||
+52
-1
@@ -293,6 +293,18 @@ def get_compose_files_from_script(script_path):
|
||||
if not os.path.exists(script_path):
|
||||
return files
|
||||
base_dir = get_project_root_from_script(script_path)
|
||||
|
||||
def _clean_compose_path(raw_path):
|
||||
cleaned = str(raw_path).strip().strip(",")
|
||||
if (cleaned.startswith('"') and cleaned.endswith('"')) or (
|
||||
cleaned.startswith("'") and cleaned.endswith("'")
|
||||
):
|
||||
cleaned = cleaned[1:-1]
|
||||
expanded = expand_compose_path(cleaned, base_dir)
|
||||
if os.path.isabs(expanded):
|
||||
return os.path.normpath(expanded)
|
||||
return os.path.normpath(os.path.join(base_dir, expanded))
|
||||
|
||||
try:
|
||||
with open(script_path) as f:
|
||||
content = f.read()
|
||||
@@ -303,8 +315,47 @@ def get_compose_files_from_script(script_path):
|
||||
if line.startswith("-f"):
|
||||
path = line[2:].strip()
|
||||
if path:
|
||||
full = os.path.normpath(os.path.join(base_dir, path))
|
||||
full = _clean_compose_path(path)
|
||||
files.append(full)
|
||||
|
||||
# services-up.sh can append many compose files at runtime via:
|
||||
# FILES+=(-f "$file") done < <(find "$PROJECT_ROOT/apps" ...)
|
||||
# Mirror that behavior here so we can map service->compose image.
|
||||
root_dirs = []
|
||||
find_match = re.search(r'find\s+(.*?)\s+\\\s*\n', content)
|
||||
if find_match:
|
||||
for token in re.findall(r'"([^"]+)"|\'([^\']+)\'', find_match.group(1)):
|
||||
candidate = token[0] or token[1]
|
||||
if candidate:
|
||||
root_dirs.append(_clean_compose_path(candidate))
|
||||
else:
|
||||
root_dirs = [
|
||||
os.path.join(base_dir, "apps"),
|
||||
os.path.join(base_dir, "monitoring"),
|
||||
os.path.join(base_dir, "core"),
|
||||
]
|
||||
|
||||
for root_dir in root_dirs:
|
||||
if not os.path.isdir(root_dir):
|
||||
continue
|
||||
for candidate in sorted(os.listdir(root_dir)):
|
||||
svc_dir = os.path.join(root_dir, candidate)
|
||||
if not os.path.isdir(svc_dir):
|
||||
continue
|
||||
for compose_name in ("docker-compose.yml", "docker-compose.yaml"):
|
||||
compose_path = os.path.join(svc_dir, compose_name)
|
||||
if os.path.exists(compose_path):
|
||||
files.append(compose_path)
|
||||
|
||||
# Preserve order while removing duplicates.
|
||||
deduped = []
|
||||
seen = set()
|
||||
for path in files:
|
||||
if path in seen:
|
||||
continue
|
||||
seen.add(path)
|
||||
deduped.append(path)
|
||||
files = deduped
|
||||
except Exception as e:
|
||||
logger.warning(f"Failed parsing services-up.sh: {e}")
|
||||
return files
|
||||
File renamed without changes.
+6
-1
@@ -7,7 +7,8 @@ services:
|
||||
environment:
|
||||
- GF_SERVER_ROOT_URL=${GRAFANA_ROOT_URL}
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/monitoring/grafana/data:/var/lib/grafana
|
||||
# - ${PROJECT_ROOT}/monitoring/grafana/data:/var/lib/grafana
|
||||
- ${DOCKER_VOLUMES}/grafana-data:/var/lib/grafana
|
||||
networks:
|
||||
# - traefik_reverse_proxy
|
||||
# - prometheus_edge
|
||||
@@ -48,3 +49,7 @@ services:
|
||||
# external: true
|
||||
# prometheus_edge:
|
||||
# external: true
|
||||
|
||||
#volumes:
|
||||
# grafana-data:
|
||||
# external: true
|
||||
+9
-2
@@ -1,13 +1,14 @@
|
||||
services:
|
||||
influxdb:
|
||||
profiles: ["monitoring","all","influxdb", "prometheus"]
|
||||
image: influxdb:2.7
|
||||
image: influxdb:2
|
||||
container_name: influxdb
|
||||
restart: unless-stopped
|
||||
# env_file:
|
||||
# - ${PROJECT_ROOT}/secrets/stack-secrets.env
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/monitoring/influxdb:/var/lib/influxdb2
|
||||
# - ${PROJECT_ROOT}/monitoring/influxdb:/var/lib/influxdb2
|
||||
- ${DOCKER_DATABASES}/influxdb-data:/var/lib/influxdb2
|
||||
environment:
|
||||
DOCKER_INFLUXDB_INIT_MODE: ${INFLUXDB_INIT_MODE}
|
||||
DOCKER_INFLUXDB_INIT_USERNAME: ${INFLUXDB_INIT_USERNAME}
|
||||
@@ -21,6 +22,8 @@ services:
|
||||
# - traefik_reverse_proxy
|
||||
- traefik
|
||||
- monitor
|
||||
ports:
|
||||
- 8086:8086
|
||||
labels:
|
||||
- "traefik.http.routers.influxdb.rule=Host(`influxdb.lan.ddnsgeek.com`)"
|
||||
- "traefik.enable=true"
|
||||
@@ -41,3 +44,7 @@ services:
|
||||
secrets:
|
||||
influxdb_init_password:
|
||||
file: ${PROJECT_ROOT}/secrets/influxdb_init_password.txt
|
||||
|
||||
#volumes:
|
||||
# influxdb-data:
|
||||
# external: true
|
||||
File renamed without changes.
@@ -0,0 +1,60 @@
|
||||
# mTLS Bridge Service
|
||||
|
||||
Internal HTTP-to-mTLS bridge for services that cannot present client certificates directly (for example, Grafana webhooks).
|
||||
|
||||
## How it works
|
||||
|
||||
1. Accepts plain HTTP requests inside the Docker network.
|
||||
2. Forwards requests to an upstream base URL.
|
||||
3. Preserves the incoming request path/method/body/query string.
|
||||
4. Presents a client certificate/key pair for mTLS authentication.
|
||||
|
||||
## Environment variables
|
||||
|
||||
- `TARGET_URL` (required): upstream base URL (for example `http://node-red:1880`).
|
||||
- `CLIENT_CERT` (default `/certs/client.crt`): client certificate path.
|
||||
- `CLIENT_KEY` (default `/certs/client.key`): client private key path.
|
||||
- `UPSTREAM_CA_CERT` (optional, alias: `CA_CERT`): CA bundle path to verify upstream TLS. Use `false`/`0`/`no` to disable verification.
|
||||
- `TIMEOUT` (default `5`): request timeout in seconds.
|
||||
- `LOG_LEVEL` (default `INFO`): Python logging level.
|
||||
- `HEALTH_ENDPOINT` (default `/_mtls_bridge/health`): local container health endpoint path.
|
||||
- `ALLOWED_PATHS_FILE` (optional): file path containing one allowed endpoint path per line (for example `/health`). Blank lines and `#` comments are ignored. If unset, all paths are allowed.
|
||||
- `MTLS_BRIDGE_BASIC_AUTH_USERS` (required for Traefik auth): value for `traefik.http.middlewares.*.basicauth.users` (e.g. `user:$$apr1$$...`).
|
||||
- `MTLS_BRIDGE_CORS_ALLOW_ORIGIN` (default `https://grafana.lan.ddnsgeek.com`): origin allowed for browser-based panel actions.
|
||||
|
||||
## Endpoints
|
||||
|
||||
- `GET /_mtls_bridge/health` returns `200 OK` for container health checks.
|
||||
- `/*` proxies requests to `${TARGET_URL}/*` with method/body/headers/query string preserved (subject to optional allow-list checks).
|
||||
|
||||
Examples with `TARGET_URL=http://node-red:1880`:
|
||||
|
||||
- `https://mtls-bridge.../docker-update-lockouts/clear` -> `http://node-red:1880/docker-update-lockouts/clear`
|
||||
- `https://mtls-bridge.../health` -> `http://node-red:1880/health`
|
||||
- `https://mtls-bridge.../uptime-kuma` -> `http://node-red:1880/uptime-kuma`
|
||||
|
||||
## Compose integration
|
||||
|
||||
This repository includes `monitoring/mtls-bridge/docker-compose.yml`:
|
||||
|
||||
- No public port exposure.
|
||||
- Read-only cert mount (`${PROJECT_ROOT}/core/traefik/certs:/certs:ro`).
|
||||
- Joined to internal monitoring/traefik networks.
|
||||
|
||||
## Example test
|
||||
|
||||
```bash
|
||||
curl http://mtls-bridge:8080/_mtls_bridge/health
|
||||
curl -X POST http://mtls-bridge:8080/docker-update-lockouts/clear
|
||||
```
|
||||
|
||||
## Allow-list file example
|
||||
|
||||
```text
|
||||
# one path per line
|
||||
/docker-update-lockouts/clear
|
||||
/health
|
||||
/uptime-kuma
|
||||
```
|
||||
|
||||
When `ALLOWED_PATHS_FILE` is set, any path not listed returns `403 Endpoint not allowed`.
|
||||
+74
-106
@@ -1,6 +1,7 @@
|
||||
import logging
|
||||
import os
|
||||
import time
|
||||
from urllib.parse import urljoin
|
||||
|
||||
import requests
|
||||
from flask import Flask, Response, g, request
|
||||
@@ -15,23 +16,39 @@ logger = logging.getLogger("mtls-bridge")
|
||||
logging.getLogger("werkzeug").setLevel(logging.WARNING)
|
||||
|
||||
# Config via env
|
||||
TARGET_URL = os.environ.get("TARGET_URL")
|
||||
TARGET_URL = (os.environ.get("TARGET_URL") or "").strip()
|
||||
CLIENT_CERT = os.environ.get("CLIENT_CERT", "/certs/client.crt")
|
||||
CLIENT_KEY = os.environ.get("CLIENT_KEY", "/certs/client.key")
|
||||
UPSTREAM_CA_CERT = os.environ.get("UPSTREAM_CA_CERT", os.environ.get("CA_CERT", "")).strip()
|
||||
# Backward-compat alias: keep CA_CERT defined so legacy code paths/log statements don't crash.
|
||||
CA_CERT = UPSTREAM_CA_CERT
|
||||
TIMEOUT = int(os.environ.get("TIMEOUT", "5"))
|
||||
HEALTH_ENDPOINT = os.environ.get("HEALTH_ENDPOINT", "/_mtls_bridge/health")
|
||||
ALLOWED_PATHS_FILE = (os.environ.get("ALLOWED_PATHS_FILE") or "").strip()
|
||||
|
||||
logger.info(
|
||||
"mtls-bridge starting target_url=%s timeout=%ss cert=%s key=%s ca=%s log_level=%s",
|
||||
TARGET_URL,
|
||||
TIMEOUT,
|
||||
CLIENT_CERT,
|
||||
CLIENT_KEY,
|
||||
CA_CERT,
|
||||
os.environ.get("LOG_LEVEL", "INFO"),
|
||||
)
|
||||
|
||||
def normalize_path(path: str) -> str:
|
||||
if not path or path == "/":
|
||||
return "/"
|
||||
return f"/{path.lstrip('/')}"
|
||||
|
||||
|
||||
def load_allowed_paths() -> set[str]:
|
||||
if not ALLOWED_PATHS_FILE:
|
||||
return set()
|
||||
|
||||
if not os.path.exists(ALLOWED_PATHS_FILE):
|
||||
logger.warning("ALLOWED_PATHS_FILE does not exist: %s (allow-list disabled)", ALLOWED_PATHS_FILE)
|
||||
return set()
|
||||
|
||||
allowed_paths = set()
|
||||
with open(ALLOWED_PATHS_FILE, encoding="utf-8") as f:
|
||||
for line in f:
|
||||
entry = line.strip()
|
||||
if not entry or entry.startswith("#"):
|
||||
continue
|
||||
allowed_paths.add(normalize_path(entry))
|
||||
|
||||
logger.info("loaded %s allowed path(s) from %s", len(allowed_paths), ALLOWED_PATHS_FILE)
|
||||
return allowed_paths
|
||||
|
||||
|
||||
def get_verify_setting():
|
||||
@@ -54,95 +71,47 @@ def get_verify_setting():
|
||||
|
||||
|
||||
VERIFY_SETTING = get_verify_setting()
|
||||
|
||||
logger.info(
|
||||
"mtls-bridge starting target_url=%s timeout=%ss cert=%s key=%s verify=%s log_level=%s",
|
||||
TARGET_URL,
|
||||
TIMEOUT,
|
||||
CLIENT_CERT,
|
||||
CLIENT_KEY,
|
||||
VERIFY_SETTING,
|
||||
os.environ.get("LOG_LEVEL", "INFO"),
|
||||
)
|
||||
|
||||
|
||||
def get_verify_setting():
|
||||
if not UPSTREAM_CA_CERT:
|
||||
return True
|
||||
|
||||
lowered = UPSTREAM_CA_CERT.lower()
|
||||
if lowered in {"false", "0", "no"}:
|
||||
logger.warning("TLS verification for upstream is disabled via UPSTREAM_CA_CERT=%s", UPSTREAM_CA_CERT)
|
||||
return False
|
||||
|
||||
if not os.path.exists(UPSTREAM_CA_CERT):
|
||||
logger.warning(
|
||||
"Configured UPSTREAM_CA_CERT path does not exist: %s (falling back to system CA bundle)",
|
||||
UPSTREAM_CA_CERT,
|
||||
)
|
||||
return True
|
||||
|
||||
return UPSTREAM_CA_CERT
|
||||
|
||||
|
||||
VERIFY_SETTING = get_verify_setting()
|
||||
|
||||
logger.info(
|
||||
"mtls-bridge starting target_url=%s timeout=%ss cert=%s key=%s verify=%s log_level=%s",
|
||||
TARGET_URL,
|
||||
TIMEOUT,
|
||||
CLIENT_CERT,
|
||||
CLIENT_KEY,
|
||||
VERIFY_SETTING,
|
||||
os.environ.get("LOG_LEVEL", "INFO"),
|
||||
)
|
||||
ALLOWED_PATHS = load_allowed_paths()
|
||||
|
||||
if TARGET_URL and TARGET_URL.lower().startswith("http://"):
|
||||
logger.warning(
|
||||
"TARGET_URL uses http://; upstream may redirect to https:// and change request behavior: %s",
|
||||
TARGET_URL,
|
||||
)
|
||||
|
||||
|
||||
def get_verify_setting():
|
||||
if not UPSTREAM_CA_CERT:
|
||||
return True
|
||||
|
||||
lowered = UPSTREAM_CA_CERT.lower()
|
||||
if lowered in {"false", "0", "no"}:
|
||||
logger.warning("TLS verification for upstream is disabled via UPSTREAM_CA_CERT=%s", UPSTREAM_CA_CERT)
|
||||
return False
|
||||
|
||||
if not os.path.exists(UPSTREAM_CA_CERT):
|
||||
logger.warning(
|
||||
"Configured UPSTREAM_CA_CERT path does not exist: %s (falling back to system CA bundle)",
|
||||
UPSTREAM_CA_CERT,
|
||||
)
|
||||
return True
|
||||
|
||||
return UPSTREAM_CA_CERT
|
||||
|
||||
|
||||
VERIFY_SETTING = get_verify_setting()
|
||||
logger.warning("TARGET_URL uses http:// (plaintext): %s", TARGET_URL)
|
||||
|
||||
logger.info(
|
||||
"mtls-bridge starting target_url=%s timeout=%ss cert=%s key=%s verify=%s log_level=%s",
|
||||
"mtls-bridge starting target_url=%s timeout=%ss cert=%s key=%s verify=%s health_endpoint=%s allow_list_file=%s allow_list_entries=%s log_level=%s",
|
||||
TARGET_URL,
|
||||
TIMEOUT,
|
||||
CLIENT_CERT,
|
||||
CLIENT_KEY,
|
||||
VERIFY_SETTING,
|
||||
HEALTH_ENDPOINT,
|
||||
ALLOWED_PATHS_FILE,
|
||||
len(ALLOWED_PATHS),
|
||||
os.environ.get("LOG_LEVEL", "INFO"),
|
||||
)
|
||||
|
||||
if TARGET_URL and TARGET_URL.lower().startswith("http://"):
|
||||
logger.warning(
|
||||
"TARGET_URL uses http://; upstream may redirect to https:// and change request behavior: %s",
|
||||
TARGET_URL,
|
||||
)
|
||||
|
||||
def build_upstream_url(path: str) -> str:
|
||||
"""Map incoming path directly onto TARGET_URL origin/base path."""
|
||||
if not TARGET_URL:
|
||||
raise ValueError("TARGET_URL is not set")
|
||||
|
||||
normalized_target = TARGET_URL.rstrip("/") + "/"
|
||||
normalized_path = path.lstrip("/")
|
||||
upstream_url = urljoin(normalized_target, normalized_path)
|
||||
|
||||
if request.query_string:
|
||||
upstream_url = f"{upstream_url}?{request.query_string.decode('utf-8', 'ignore')}"
|
||||
|
||||
return upstream_url
|
||||
|
||||
|
||||
@app.route("/health", methods=["GET"])
|
||||
def is_path_allowed(request_path: str) -> bool:
|
||||
if not ALLOWED_PATHS:
|
||||
return True
|
||||
return request_path in ALLOWED_PATHS
|
||||
|
||||
|
||||
@app.route(HEALTH_ENDPOINT, methods=["GET"])
|
||||
def health():
|
||||
logger.debug("healthcheck request from %s", request.remote_addr)
|
||||
return "OK", 200
|
||||
@@ -156,7 +125,7 @@ def before_request():
|
||||
@app.after_request
|
||||
def after_request(response):
|
||||
elapsed_ms = int((time.time() - g.request_start) * 1000)
|
||||
if request.path != "/health":
|
||||
if request.path != HEALTH_ENDPOINT:
|
||||
logger.info(
|
||||
"request complete method=%s path=%s status=%s elapsed_ms=%s",
|
||||
request.method,
|
||||
@@ -179,7 +148,7 @@ def after_request(response):
|
||||
provide_automatic_options=False,
|
||||
)
|
||||
def proxy(path):
|
||||
request_path = f"/{path}" if path else "/"
|
||||
request_path = normalize_path(path)
|
||||
request_size = len(request.get_data(cache=True))
|
||||
logger.info(
|
||||
"incoming request method=%s path=%s query=%s remote=%s bytes=%s",
|
||||
@@ -190,50 +159,49 @@ def proxy(path):
|
||||
request_size,
|
||||
)
|
||||
|
||||
if not TARGET_URL:
|
||||
logger.error("TARGET_URL is not set; cannot proxy request")
|
||||
return Response("TARGET_URL is not set", status=500)
|
||||
if not is_path_allowed(request_path):
|
||||
logger.warning("request blocked by allow-list path=%s", request_path)
|
||||
return Response("Endpoint not allowed", status=403)
|
||||
|
||||
try:
|
||||
url = f"{TARGET_URL.rstrip('/')}/{path}".rstrip("/")
|
||||
start_time = time.time()
|
||||
upstream_url = build_upstream_url(path)
|
||||
|
||||
headers = {k: v for k, v in request.headers if k.lower() != "host"}
|
||||
headers["X-Forwarded-By"] = "mtls-bridge"
|
||||
|
||||
logger.debug("forwarding request to upstream url=%s headers=%s", url, headers)
|
||||
|
||||
start_time = time.time()
|
||||
resp = requests.request(
|
||||
method=request.method,
|
||||
url=url,
|
||||
url=upstream_url,
|
||||
headers=headers,
|
||||
data=request.get_data(cache=True),
|
||||
cookies=request.cookies,
|
||||
cert=(CLIENT_CERT, CLIENT_KEY),
|
||||
verify=VERIFY_SETTING,
|
||||
timeout=TIMEOUT,
|
||||
allow_redirects=False,
|
||||
)
|
||||
|
||||
elapsed_ms = int((time.time() - start_time) * 1000)
|
||||
logger.info(
|
||||
"upstream response status=%s url=%s elapsed_ms=%s response_bytes=%s",
|
||||
resp.status_code,
|
||||
url,
|
||||
upstream_url,
|
||||
elapsed_ms,
|
||||
len(resp.content),
|
||||
)
|
||||
|
||||
excluded_headers = ["content-encoding", "content-length", "transfer-encoding", "connection"]
|
||||
response_headers = [
|
||||
(k, v)
|
||||
for k, v in resp.raw.headers.items()
|
||||
if k.lower() not in excluded_headers
|
||||
]
|
||||
excluded_headers = {"content-encoding", "content-length", "transfer-encoding", "connection"}
|
||||
response_headers = [(k, v) for k, v in resp.headers.items() if k.lower() not in excluded_headers]
|
||||
|
||||
return Response(resp.content, resp.status_code, response_headers)
|
||||
|
||||
except Exception as e:
|
||||
except ValueError as exc:
|
||||
logger.error("proxy request failed: %s", exc)
|
||||
return Response(str(exc), status=500)
|
||||
except Exception as exc: # noqa: BLE001
|
||||
logger.exception("proxy request failed")
|
||||
return Response(str(e), status=500)
|
||||
return Response(str(exc), status=500)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
@@ -0,0 +1,49 @@
|
||||
services:
|
||||
mtls-bridge:
|
||||
profiles: ["monitoring", "all", "mtls-bridge"]
|
||||
build:
|
||||
context: ${PROJECT_ROOT}/monitoring/mtls-bridge
|
||||
container_name: mtls-bridge
|
||||
hostname: mtls-bridge.lan.ddnsgeek.com
|
||||
restart: unless-stopped
|
||||
environment:
|
||||
- TARGET_URL=${MTLS_BRIDGE_TARGET_URL}
|
||||
- CLIENT_CERT=${MTLS_BRIDGE_CLIENT_CERT}
|
||||
- CLIENT_KEY=${MTLS_BRIDGE_CLIENT_KEY}
|
||||
- TIMEOUT=${MTLS_BRIDGE_TIMEOUT}
|
||||
- LOG_LEVEL=${MTLS_BRIDGE_LOG_LEVEL:-INFO}
|
||||
- UPSTREAM_CA_CERT=${MTLS_BRIDGE_UPSTREAM_CA_CERT:-}
|
||||
- ALLOWED_PATHS_FILE=${MTLS_BRIDGE_ALLOWED_PATHS_FILE:-}
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/core/traefik/certs:/certs:ro
|
||||
labels:
|
||||
- "traefik.http.routers.mtls-bridge.rule=Host(`mtls-bridge.lan.ddnsgeek.com`)"
|
||||
- "traefik.enable=true"
|
||||
- "traefik.http.routers.mtls-bridge.entrypoints=websecure"
|
||||
- "traefik.http.routers.mtls-bridge.tls.certresolver=myresolver"
|
||||
- "traefik.http.routers.mtls-bridge.middlewares=mtls-bridge-auth,mtls-bridge-cors"
|
||||
- "traefik.http.middlewares.mtls-bridge-auth.basicauth.users=${MTLS_BRIDGE_BASIC_AUTH_USERS}"
|
||||
- "traefik.http.routers.mtls-bridge-preflight.rule=Host(`mtls-bridge.lan.ddnsgeek.com`) && Method(`OPTIONS`)"
|
||||
- "traefik.http.routers.mtls-bridge-preflight.entrypoints=websecure"
|
||||
- "traefik.http.routers.mtls-bridge-preflight.tls.certresolver=myresolver"
|
||||
- "traefik.http.routers.mtls-bridge-preflight.middlewares=mtls-bridge-cors"
|
||||
- "traefik.http.routers.mtls-bridge-preflight.priority=100"
|
||||
- "traefik.http.routers.mtls-bridge-preflight.service=mtls-bridge"
|
||||
- "traefik.http.middlewares.mtls-bridge-cors.headers.accesscontrolalloworiginlist=${MTLS_BRIDGE_CORS_ALLOW_ORIGIN}"
|
||||
- "traefik.http.middlewares.mtls-bridge-cors.headers.accesscontrolallowmethods=GET,POST,PUT,PATCH,DELETE,OPTIONS"
|
||||
- "traefik.http.middlewares.mtls-bridge-cors.headers.accesscontrolallowheaders=authorization,content-type,x-grafana-action,x-grafana-device-id"
|
||||
- "traefik.http.middlewares.mtls-bridge-cors.headers.accesscontrolallowcredentials=true"
|
||||
- "traefik.http.middlewares.mtls-bridge-cors.headers.addvaryheader=true"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
# - "traefik.http.routers.searxng.middlewares=crowdsec@file,secHeaders@file,error-pages-middleware"
|
||||
- "traefik.http.services.mtls-bridge.loadbalancer.server.port=8080"
|
||||
- "traefik.docker.network=core_traefik"
|
||||
healthcheck:
|
||||
test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8080/_mtls_bridge/health', timeout=3).read()"]
|
||||
interval: 30s
|
||||
timeout: 5s
|
||||
retries: 3
|
||||
start_period: 10s
|
||||
networks:
|
||||
- monitor
|
||||
- traefik
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
+5
-1
@@ -19,7 +19,8 @@ services:
|
||||
# ports:
|
||||
# - "1880:1880"
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/monitoring/node-red/data:/data
|
||||
# - ${PROJECT_ROOT}/monitoring/node-red/data:/data
|
||||
- ${DOCKER_VOLUMES}/node-red-data:/data
|
||||
- ${PROJECT_ROOT}:/compose/docker:ro
|
||||
- /home/nixos/raspi:/compose/raspi:ro
|
||||
# - ${PROJECT_ROOT}:/usr/src/node-red:ro
|
||||
@@ -61,3 +62,6 @@ services:
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "traefik.docker.network=core_traefik"
|
||||
- "traefik.http.services.node-red.loadbalancer.server.port=1880"
|
||||
#volumes:
|
||||
# node-red-data:
|
||||
# external: true
|
||||
File renamed without changes.
File renamed without changes.
+10
-2
@@ -20,8 +20,10 @@ services:
|
||||
# context: ${PROJECT_ROOT}/monitoring/prometheus
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/monitoring/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
|
||||
- ${PROJECT_ROOT}/monitoring/prometheus/data:/prometheus
|
||||
- ${PROJECT_ROOT}/monitoring/prometheus/rules:/etc/prometheus/rules:ro
|
||||
# - ${PROJECT_ROOT}/monitoring/prometheus/data:/prometheus
|
||||
# - ${PROJECT_ROOT}/monitoring/prometheus/rules:/etc/prometheus/rules:ro
|
||||
- ${DOCKER_VOLUMES}/prometheus/data:/prometheus
|
||||
- ${DOCKER_VOLUMES}/prometheus/rules:/etc/prometheus/rules:ro
|
||||
- ${PROJECT_ROOT}/secrets/prometheus_kuma_basic_auth_password.txt:/run/secrets/prometheus_kuma_basic_auth_password:ro
|
||||
|
||||
restart: unless-stopped
|
||||
@@ -46,3 +48,9 @@ services:
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 30s
|
||||
|
||||
#volumes:
|
||||
# prometheus-data:
|
||||
# external: true
|
||||
# prometheus-rules:
|
||||
# external: true
|
||||
+10
-5
@@ -109,6 +109,11 @@ scrape_configs:
|
||||
- kuma.lan.ddnsgeek.com
|
||||
labels:
|
||||
role: raspberrypi
|
||||
tls_config:
|
||||
# ca_file: /prometheus/clients-ca.crt
|
||||
cert_file: /prometheus/office-pc.crt
|
||||
key_file: /prometheus/office-pc.key
|
||||
# server_name: kuma.lan.ddnsgeek.com
|
||||
|
||||
# =========================
|
||||
# Proxmox Storage Exporters
|
||||
@@ -122,11 +127,11 @@ scrape_configs:
|
||||
role: proxmox
|
||||
storage: lvm
|
||||
|
||||
- targets:
|
||||
- pbs.sweet.home:9102
|
||||
labels:
|
||||
role: backup
|
||||
storage: datastore
|
||||
# - targets:
|
||||
# - pbs.sweet.home:9102
|
||||
# labels:
|
||||
# role: backup
|
||||
# storage: datastore
|
||||
|
||||
# =========================
|
||||
# Docker Updates Exporter
|
||||
File renamed without changes.
+3
-1
@@ -12,7 +12,9 @@ services:
|
||||
- no-new-privileges:true
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/monitoring/telegraf/telegraf.conf:/etc/telegraf/telegraf.conf:ro
|
||||
- ${PROJECT_ROOT}/monitoring/node-red/data:/var/log/node-red:ro
|
||||
# - ${PROJECT_ROOT}/monitoring/node-red/data:/var/log/node-red:ro
|
||||
|
||||
- ${DOCKER_VOLUMES}/node-red-data:/var/log/node-red:ro
|
||||
networks:
|
||||
# - edge
|
||||
- monitor
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -3,7 +3,9 @@ server.address: tcp://0.0.0.0:9091
|
||||
log:
|
||||
level: info
|
||||
|
||||
identity_validation.reset_password.jwt_secret: T72Xcxa4d7xpQRypFDZpunlZt0IjqspojmBlxBr69gnkRjzR144YgjZsgFYZK0gS
|
||||
identity_validation:
|
||||
reset_password:
|
||||
jwt_secret: T72Xcxa4d7xpQRypFDZpunlZt0IjqspojmBlxBr69gnkRjzR144YgjZsgFYZK0gS
|
||||
|
||||
session:
|
||||
secret: BYksO7YUAJ8gXx9Endgpe46RgB10nkeKpD1qcQPt0GuYGQm2pS2zjJtNOrCEqpav
|
||||
|
||||
@@ -3,16 +3,19 @@ services:
|
||||
profiles: ["core","all","authelia", "traefik"]
|
||||
image: authelia/authelia
|
||||
restart: always
|
||||
build:
|
||||
context: ${PROJECT_ROOT}/core/authelia
|
||||
# env_file:
|
||||
# - ${PROJECT_ROOT}/secrets/stack-secrets.env
|
||||
# build:
|
||||
# context: ${PROJECT_ROOT}/core/authelia
|
||||
env_file:
|
||||
- ${PROJECT_ROOT}/secrets/stack-secrets.env
|
||||
# environment:
|
||||
# - AUTHELIA_IDENTITY_VALIDATION_RESET_PASSWORD_JWT_SECRET:${AUTHELIA_JWT_SECRET}
|
||||
# - AUTHELIA_SESSION_SECRET:${AUTHELIA_SESSION_SECRET}
|
||||
# - AUTHELIA_STORAGE_ENCRYPTION_KEY:${AUTHELIA_STORAGE_ENCRYPTION_KEY}
|
||||
# - AUTHELIA_IDENTITY_VALIDATION_RESET_PASSWORD_JWT_SECRET=${AUTHELIA_JWT_SECRET}
|
||||
# - AUTHELIA_SESSION_SECRET=${AUTHELIA_SESSION_SECRET}
|
||||
# - AUTHELIA_STORAGE_ENCRYPTION_KEY=${AUTHELIA_STORAGE_ENCRYPTION_KEY}
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/core/authelia:/config
|
||||
# - ${PROJECT_ROOT}/core/authelia:/config
|
||||
- ${DOCKER_VOLUMES}/authelia-data:/config/data
|
||||
- ${PROJECT_ROOT}/core/authelia/configuration.yml:/config/configuration.yml:ro
|
||||
- ${PROJECT_ROOT}/core/authelia/users_database.yml:/config/users_database.yml:ro
|
||||
networks:
|
||||
# - reverse_proxy
|
||||
- traefik
|
||||
@@ -28,3 +31,4 @@ services:
|
||||
- traefik.http.middlewares.authelia.forwardauth.trustForwardHeader=true
|
||||
- traefik.http.middlewares.authelia.forwardauth.authResponseHeaders=Remote-User,Remote-Groups
|
||||
- traefik.http.middlewares.authelia.forwardauth.maxResponseBodySize=2097152
|
||||
- "wud.watch=true"
|
||||
@@ -1,6 +1,6 @@
|
||||
FROM crowdsecurity/crowdsec:latest
|
||||
|
||||
COPY config/ /etc/crowdsec
|
||||
#COPY config/ /etc/crowdsec
|
||||
# Install required components at build time
|
||||
RUN cscli hub update && \
|
||||
cscli collections install crowdsecurity/traefik --force
|
||||
#RUN cscli hub update && \
|
||||
# cscli collections install crowdsecurity/traefik --force
|
||||
@@ -1,17 +1,23 @@
|
||||
services:
|
||||
crowdsec:
|
||||
profiles: ["core","all","crowdsec", "traefik"]
|
||||
# image: crowdsecurity/crowdsec:latest
|
||||
build: ${PROJECT_ROOT}/core/crowdsec
|
||||
image: crowdsecurity/crowdsec:latest
|
||||
# build: ${PROJECT_ROOT}/core/crowdsec
|
||||
container_name: crowdsec
|
||||
restart: always
|
||||
environment:
|
||||
- COLLECTIONS=crowdsecurity/traefik
|
||||
# - CROWDSEC_LAPI_KEY=${CROWDSEC_LAPI_KEY}
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/core/crowdsec/logs:/logs:ro
|
||||
- ${PROJECT_ROOT}/core/crowdsec/data:/var/lib/crowdsec/data
|
||||
- ${PROJECT_ROOT}/core/crowdsec/config:/etc/crowdsec
|
||||
# - ${PROJECT_ROOT}/core/crowdsec/logs:/logs:ro
|
||||
# - ${PROJECT_ROOT}/core/crowdsec/data:/var/lib/crowdsec/data
|
||||
# - ${PROJECT_ROOT}/core/crowdsec/config:/etc/crowdsec
|
||||
- ${DOCKER_VOLUMES}/crowdsec/logs:/logs:ro
|
||||
- ${DOCKER_VOLUMES}/crowdsec/data:/var/lib/crowdsec/data
|
||||
# - ${DOCKER_VOLUMES}/crowdsec/config.yaml:/etc/crowdsec/config.yaml
|
||||
# - ${DOCKER_VOLUMES}/crowdsec/config:/etc/crowdsec
|
||||
- ${PROJECT_ROOT}/core/crowdsec/acquis.d:/etc/crowdsec/acquis.d
|
||||
- ${PROJECT_ROOT}/core/crowdsec/profiles.yaml:/etc/crowdsec/profiles.yaml
|
||||
networks:
|
||||
# - reverse_proxy
|
||||
- traefik
|
||||
@@ -21,3 +27,5 @@ services:
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 15s
|
||||
labels:
|
||||
- "wud.watch=true"
|
||||
@@ -0,0 +1,29 @@
|
||||
name: default_ip_remediation
|
||||
#debug: true
|
||||
filters:
|
||||
- Alert.Remediation == true && Alert.GetScope() == "Ip"
|
||||
decisions:
|
||||
- type: ban
|
||||
duration: 4h
|
||||
#duration_expr: Sprintf('%dh', (GetDecisionsCount(Alert.GetValue()) + 1) * 4)
|
||||
# notifications:
|
||||
# - slack_default # Set the webhook in /etc/crowdsec/notifications/slack.yaml before enabling this.
|
||||
# - splunk_default # Set the splunk url and token in /etc/crowdsec/notifications/splunk.yaml before enabling this.
|
||||
# - http_default # Set the required http parameters in /etc/crowdsec/notifications/http.yaml before enabling this.
|
||||
# - email_default # Set the required email parameters in /etc/crowdsec/notifications/email.yaml before enabling this.
|
||||
on_success: break
|
||||
---
|
||||
name: default_range_remediation
|
||||
#debug: true
|
||||
filters:
|
||||
- Alert.Remediation == true && Alert.GetScope() == "Range"
|
||||
decisions:
|
||||
- type: ban
|
||||
duration: 4h
|
||||
#duration_expr: Sprintf('%dh', (GetDecisionsCount(Alert.GetValue()) + 1) * 4)
|
||||
# notifications:
|
||||
# - slack_default # Set the webhook in /etc/crowdsec/notifications/slack.yaml before enabling this.
|
||||
# - splunk_default # Set the splunk url and token in /etc/crowdsec/notifications/splunk.yaml before enabling this.
|
||||
# - http_default # Set the required http parameters in /etc/crowdsec/notifications/http.yaml before enabling this.
|
||||
# - email_default # Set the required email parameters in /etc/crowdsec/notifications/email.yaml before enabling this.
|
||||
on_success: break
|
||||
+8
-3
@@ -1,6 +1,6 @@
|
||||
services:
|
||||
docker-socket-proxy:
|
||||
profiles: ["monitoring","all","docker-socket-proxy", "core", "traefik", "prometheus", "test"]
|
||||
profiles: ["monitoring","all","docker-socket-proxy", "core", "traefik", "uptime-kuma", "beszel", "wud", "apps"]
|
||||
image: tecnativa/docker-socket-proxy:latest
|
||||
container_name: docker-socket-proxy
|
||||
hostname: docker-socket-proxy
|
||||
@@ -20,7 +20,7 @@ services:
|
||||
SYSTEM: 1
|
||||
SERVICES: 1
|
||||
SWARM: 1
|
||||
NODES: 1
|
||||
NODES: 1
|
||||
SECRETS: 1
|
||||
TASKS: 1
|
||||
VERSION: 1
|
||||
@@ -43,5 +43,10 @@ services:
|
||||
security_opt:
|
||||
- no-new-privileges:true
|
||||
networks:
|
||||
- monitor
|
||||
# - monitor
|
||||
- traefik
|
||||
- docker-socket-proxy
|
||||
ports:
|
||||
- 2375:2375
|
||||
labels:
|
||||
- "wud.watch=true"
|
||||
@@ -1,7 +1,7 @@
|
||||
services:
|
||||
error-pages:
|
||||
profiles: ["core","all","error-pages", "traefik"]
|
||||
image: tarampampam/error-pages:3
|
||||
image: tarampampam/error-pages:latest
|
||||
restart: always
|
||||
container_name: error-pages
|
||||
read_only: true
|
||||
@@ -19,9 +19,10 @@ services:
|
||||
- "traefik.http.routers.error-pages-router.entrypoints=web"
|
||||
- "traefik.http.routers.error-pages-router.middlewares=error-pages-middleware"
|
||||
# "errors" middleware settings
|
||||
- "traefik.http.middlewares.error-pages-middleware.errors.status=400-599"
|
||||
- "traefik.http.middlewares.error-pages-middleware.errors.status=400,402-502,504-599"
|
||||
- "traefik.http.middlewares.error-pages-middleware.errors.service=error-pages-service"
|
||||
- "traefik.http.middlewares.error-pages-middleware.errors.query=/{status}.html"
|
||||
# define service properties
|
||||
- "traefik.http.services.error-pages-service.loadbalancer.server.port=8080"
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "wud.watch=true"
|
||||
@@ -2,7 +2,7 @@ services:
|
||||
update-test:
|
||||
image: nginx:1.28.1
|
||||
container_name: update-test
|
||||
profiles: ["core","all","test"]
|
||||
profiles: ["test"]
|
||||
healthcheck:
|
||||
test: ["CMD", "curl", "-f", "http://localhost"] # returns 0 if Nginx is up
|
||||
interval: 5s
|
||||
@@ -11,14 +11,14 @@ services:
|
||||
start_period: 2s
|
||||
|
||||
docker-update-exporter-test:
|
||||
profiles: ["core","all","test"]
|
||||
profiles: ["test"]
|
||||
build:
|
||||
context: ${PROJECT_ROOT}/core/test
|
||||
container_name: docker-update-exporter-test
|
||||
stdin_open: true
|
||||
tty: true
|
||||
depends_on:
|
||||
- docker-socket-proxy
|
||||
# depends_on:
|
||||
# - docker-socket-proxy
|
||||
environment:
|
||||
DOCKER_HOST: tcp://docker-socket-proxy:2375
|
||||
volumes:
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
services:
|
||||
traefik:
|
||||
profiles: ["core","all","traefik"]
|
||||
image: traefik:3
|
||||
image: traefik:latest
|
||||
container_name: traefik
|
||||
restart: always
|
||||
read_only: true
|
||||
@@ -16,19 +16,24 @@ services:
|
||||
- "80:80"
|
||||
- "443:443"
|
||||
|
||||
build:
|
||||
context: ${PROJECT_ROOT}/core
|
||||
# build:
|
||||
# context: ${PROJECT_ROOT}/core
|
||||
# env_file:
|
||||
# - ${PROJECT_ROOT}/secrets/stack-secrets.env
|
||||
|
||||
volumes:
|
||||
- ${PROJECT_ROOT}/core/traefik/data/letsencrypt:/letsencrypt
|
||||
- ${PROJECT_ROOT}/core/traefik/data/logs:/logs
|
||||
# - ${PROJECT_ROOT}/core/traefik/data/letsencrypt:/letsencrypt
|
||||
# - ${PROJECT_ROOT}/core/traefik/data/logs:/logs
|
||||
- ${PROJECT_ROOT}/core/traefik/certs:/etc/traefik/certs:ro
|
||||
- ${PROJECT_ROOT}/core/traefik/dynamic.yml:/etc/traefik/dynamic.yml:ro
|
||||
- ${PROJECT_ROOT}/core/traefik/traefik.yml:/etc/traefik/traefik.yml:ro
|
||||
- ${PROJECT_ROOT}/core/traefik/data/plugins:/plugins-storage
|
||||
|
||||
# - ${PROJECT_ROOT}/core/traefik/data/plugins:/plugins-storage
|
||||
- ${DOCKER_VOLUMES}/traefik-data/letsencrypt:/letsencrypt
|
||||
- ${DOCKER_VOLUMES}/traefik-data/logs:/logs
|
||||
# - ${PROJECT_ROOT}/core/traefik/certs:/etc/traefik/certs:ro
|
||||
# - ${PROJECT_ROOT}/core/traefik/dynamic.yml:/etc/traefik/dynamic.yml:ro
|
||||
# - ${PROJECT_ROOT}/core/traefik/traefik.yml:/etc/traefik/traefik.yml:ro
|
||||
- ${DOCKER_VOLUMES}/traefik-data/plugins:/plugins-storage
|
||||
healthcheck:
|
||||
test: traefik healthcheck --ping
|
||||
|
||||
@@ -43,8 +48,10 @@ services:
|
||||
- "io.portainer.accesscontrol.public"
|
||||
- "traefik.docker.network=core_traefik"
|
||||
- "traefik.http.routers.traefik.observability.tracing=true"
|
||||
|
||||
- "wud.watch=true"
|
||||
|
||||
networks:
|
||||
# - reverse_proxy
|
||||
# - prometheus_edge
|
||||
- traefik
|
||||
- docker-socket-proxy
|
||||
@@ -32,6 +32,63 @@ http:
|
||||
# - tracing-middleware@file
|
||||
- error-pages-middleware@docker
|
||||
|
||||
serversTransports:
|
||||
insecureTransport:
|
||||
insecureSkipVerify: true
|
||||
|
||||
routers:
|
||||
pve1:
|
||||
rule: "Host(`pve1.lan.ddnsgeek.com`)"
|
||||
entryPoints:
|
||||
- websecure
|
||||
service: pve1
|
||||
middlewares:
|
||||
- authelia@docker
|
||||
tls:
|
||||
certResolver: myresolver
|
||||
options: mtls-private-admin@file
|
||||
|
||||
pbs:
|
||||
rule: "Host(`pbs.lan.ddnsgeek.com`)"
|
||||
entryPoints:
|
||||
- websecure
|
||||
service: pbs
|
||||
middlewares:
|
||||
- authelia@docker
|
||||
tls:
|
||||
certResolver: myresolver
|
||||
options: mtls-private-admin@file
|
||||
|
||||
pdm:
|
||||
rule: "Host(`pdm.lan.ddnsgeek.com`)"
|
||||
entryPoints:
|
||||
- websecure
|
||||
service: pdm
|
||||
middlewares:
|
||||
- authelia@docker
|
||||
tls:
|
||||
certResolver: myresolver
|
||||
options: mtls-private-admin@file
|
||||
|
||||
services:
|
||||
pve1:
|
||||
loadBalancer:
|
||||
serversTransport: insecureTransport
|
||||
servers:
|
||||
- url: "https://pve1.sweet.home:8006"
|
||||
|
||||
pbs:
|
||||
loadBalancer:
|
||||
serversTransport: insecureTransport
|
||||
servers:
|
||||
- url: "https://pbs.sweet.home:8007"
|
||||
|
||||
pdm:
|
||||
loadBalancer:
|
||||
serversTransport: insecureTransport
|
||||
servers:
|
||||
- url: "https://pdm.sweet.home:8443"
|
||||
|
||||
tls:
|
||||
options:
|
||||
mtls-private-admin:
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
log:
|
||||
level: INFO
|
||||
level: DEBUG
|
||||
|
||||
accessLog:
|
||||
filePath: /logs/access.log
|
||||
|
||||
+40
-9
@@ -1,26 +1,39 @@
|
||||
PROJECT_ROOT=/home/nixos/docker
|
||||
DATA_ROOT=/mnt/docker
|
||||
PROJECT_ROOT=${DATA_ROOT}/config
|
||||
DOMAIN=lan.ddnsgeek.com
|
||||
TZ=Australia/Brisbane
|
||||
EMAIL=wayne.bennett@live.com
|
||||
SECRETS_ENV_FILE=${PROJECT_ROOT}/secrets/stack-secrets.env
|
||||
|
||||
# Data locations
|
||||
|
||||
DOCKER_VOLUMES=${DATA_ROOT}/volumes
|
||||
DOCKER_DATABASES=${DATA_ROOT}/databases
|
||||
|
||||
# Core
|
||||
CROWDSEC_COLLECTIONS=crowdsecurity/traefik
|
||||
ERROR_PAGES_TEMPLATE_NAME=app-down
|
||||
|
||||
|
||||
# Gitea
|
||||
GITEA_USER_UID=1000
|
||||
GITEA_USER_GID=1000
|
||||
GITEA_DB_TYPE=sqlite3
|
||||
GITEA_ROOT_URL=https://gitea.lan.ddnsgeek.com/
|
||||
GITEA_ROOT_URL=https://gitea.${DOMAIN}/
|
||||
# Generate a token in Gitea: Site Administration → Actions → Runners
|
||||
# or Repo → Settings → Actions → Runners
|
||||
GITEA_RUNNER_REGISTRATION_TOKEN=vYDNxzMvayREkXoaAR3x3UREkxQB2PU4eORzmkZ9
|
||||
GITEA_RUNNER_NAME=docker-runner-01
|
||||
GITEA_RUNNER_LABELS=ubuntu-latest:docker://node:20-bookworm,ubuntu-22.04:docker://node:20-bookworm,linux:docker://node:20-bookworm,docker:docker://docker:cli
|
||||
|
||||
# Grafana
|
||||
GRAFANA_ROOT_URL=https://grafana.lan.ddnsgeek.com/
|
||||
GRAFANA_ROOT_URL=https://grafana.${DOMAIN}/
|
||||
|
||||
# Nextcloud
|
||||
NEXTCLOUD_DB_VERSION=11.4
|
||||
NEXTCLOUD_MYSQL_DATABASE=nextcloud
|
||||
NEXTCLOUD_MYSQL_HOST=nextcloud_db:3306
|
||||
NEXTCLOUD_TRUSTED_DOMAINS=nextcloud.lan.ddnsgeek.com
|
||||
NEXTCLOUD_TRUSTED_DOMAINS=nextcloud.${DOMAIN}
|
||||
NEXTCLOUD_OVERWRITEPROTOCOL=https
|
||||
NEXTCLOUD_OVERWRITECLIURL=https://${NEXTCLOUD_TRUSTED_DOMAINS}
|
||||
NEXTCLOUD_SMTP_HOST=smtp.gmail.com
|
||||
@@ -30,18 +43,24 @@ NEXTCLOUD_SMTP_AUTHTYPE=login
|
||||
NEXTCLOUD_REDIS_HOST=redis
|
||||
NEXTCLOUD_REDIS_HOST_PORT=6379
|
||||
NEXTCLOUD_MARIADB_AUTO_UPGRADE=1
|
||||
NEXTCLOUD_DATA=/mnt/nextcloud-data
|
||||
|
||||
# Passbolt
|
||||
PASSBOLT_MYSQL_RANDOM_ROOT_PASSWORD=true
|
||||
PASSBOLT_MYSQL_DATABASE=passbolt
|
||||
PASSBOLT_MYSQL_USER=passbolt
|
||||
PASSBOLT_APP_FULL_BASE_URL=https://passbolt.lan.ddnsgeek.com
|
||||
PASSBOLT_APP_FULL_BASE_URL=https://passbolt.${DOMAIN}
|
||||
PASSBOLT_DATASOURCES_DEFAULT_HOST=passbolt-db
|
||||
|
||||
# Gramps
|
||||
GRAMPSWEB_LOGLEVEL=INFO
|
||||
GRAMPSWEB_MEDIAPATH=/app/media
|
||||
GRAMPSWEB_TREE=main
|
||||
GRAMPSWEB_BASE_URL=https://familytree.${DOMAIN}
|
||||
GRAMPSWEB_REGISTRATION_DISABLED=true
|
||||
GRAMPSWEB_EMAIL_HOST=smtp.gmail.com
|
||||
GRAMPSWEB_EMAIL_PORT=587
|
||||
GRAMPSWEB_EMAIL_USE_SSL=false
|
||||
GRAMPSWEB_EMAIL_USE_STARTTLS=true
|
||||
GRAMPSWEB_DEFAULT_FROM_EMAIL=beatz174@gmail.com
|
||||
|
||||
# Prometheus stack
|
||||
INFLUXDB_INIT_MODE=setup
|
||||
@@ -61,7 +80,7 @@ PORTAINER_GODEBUG=netdns=cgo
|
||||
|
||||
# Node-red
|
||||
DOCKER_SOCKET_PROXY_HOST=tcp://docker-socket-proxy:2375
|
||||
DOCKER_SOCKET_PROXY_LOG_LEVEL=debug
|
||||
DOCKER_SOCKET_PROXY_LOG_LEVEL=info
|
||||
NODE_COMPOSE_ROOT=/compose
|
||||
|
||||
# mTLS bridge
|
||||
@@ -69,4 +88,16 @@ MTLS_BRIDGE_LOG_LEVEL=DEBUG
|
||||
MTLS_BRIDGE_TIMEOUT=5
|
||||
MTLS_BRIDGE_CLIENT_KEY=/certs/clients/office-pc/office-pc.key
|
||||
MTLS_BRIDGE_CLIENT_CERT=/certs/clients/office-pc/office-pc.crt
|
||||
MTLS_BRIDGE_TARGET_URL=http://node-red:1880/docker-update-lockouts/clear
|
||||
MTLS_BRIDGE_TARGET_URL=http://node-red:1880
|
||||
MTLS_BRIDGE_ALLOWED_PATHS_FILE=
|
||||
MTLS_BRIDGE_CORS_ALLOW_ORIGIN=https://grafana.${DOMAIN}
|
||||
|
||||
# Whats up Docker
|
||||
WUD_WATCHER_LOCAL_CRON="0 */6 * * *"
|
||||
WUD_WATCHER_LOCAL_HOST=docker-socket-proxy
|
||||
WUD_WATCHER_LOCAL_WATCHBYDEFAULT=false
|
||||
WUD_WATCHER_RASPI_HOST=raspberrypi.tail13f623.ts.net
|
||||
WUD_TRIGGER_GOTIFY_URL=http://gotify
|
||||
WUD_TRIGGER_GOTIFY_TOKEN=ARPi3hyrAdEUSu6
|
||||
WUD_TRIGGER_GOTIFY_PRIORITY=5
|
||||
|
||||
+2
-1
@@ -4,4 +4,5 @@ networks:
|
||||
ipam:
|
||||
config:
|
||||
- subnet: 172.21.0.0/16
|
||||
monitor:
|
||||
# monitor:
|
||||
docker-socket-proxy:
|
||||
@@ -0,0 +1,41 @@
|
||||
# Generated Documentation
|
||||
|
||||
## Local generation
|
||||
|
||||
Install prerequisites:
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y graphviz
|
||||
```
|
||||
|
||||
Then generate and validate public docs:
|
||||
|
||||
```bash
|
||||
chmod +x scripts/docs/*.sh
|
||||
scripts/docs/generate-all.sh
|
||||
python3 -m mkdocs build -f mkdocs-public.yml --strict
|
||||
```
|
||||
|
||||
NixOS-friendly alternative:
|
||||
|
||||
```bash
|
||||
nix shell nixpkgs#graphviz nixpkgs#python3 nixpkgs#python3Packages.pyyaml
|
||||
```
|
||||
|
||||
This pipeline only runs `docker compose config` and static parsing. It does **not** start containers.
|
||||
|
||||
## CI behaviour
|
||||
|
||||
GitHub Actions workflow `.github/workflows/generate-docs.yml` validates committed public docs and diagrams and runs a strict public MkDocs build.
|
||||
|
||||
## Outputs
|
||||
|
||||
- `docs/generated`: resolved compose config and markdown inventories
|
||||
- `docs/diagrams`: generated DOT and SVG diagrams
|
||||
- `docs/public`: sanitized copy for public sharing
|
||||
|
||||
## Publication safety
|
||||
|
||||
- `docs/public` is intended for public sharing after sanitization.
|
||||
- `docs/generated` and `docs/diagrams` may include internal details and should be treated as internal by default.
|
||||
@@ -0,0 +1,72 @@
|
||||
# Ansible Workflows (Bootstrap / Phase 1)
|
||||
|
||||
Ansible is being introduced as a minimal, maintainable foundation for host/device inventory and future configuration workflows.
|
||||
|
||||
## Why introduce Ansible now
|
||||
|
||||
- The repository already has strong runtime and infrastructure boundaries (Compose + Terraform).
|
||||
- A small Ansible baseline allows gradual host onboarding without forcing immediate large-scale automation.
|
||||
- It enables safe validation workflows (`inventory --list`, playbook syntax checks) before real execution.
|
||||
|
||||
## What Ansible is for in this repository (right now)
|
||||
|
||||
- YAML inventory structure for hosts/devices to be onboarded over time.
|
||||
- Group and host variable scaffolding for future incremental adoption.
|
||||
- Validation-oriented starter playbook and local tooling checks.
|
||||
|
||||
## What Ansible is not for yet
|
||||
|
||||
- Replacing Docker Compose runtime authority.
|
||||
- Replacing Terraform inventory/reconciliation authority.
|
||||
- Becoming the current source of truth for NixOS host management.
|
||||
- Becoming the current source of truth for all network automation.
|
||||
|
||||
## Directory layout
|
||||
|
||||
- `infrastructure/ansible/ansible.cfg`
|
||||
- `infrastructure/ansible/inventory/hosts.yml`
|
||||
- `infrastructure/ansible/inventory/group_vars/`
|
||||
- `infrastructure/ansible/inventory/host_vars/`
|
||||
- `infrastructure/ansible/playbooks/ping.yml`
|
||||
- `infrastructure/ansible/collections/requirements.yml`
|
||||
|
||||
## Add a host (gradual onboarding)
|
||||
|
||||
1. Open `infrastructure/ansible/inventory/hosts.yml`.
|
||||
2. Add the host under an appropriate group (`linux`, `network`, `virtualization`, or `nixos`).
|
||||
3. Add non-sensitive defaults under group vars only when shared across hosts.
|
||||
4. Add host-specific values in `inventory/host_vars/<hostname>.yml`.
|
||||
5. Keep secrets out of committed files.
|
||||
|
||||
Example pattern:
|
||||
|
||||
```yaml
|
||||
linux:
|
||||
hosts:
|
||||
my-host:
|
||||
ansible_host: my-host.local
|
||||
```
|
||||
|
||||
## Validation commands
|
||||
|
||||
Run from repository root:
|
||||
|
||||
```bash
|
||||
ansible --version
|
||||
ansible-lint --version
|
||||
ansible-inventory -i infrastructure/ansible/inventory/hosts.yml --list
|
||||
ansible-playbook -i infrastructure/ansible/inventory/hosts.yml infrastructure/ansible/playbooks/ping.yml --syntax-check
|
||||
```
|
||||
|
||||
Install/update baseline collections:
|
||||
|
||||
```bash
|
||||
ansible-galaxy collection install -r infrastructure/ansible/collections/requirements.yml -p infrastructure/ansible/collections
|
||||
```
|
||||
|
||||
## Guardrails for future expansion
|
||||
|
||||
- Keep changes incremental (one host/group/playbook change at a time).
|
||||
- Prefer simple playbooks before introducing roles.
|
||||
- Add network-platform/NixOS-specific logic only when those boundaries are explicitly adopted.
|
||||
- Keep documentation aligned with source-of-truth boundaries when Ansible authority evolves.
|
||||
Loaded 100 of 308 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user