feat: initial commit

2026-05-19 14:53:37 +02:00
commit ea7e728222
34 changed files with 680 additions and 0 deletions
@@ -0,0 +1,68 @@
+# Codex Context: Terraform VM + Docker Compose Test (Single Node)
+
+## Goal
+Test a single-node Docker Compose deployment on a Terraform-provisioned VM (no k3s), using the same layout as swarm. Ensure backend + FE + proxies come up and healthcheck works. This is a throwaway, clean environment.
+
+## Current State
+- VM created via Terraform: `terraform-testvm-1` on Proxmox node `rbmk2`.
+- IP: `10.1.50.125/24`, gateway `10.1.50.1`.
+- SSH: `ssh devops@10.1.50.125 -p42315` (company policy non-22).
+- Docker installed via `get.docker.com` on the VM.
+- Compose location on VM: `/webapps/wolkabout`.
+- Volume/config location on VM: `/mnt/docker-volumes/wolkabout`.
+- HAProxy fixed by ensuring `options.http` ends with a blank line.
+
+## Files on laptop
+- New compose file with MySQL + Cassandra: `/home/nikola/codex-cli/docker-compose.with-dbs.yml` (version 2.4).
+- This file was copied to the VM as `/webapps/wolkabout/docker-compose.yml`.
+
+## Compose contents (high level)
+- Services: `mysql8`, `cassandra`, `cloud-config`, `rabbitmq`, `mosquitto`, `backend`, `frontend`, `frontend-federated`, `http2amqp`, `mqtt2amqp`, `loki`, `haproxy`.
+- Ordered startup using `depends_on` + healthchecks (DBs first, then base infra, then app/FE).
+- Network name: `core-net` (kept same name).
+- MySQL image: `mysql:8.0.32-debian` with:
+  - root password `password`
+  - DB `swarm`, user `wolk`, password `Test1234`
+  - volumes: `/mnt/docker-volumes/wolkabout/mysql8`, init folder `/mnt/docker-volumes/wolkabout/mysql8-init`, config `/mnt/docker-volumes/wolkabout/config/mysql-custom.cnf`
+- Cassandra image: `cassandra:4.1.2`, volume `/mnt/docker-volumes/wolkabout/cassandra`, heap env.
+
+## Config changes still needed on VM
+Update these to point to local DBs/containers:
+- `/mnt/docker-volumes/wolkabout/config/wolk-commons.yml`
+  - `spring.datasource.url` -> `jdbc:mysql://mysql8:3306/swarm?...`
+  - `spring.datasource.username` -> `wolk`
+  - `spring.datasource.password` -> `Test1234`
+  - `spring.cassandra.contact-points` -> `cassandra`
+- `/mnt/docker-volumes/wolkabout/config/mosquitto.conf`
+  - `auth_opt_host mysql8`
+  - `auth_opt_dbname swarm`
+  - `auth_opt_user wolk`
+  - `auth_opt_pass Test1234`
+
+## MySQL/Cassandra init
+No dump yet. We want a clean environment. Create minimal init:
+- MySQL init dir: `/mnt/docker-volumes/wolkabout/mysql8-init/init.sql`
+  - For now can just `CREATE DATABASE IF NOT EXISTS swarm;`.
+- Cassandra keyspace: `swarm` (from `wolk-commons.yml`).
+
+Recommended scripts on VM (create in `/webapps/wolkabout`):
+- `init-mysql.sh` waits for mysql, applies init.sql if present.
+- `init-cassandra.sh` waits for cassandra, creates keyspace `swarm`.
+
+## Docker registry login
+ECR images require login on the VM. On swarm1 there is `~/.aws/credentials` and `~/.aws/config` (region `eu-west-1`). Use those creds (copy from swarm1 or your internal source) and run:
+- `aws ecr get-login-password --region eu-west-1 | docker login --username AWS --password-stdin 629307322585.dkr.ecr.eu-west-1.amazonaws.com`
+
+## Known runtime issue
+- `mosquitto` fails if MySQL schema/tables do not exist (`MosquittoUser`, `MosquittoTopic`). Backend may not auto-create them. If needed, we must add minimal SQL schema later.
+
+## Healthcheck target
+Backend is considered ready when:
+- `https://<domain>.wolkabout.com/api/infos/server` returns JSON.
+
+## Next Actions (expected)
+1. Create `/mnt/docker-volumes/wolkabout/config/mysql-custom.cnf` (utf8mb4 + mysql_native_password + max_connections + bind-address).
+2. Update `wolk-commons.yml` + `mosquitto.conf` to local DB hostnames.
+3. Create init scripts + minimal init.sql.
+4. `docker compose down` then `up -d`.
+5. Run init scripts and validate with `docker compose ps`.