Joseph Doherty
6d87ee3c3b
One file per local Docker cluster (docker-cluster, docker-cluster-env2) keyed by Transport.SourceEnvironment. README indexes the set.
119 lines
5.2 KiB
Markdown
119 lines
5.2 KiB
Markdown
# docker-cluster-env2
|
|
|
|
Secondary local Docker deployment — a minimal ScadaLink topology that runs **concurrently with** [`docker-cluster`](docker-cluster.md) so the Transport (#24) feature can be exercised end-to-end across two real environments (export a bundle from one, import into the other).
|
|
|
|
- **Deployment ID:** `docker-cluster-env2`
|
|
- **Transport.SourceEnvironment:** `docker-cluster-env2`
|
|
- **Source directory:** [`docker-env2/`](../docker-env2/)
|
|
- **Container-name prefix:** `scadalink-env2-`
|
|
- **Host-port range:** `91XX` (primary `90XX` + 100)
|
|
|
|
## Topology
|
|
|
|
```
|
|
┌───────────────────┐
|
|
│ Traefik LB :9100 │ ◄── CLI / Browser
|
|
│ Dashboard :8181 │
|
|
└────────┬──────────┘
|
|
│ routes to active node
|
|
┌──────────────────────┼──────────────────────────────┐
|
|
│ Env2 Central Cluster │
|
|
│ env2-central-a (UI :9101, Akka :9111) │
|
|
│ env2-central-b (UI :9102, Akka :9112) │
|
|
└───────────┬─────────────────────────────────────────┘
|
|
│ Akka.NET remoting + gRPC streaming
|
|
▼
|
|
Env2 Site-X (Env2 Site X)
|
|
Akka 9121/9122
|
|
gRPC 9123/9124
|
|
```
|
|
|
|
Same active/standby pattern as the primary, scaled down to a single site cluster to keep the footprint small. Built specifically for cross-environment Transport testing — not a general-purpose dev environment.
|
|
|
|
## Nodes
|
|
|
|
| Node | Container Name | Host Web | Host Akka | Host gRPC |
|
|
|------|----------------|----------|-----------|-----------|
|
|
| Traefik LB | `scadalink-env2-traefik` | 9100 | — | — |
|
|
| Central A | `scadalink-env2-central-a` | 9101 | 9111 | — |
|
|
| Central B | `scadalink-env2-central-b` | 9102 | 9112 | — |
|
|
| Site-X A | `scadalink-env2-site-x-a` | — | 9121 | 9123 |
|
|
| Site-X B | `scadalink-env2-site-x-b` | — | 9122 | 9124 |
|
|
|
|
## Sites
|
|
|
|
| Site Identifier | Central UI Name |
|
|
|-----------------|-----------------|
|
|
| `site-x` | Env2 Site X |
|
|
|
|
## Infrastructure Dependencies
|
|
|
|
Env2 reuses the primary's `infra/` containers via the shared `scadalink-net` bridge network — there is no separate `infra/` stack to start.
|
|
|
|
| Service | Shared Container | What env2 uses it for |
|
|
|---------|------------------|-----------------------|
|
|
| MS SQL | `scadalink-mssql` | Env2 databases `ScadaLinkConfig2` / `ScadaLinkMachineData2` (separate DBs on the same instance) |
|
|
| LDAP | `scadalink-ldap` | Authentication (same test users) |
|
|
| SMTP | `scadalink-smtp` | Notification capture (env2 emails distinguishable by `FromAddress`) |
|
|
| OPC UA | `scadalink-opcua` | Simulated tags for `site-x` data connections |
|
|
| REST API | `scadalink-restapi` | External REST integration testing |
|
|
|
|
## Databases
|
|
|
|
| Database | Owner |
|
|
|----------|-------|
|
|
| `ScadaLinkConfig2` | Configuration Database (#17) — env2 instance |
|
|
| `ScadaLinkMachineData2` | Machine data — env2 instance |
|
|
|
|
Created by `docker-env2/init-db.sh`, which `deploy.sh` runs automatically.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
# Primary infra must already be up (creates scadalink-net + MS SQL + LDAP + SMTP + OPC UA + REST)
|
|
cd infra && docker compose up -d && cd ..
|
|
|
|
# Build image (shared with primary), create env2 DBs, deploy env2 containers
|
|
bash docker-env2/deploy.sh
|
|
|
|
# First-time only: seed the env2 test site
|
|
bash docker-env2/seed-sites.sh
|
|
|
|
# View logs
|
|
docker compose -f docker-env2/docker-compose.yml logs -f
|
|
docker logs -f scadalink-env2-central-a
|
|
|
|
# Stop env2 (preserves SQLite + logs)
|
|
bash docker-env2/teardown.sh
|
|
|
|
# Also drop env2 databases
|
|
docker exec scadalink-mssql /opt/mssql-tools18/bin/sqlcmd \
|
|
-S localhost -U sa -P 'ScadaLink_Dev1#' -C \
|
|
-Q "DROP DATABASE ScadaLinkConfig2; DROP DATABASE ScadaLinkMachineData2;"
|
|
```
|
|
|
|
## CLI Access
|
|
|
|
```bash
|
|
dotnet run --project src/ScadaLink.CLI -- \
|
|
--url http://localhost:9100 \
|
|
--username multi-role --password password \
|
|
template list
|
|
```
|
|
|
|
## What's Different from `docker-cluster`
|
|
|
|
- Single site (`site-x`) instead of three (`site-a`/`site-b`/`site-c`).
|
|
- Host port range `91XX` instead of `90XX`.
|
|
- Container names prefixed `scadalink-env2-` instead of `scadalink-`.
|
|
- Databases `ScadaLinkConfig2` / `ScadaLinkMachineData2` on the **shared** `scadalink-mssql`.
|
|
- `Transport.SourceEnvironment = "docker-cluster-env2"` stamped into exported bundle manifests.
|
|
- Distinct `Security.JwtSigningKey` so sessions cannot cross environments.
|
|
|
|
## Notes
|
|
|
|
- Concurrent with [`docker-cluster`](docker-cluster.md) — both stacks share `scadalink-net` and the `infra/` services. Disjoint host ports + DB names + container names allow them to run side-by-side.
|
|
- Design rationale: [`docs/plans/2026-05-24-second-environment-design.md`](../docs/plans/2026-05-24-second-environment-design.md).
|
|
- Transport golden-path verification: [`docs/plans/2026-05-24-second-environment-verification.md`](../docs/plans/2026-05-24-second-environment-verification.md).
|
|
- Setup details, port table, and CLI examples in [`docker-env2/README.md`](../docker-env2/README.md).
|