Task containers log in with their run credential on an external broker and reach only their own subjects, decided by the embedded broker's authenticator. The broker token is never put in a container environment.
125 lines
5.4 KiB
YAML
125 lines
5.4 KiB
YAML
# PostgreSQL for the State Store, optional external NATS, and the agent images
|
|
# the daemon spawns per task.
|
|
#
|
|
# archied itself runs on the host under systemd, not here -- its chat tools
|
|
# operate on host files, which a container cannot reach. See
|
|
# deployments/systemd-user-service.md.
|
|
#
|
|
# Embedded NATS is the normal deployment and needs no Compose service.
|
|
# State Store DB: docker compose up -d postgres
|
|
# External broker: docker compose up -d nats
|
|
# Build worker: task image:agent (stamps this checkout's version)
|
|
# Profile image: docker compose build agent-net
|
|
# Stop external: docker compose down
|
|
# Logs: journalctl --user -u archied -f (the daemon)
|
|
# docker compose logs -f nats (the bus)
|
|
|
|
services:
|
|
# ── PostgreSQL (State Store) ───────────────────────────────────
|
|
# The standalone archie-state-store process's database. PostgreSQL 18 is
|
|
# the required minimum and target; `postgres.Open` refuses anything older.
|
|
# `task dev` brings this up before the State Store via dev:postgres. The
|
|
# This superuser is the dev database's admin: `task dev` runs archie-state-store
|
|
# provision after first start to create the least-privilege roles the
|
|
# mirroring deployments/dev.toml URLs name -- change them together.
|
|
postgres:
|
|
image: postgres:18
|
|
environment:
|
|
POSTGRES_USER: archie
|
|
POSTGRES_PASSWORD: archie
|
|
POSTGRES_DB: archie
|
|
# postgres:18 moved its default PGDATA under a versioned path; pin the
|
|
# classic location so the named volume keeps working across image updates.
|
|
PGDATA: /var/lib/postgresql/data/pgdata
|
|
ports:
|
|
- "127.0.0.1:5432:5432"
|
|
volumes:
|
|
- pg_data:/var/lib/postgresql/data
|
|
restart: unless-stopped
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "pg_isready -U archie -d archie"]
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
# ── NATS JetStream ────────────────────────────────────────────────
|
|
nats:
|
|
image: nats:2.14-alpine3.22
|
|
# The client port is published on every interface (agent containers reach
|
|
# it over the bridge), so it defers every login to archied. Set NATS_TOKEN
|
|
# (name it in [nats] token_env) and NATS_CALLOUT_ISSUER, the public key of
|
|
# the account nkey seed named in [nats] callout_issuer_seed_env.
|
|
command: ["-c", "/etc/nats/nats.conf"]
|
|
environment:
|
|
NATS_TOKEN: ${NATS_TOKEN:?NATS_TOKEN is required}
|
|
NATS_CALLOUT_ISSUER: ${NATS_CALLOUT_ISSUER:?NATS_CALLOUT_ISSUER is required}
|
|
ports:
|
|
- "4222:4222" # client
|
|
- "127.0.0.1:8222:8222" # monitoring (http://localhost:8222)
|
|
volumes:
|
|
- nats_data:/data
|
|
- ./deployments/nats-callout.conf:/etc/nats/nats.conf:ro
|
|
restart: unless-stopped
|
|
healthcheck:
|
|
test: ["CMD", "wget", "-q", "-O", "-", "http://localhost:8222/healthz"]
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
# ── agent image (built once, spawned per task by the daemon) ───────
|
|
# Not a long-running service: the daemon starts agent containers itself
|
|
# via the Docker socket. This stanza exists only so the image can be
|
|
# built locally.
|
|
#
|
|
# The build profile keeps `up -d` from starting it. Without it compose
|
|
# creates a container that exits 0 immediately and still reports
|
|
# "Started", which reads like a crash loop. Naming the service explicitly
|
|
# still works without activating the profile:
|
|
#
|
|
# docker compose build agent
|
|
# docker compose pull agent -- plain `pull` skips profiled services
|
|
#
|
|
# Routine freshness is handled by the daemon, which pulls this image per
|
|
# task: see containers.pull_policy in the config. Watchtower cannot do it
|
|
# -- it only restarts long-running containers, and this is not one.
|
|
agent:
|
|
profiles: ["build"]
|
|
build:
|
|
context: .
|
|
dockerfile: Dockerfile
|
|
# Stamped into the agent so the version it reports is the one the rest of
|
|
# the install reports. `task image:agent` passes this checkout's version;
|
|
# a bare `docker build` passes nothing and the agent answers dev.
|
|
args:
|
|
RUNTIME_VERSION: ${RUNTIME_VERSION:-dev}
|
|
# A tag, not the digest: Compose refuses to build an image it is told to
|
|
# name by digest. The digest a task container actually runs is pinned in
|
|
# the daemon's own [containers] image, so nothing here decides it. See
|
|
# deployments/systemd-user-service.md#6-pinning-the-archie-agent-image.
|
|
image: git.catlow.cloud/sam/archie-agent:latest
|
|
|
|
# ── example agent profile image ─────────────────────────────────────
|
|
# The agent image plus network lookup tools, for a workflow that names
|
|
# `profile: network-investigator` (archipelago: workflows/firewall).
|
|
# Build-only for the same reason as agent. It is local, so leave
|
|
# containers.pull_policy at "missing": "always" would try to pull it.
|
|
agent-net:
|
|
profiles: ["build"]
|
|
build:
|
|
context: examples/profiles
|
|
dockerfile: Dockerfile.agent-net
|
|
image: archie-agent-net:local
|
|
|
|
volumes:
|
|
nats_data:
|
|
pg_data:
|
|
|
|
# The subnet is pinned for the optional external-broker profile because its
|
|
# configured URL must be reachable from both the native daemon and workers.
|
|
# Embedded mode discovers its selected bridge gateway at startup instead.
|
|
networks:
|
|
default:
|
|
ipam:
|
|
config:
|
|
- subnet: 172.19.0.0/16
|