Przejdź do treści

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