sicabe-control-panel/deploy/stack/README.md

Deploy: stack sicabe-host (tanpa build)

Satu compose untuk satu host SiCABE, memuat empat service:

Service	Image	Profile	Di host mana
docker-socket-proxy	tecnativa/docker-socket-proxy	–	semua host
config-agent	<registry>/config-agent	–	semua host
gateway (nginx)	nginx:alpine	–	semua host
sicabe-control-panel	<registry>/control-panel	panel	satu host (panel)

Compose di sini tidak membangun image — semua diambil dari registry. Untuk build & push image ke registry privat, pakai deploy/panel/ + scripts/build-image.sh.

1. Build & push image (sekali, dari mesin dev)

./scripts/build-image.sh --all --push --registry registry.example.com/sicabe
# → registry.example.com/sicabe/control-panel:<git-sha> + :latest
# → registry.example.com/sicabe/config-agent:<git-sha> + :latest

--all membangun panel + config-agent dengan tag yang sama (agar satu SICABE_TAG cukup di stack). Login registry dulu bila perlu: docker login <registry>.

2. Siapkan env (per host)

cd deploy/stack
cp env.example .env       # isi GATEWAY_API_KEY, SICABE_REGISTRY, SICABE_DEPLOY_DIR

Di host panel, isi juga bagian bawah (PANEL_URL, NEXTAUTH_SECRET, KEYCLOAK_CLIENT_SECRET, SICABE_HOSTS, dst).

3. Jalankan

# SEMUA host SiCABE (docker-proxy + config-agent + gateway):
docker compose up -d

# HANYA di host panel — sekaligus menjalankan panelnya:
docker compose --profile panel up -d

Cek: docker compose ps dan docker compose logs -f gateway.

Update image

# setelah build+push tag baru:
SICABE_TAG=<tag-baru> docker compose pull        # (di host panel: + --profile panel)
docker compose up -d        # recreate

Menghentikan / menghapus

docker compose down hanya menghapus service pada profile yang aktif. Karena itu, di host panel jalankan dengan profile yang sama:

# host panel:
docker compose --profile panel down      # hapus SEMUA (termasuk panel)

# host non-panel:
docker compose down

Kalau down dijalankan tanpa --profile panel di host panel, container sicabe-control-panel akan tertinggal sebagai orphan. Compose akan memperingatkan; hapus dengan --profile panel down atau docker rm -f.

Catatan

• Panel memakai network_mode: host karena gateway bind 127.0.0.1 (tak terjangkau dari bridge Docker; sekaligus SAN sertifikat Trino localhost cocok). Port panel = PANEL_PORT (default 3000).
• Template nginx dipakai bersama dari ../host-gateway/nginx/ (tanpa duplikasi). Setelah mengubah template, jalankan docker compose restart gateway (nginx men-substitute template saat start).
• Menambah host baru: jalankan docker compose up -d (tanpa profile) di host itu, lalu daftarkan di panel (Settings → Hosts & Agents) dan Scan.
• Compose ini menggantikan deploy/host-gateway/ + deploy/panel/ sebagai artefak deploy. Keduanya tetap ada untuk build lokal/dev.