Host dockerowy (docker-node): od zera do działającego środowiska¶
Stan na 2026-09-25 (branch DEV-2450). Diagramy opisują to, co jest w repozytorium dziś - kroki ręczne i brakujące elementy są oznaczone osobno.
Host dockerowy to dwie warstwy.
Każdy dostaje silnik Dockera przez tag docker.
Stos apollo-docker i wszystko, czego potrzebuje TeamCity, dochodzi tylko na hostach z tagiem apollo-docker.
Ten tag daje apollo_docker = true w test.tfvars, domyślne w środowisku test.
Hosty dockerowe należą do środowiska test w projekcie Scaleway apollo-test, w WAW 2.
To środowiska zespołów testerskich, np. wombaty, oposy i kapibary, oraz stagingi klienckie.
Mirror produkcji to qa na hostach Tomcata - patrz Host Tomcata.
Diagramy pokazują host z obiema warstwami.
Legenda (obramowanie węzła): 🟩 zautomatyzowane w repo · 🟨 krok ręczny (przerywane) · 🟥 brakuje - TODO (kropkowane) · 🟦 zasób w chmurze / na hoście
Topologia¶
Kto jest właścicielem której warstwy i czym się ze sobą łączą.
flowchart TB
subgraph REPO["logintegra-ansible"]
direction TB
TFVARS["terraform/environments/test/test.tfvars<br/>docker_nodes (apollo_docker = true)<br/>inbound_rules.docker, .apollo_docker"]
TFMOD["modules/archetypes/docker-node<br/>-> modules/instance<br/>modules/security-group"]
KEY["ansible/playbooks/ansible_key.pub"]
INV["ansible/inventory/test_scw.yml<br/>keyed_groups: tag_*"]
GV["inventory/group_vars/<br/>all.yml · tag_apollo_docker.yml"]
SITE["playbooks/state/site.yml<br/>base.yml · docker-nodes.yml<br/>apollo-docker-nodes.yml"]
ROLES["roles/<br/>users · docker_host · apollo_docker<br/>(+ teamcity_access)"]
end
subgraph SCW["Scaleway - projekt apollo-test, pl-waw-2"]
direction TB
SG["security group test-apollo-docker-sg<br/>VPN: 22 · 80 · 443 · 8080-8087<br/>agent TC: 666 · 8080-8087<br/>(zwykły host: test-docker-sg, 22 z VPN)"]
IP["flexible IP"]
SRV["test-apollo-wombaty-docker-01<br/>GP1-XS · ubuntu_noble · 80 GB sbs<br/>tagi: test, docker, apollo-docker,<br/>wombaty, managed-by-terraform, stoppable"]
STATE[("Object Storage<br/>test/terraform.tfstate")]
end
subgraph HOST["test-apollo-wombaty-docker-01 - wnętrze"]
direction TB
subgraph L_BASE["każdy host dockerowy - tag docker"]
U_ANS["konto ansible<br/>(cloud-init)"]
U_PPL["konta ludzi<br/>(rola users)"]
DOCKER["Docker CE + compose v2 + buildx<br/>daemon.json · cron.daily prune<br/>(rola docker_host)"]
end
subgraph L_APOLLO["tylko tag apollo-docker - rola apollo_docker"]
U_TC["konto teamcity (grupa docker)<br/>sshd :22 + :666<br/>(zależność teamcity_access)"]
AD["/home/teamcity/projects/apollo-docker"]
STACK["kontenery: apollo-backend, frontend, nginx,<br/>db, redis, rabbitmq, mikroserwisy..."]
end
end
subgraph TC["TeamCity"]
direction TB
TCLIST["AppName.kt + ServerConstants.kt<br/>zaszyta lista hostów"]
TCBUILD["Wystaw środowisko<br/>(RebuildTemplate)"]
end
BB[("Bitbucket<br/>apollo-docker + repozytoria aplikacji")]
TFVARS --> TFMOD
KEY --> TFMOD
TFMOD -- "terraform apply" --> SG & IP & SRV
TFMOD -. state .-> STATE
SG --- SRV
IP --- SRV
SRV -- "tagi -> grupy tag_test, tag_docker,<br/>tag_apollo_docker, tag_wombaty" --> INV
INV --> SITE
GV --> SITE
ROLES --> SITE
SITE -- "ssh ansible@:22" --> U_ANS
U_ANS --> U_PPL & DOCKER & U_TC
U_TC --> AD
BB -- "git clone (klucz Bitbucket)" --> AD
TCLIST --> TCBUILD
TCBUILD -- "ssh teamcity@:666<br/>git switch · apollo-docker.sh setup" --> AD
AD --> STACK
DOCKER --> STACK
%% Tylko obramowania - wypełnienie i tekst zostają z motywu, więc diagram
%% jest czytelny w trybie jasnym i ciemnym.
classDef auto stroke:#2e7d32,stroke-width:3px
classDef manual stroke:#d4a017,stroke-width:3px,stroke-dasharray:6 3
classDef missing stroke:#c62828,stroke-width:3px,stroke-dasharray:3 3
classDef cloud stroke:#1e88e5,stroke-width:3px
class TFVARS,TFMOD,KEY,INV,GV,SITE,ROLES auto
class SG,IP,SRV,U_ANS,U_PPL,DOCKER,U_TC,AD,STACK cloud
class TCLIST,TCBUILD manual
class STATE missing
Przepływ: od zera do instancji¶
Kolejność kroków i kto je wykonuje.
sequenceDiagram
autonumber
actor Admin as Administrator
actor Rev as Druga osoba
participant Repo as logintegra-ansible
participant TF as Terraform
participant SCW as Scaleway API
participant Host as test-apollo-wombaty-docker-01
participant Ans as Ansible
participant BB as Bitbucket
participant TC as TeamCity
Note over Admin,SCW: Jednorazowo (brakuje): klucze TeamCity<br/>i klucz Bitbucket w ansible-vault
Admin->>Repo: wpis w test.tfvars -> docker_nodes (PR, branch DEV-XXXX)
Admin->>TF: terraform init
Admin->>TF: terraform plan -var-file=test.tfvars
TF->>TF: walidacja nazwy test-apollo-[odbiorca-]docker-NN<br/>i schedule_tags
TF-->>Rev: plan: 4 to add (2x sg, ip, server)
Rev-->>Admin: akceptacja
Admin->>TF: terraform apply
TF->>SCW: security groups test-docker-sg i test-apollo-docker-sg<br/>+ flexible IP + serwer z tagami (sg wg apollo_docker)
SCW->>Host: pierwszy start, cloud-init
Host->>Host: konto ansible + klucz ansible_key.pub, sudo NOPASSWD
Admin->>Ans: ansible-playbook -i inventory/test_scw.yml -u ansible playbooks/state/site.yml
Ans->>SCW: dynamiczne inventory: instancje z tagiem test
SCW-->>Ans: host w grupach tag_test, tag_docker,<br/>tag_apollo_docker, tag_wombaty, tag_stoppable
Ans->>Host: base.yml -> rola users (konta z group_vars/all.yml)
Ans->>Host: docker-nodes.yml (tag_docker) -> rola docker_host<br/>(repo Dockera, docker-ce, compose, buildx, daemon.json, prune)
Note over Ans,Host: Zwykły host dockerowy kończy tutaj
Ans->>Host: apollo-docker-nodes.yml (tag_apollo_docker)<br/>sprawdzenie: host ma też tag docker
Ans->>Host: rola apollo_docker<br/>(konto teamcity, sshd :22+:666, known_hosts)
alt apollo_docker_deploy_key ustawiony
Host->>BB: git clone apollo-docker -> /home/teamcity/projects
else brak klucza
Ans-->>Admin: pomijam klonowanie (debug)
end
Admin->>TC: dopisanie hosta w AppName.kt + ServerConstants.kt (PR)
Note over TC: Krok ręczny - lista hostów jest zaszyta w konfiguracji TeamCity
TC->>Host: ssh teamcity@:666 - git fetch, git switch gałąź, git pull
TC->>Host: apollo-docker.sh setup
Host->>BB: klonowanie repozytoriów aplikacji
Host->>Host: docker compose up - pełny stos Apollo
Note over Host: Środowisko gotowe dla testerów (:80/:443, :8080-8087)
Co jest ręczne albo brakuje¶
| Element | Stan | Gdzie |
|---|---|---|
Zastąpienie ~23 istniejących maszyn apollo-test nowymi |
TODO (faza E) | devops-process.md, "Zastępowanie istniejących maszyn" |
| Bucket na state Terraform, blokady | brakuje | docs/devops-process.md sekcja 6 |
| Klucze publiczne agentów TeamCity | brakuje | ansible/inventory/group_vars/all.yml (teamcity_access_authorized_keys) |
Klucz Bitbucket (vault_apollo_docker_deploy_key) |
brakuje | ansible-vault |
| Wpis hosta w TeamCity (tylko apollo-docker) | ręczny | AppName.kt, ServerConstants.kt |
Uruchomienie site.yml po apply |
ręczny | docelowo TeamCity (faza F) |
.env.local / config/ per odbiorca |
poza repo, na maszynie | docs/infra-structure.md sekcja 7, punkt 3 |
Ostatnia zmiana: 2026-09-28 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e