124 lines
5.2 KiB
YAML
124 lines
5.2 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
|
|
# credentials and database name below are the dev default mirrored by
|
|
# deployments/dev.toml's database_url -- change both 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 refuses to start without a token. Set
|
|
# NATS_TOKEN here and name the same value in [nats] token_env.
|
|
entrypoint:
|
|
- sh
|
|
- -c
|
|
- '[ -n "$$NATS_TOKEN" ] || { echo "NATS_TOKEN is required" >&2; exit 1; }; exec nats-server -js -m 8222 --auth "$$NATS_TOKEN"'
|
|
environment:
|
|
NATS_TOKEN: ${NATS_TOKEN:-}
|
|
ports:
|
|
- "4222:4222" # client
|
|
- "127.0.0.1:8222:8222" # monitoring (http://localhost:8222)
|
|
volumes:
|
|
- nats_data:/data
|
|
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
|