alexei.dolgolyov
7733e64b08
A dockerfile or static workload can opt in to reading its deploy config from a
.tinyforge.yml in its own repo. Tinyforge fetches the file, shows field-level
drift vs the live config, and an admin applies it with an explicit Sync. The
repo becomes the source of truth for the declared fields. Manual-sync only;
no auto-apply on deploy, no multi-workload reconcile, no create/delete in v1.
Scope is deliberately source-aware and source_config-resident: dockerfile
declares port/healthcheck/deploy_strategy, static declares deploy_strategy.
The file never carries repo coords or secrets (those stay in the encrypted
DB), which keeps credentials out of the repo.
Backend:
- internal/gitops: Spec/ParseSpec (KnownFields rejects unknown keys), a
source-aware ApplyPlan/BuildPlan, MergeAndValidate (omitted-field-preserving
deep merge + validate-the-merged-result-then-commit — never a partial
config), declared-only Drift with normalization, and Fetch with
ok/no_file/fetch_failed/invalid statuses and token-redacted messages.
- staticsite: DownloadFile added to GitProvider + Gitea/GitHub/GitLab impls,
reusing each provider's SSRF-safe client; 64 KiB cap; ErrFileNotFound.
- store: 4 additive gitops_* columns + setters (disjoint from UpdateWorkload
so the edit-form save and a sync never clobber each other).
- api: GET /workloads/{id}/gitops (status + raw + live drift + managed_fields),
PUT /gitops (admin, enable/path, traversal-safe), POST /gitops/sync (admin,
per-workload locked read->merge->validate->write, audited to event_log).
Frontend:
- GitOpsPanel.svelte: status pill, a purpose-built field-level drift view,
.tinyforge.yml preview, enable ToggleSwitch, Sync via ConfirmDialog; all five
statuses handled, admin affordances gated on the real viewer role.
- GitOps-managed badge (list + detail hero) and a read-only edit-form banner.
- api.ts fetchers + types; i18n apps.detail.gitops.* (en + ru parity).
Built phase-by-phase with an adversarial plan review (caught 5 design flaws
pre-implementation) and an independent review per phase (go / security / ts /
final) — all APPROVE, 0 CRITICAL/HIGH. docs/gitops.md documents the schema and
what's intentionally out of v1. Plan: plans/gitops/.
58 lines
2.3 KiB
YAML
58 lines
2.3 KiB
YAML
services:
|
|
tinyforge:
|
|
# Default: build from source so a fresh clone works out of the box.
|
|
build: .
|
|
# Image name doubles as the Gitea registry tag. To DEPLOY the pre-built
|
|
# image instead of building (e.g. Portainer pulling on a webhook), comment
|
|
# out `build:` above — compose will then pull this tag. `:latest` is pushed
|
|
# only for stable (non pre-release) releases, and the registry may require
|
|
# `docker login git.dolgolyov-family.by` first if the package is private.
|
|
image: git.dolgolyov-family.by/alexei.dolgolyov/tiny-forge:latest
|
|
container_name: tinyforge
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8080:8080"
|
|
volumes:
|
|
# Mount Docker socket for container management.
|
|
- /var/run/docker.sock:/var/run/docker.sock
|
|
# Persistent data (SQLite database).
|
|
- tinyforge-data:/app/data
|
|
# Optional seed config (read on first launch only).
|
|
- ./tinyforge.yaml:/app/tinyforge.yaml:ro
|
|
environment:
|
|
# Required: protects all credentials stored in the database.
|
|
- ENCRYPTION_KEY=${ENCRYPTION_KEY:?Set ENCRYPTION_KEY in .env}
|
|
# Required on first launch: password for the default admin user.
|
|
- ADMIN_PASSWORD=${ADMIN_PASSWORD:?Set ADMIN_PASSWORD in .env}
|
|
# Optional: override seed file location.
|
|
- SEED_FILE=/app/tinyforge.yaml
|
|
# Optional: override data directory.
|
|
- DATA_DIR=/app/data
|
|
# Optional: override listen address.
|
|
- LISTEN_ADDR=:8080
|
|
# Optional: override NPM URL (otherwise uses value from settings).
|
|
# - NPM_URL=http://npm:81
|
|
# Optional: override polling interval.
|
|
# - POLLING_INTERVAL=5m
|
|
networks:
|
|
- staging-net
|
|
healthcheck:
|
|
# /readyz is the public readiness probe (pings the DB, rate-limited).
|
|
# The previous target (/api/auth/login) is POST-only, so a GET/spider
|
|
# request returned 405 and the container was always reported unhealthy.
|
|
test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/readyz"]
|
|
interval: 30s
|
|
timeout: 5s
|
|
retries: 3
|
|
start_period: 10s
|
|
|
|
volumes:
|
|
tinyforge-data:
|
|
driver: local
|
|
|
|
# NOTE: The staging-net network must exist before starting.
|
|
# Create it with: docker network create staging-net
|
|
networks:
|
|
staging-net:
|
|
external: true
|