# 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)

```bash
./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)

```bash
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

```bash
# 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

```bash
# 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:

```bash
# 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.