# logintegra-infra

Infrastruktura Logintegry jako kod:  
\- Terraform tworzy i utrzymuje zasoby w Scaleway,  
\- Ansible konfiguruje to, co jest na serwerze.

### Pierwsze kroki

| Dokument | Zawartość |
| --- | --- |
| [Konfiguracja Terraform i Ansible](<https://docs.logintegra.com/logintegra-ansible/setup/index.md>) | wymagania, poświadczenia Scaleway, zmienne środowiskowe, pierwsze uruchomienie, typowe błędy |

### FAQ

| Dokument | Zawartość |
| --- | --- |
| [Jak pracujemy](<https://docs.logintegra.com/logintegra-ansible/faq/index.md>) | maszyny niezmienne, dodanie maszyny / zasobu / playbooka, zmiana i odtworzenie maszyny |
| [Terraform](<https://docs.logintegra.com/logintegra-ansible/terraform-faq/index.md>) | state: podgląd, dryf, odtworzenie i zmiana nazwy zasobu, usuwanie, start od zera, odzyskiwanie state |

### Hosty

| Dokument | Zawartość |
| --- | --- |
| [Host dockerowy (docker-node)](<https://docs.logintegra.com/logintegra-ansible/docker-node-flow/index.md>) | środowisko `test`: topologia i przepływ od zera do działającego środowiska apollo-docker |
| [Host Tomcata (tomcat-node)](<https://docs.logintegra.com/logintegra-ansible/tomcat-node/index.md>) | środowisko `qa`: mirror produkcji, Tomcat 9 pod deploy WAR-a z TeamCity, braki |

### Architektura i proces

| Dokument | Zawartość |
| --- | --- |
| [Proces DevOps](<https://docs.logintegra.com/logintegra-ansible/devops-process/index.md>) | \[DRAFT\] cel, gałęzie i code review, tagi, konwencja nazewnicza, state, plan wdrożenia, zastępowanie maszyn |
| [Struktura Terraform i Ansible](<https://docs.logintegra.com/logintegra-ansible/infra-structure/index.md>) | \[DRAFT\] warstwy modułów, role, inwentarze, ryzyka i otwarte pytania |
| [Zasoby Scaleway](<https://docs.logintegra.com/logintegra-ansible/logintegra-resources/index.md>) | ręczny spis instancji, obrazów, wolumenów i snapshotów |

### TODO

| Dokument | Zawartość |
| --- | --- |
| [TeamCity bez commitu na maszynę](<https://docs.logintegra.com/logintegra-ansible/teamcity-dynamic-targets/index.md>) | \[PLAN\] TeamCity ustala maszynę docelową z tagów Scaleway w chwili buildu zamiast z `AppName.kt` / `ServerConstants.kt` |
| [Dostęp SSH do maszyn](<https://docs.logintegra.com/logintegra-ansible/ssh-access-plan/index.md>) | \[PLAN\] koniec wspólnego klucza `ansible`: konta osobiste, ograniczenia kluczy, docelowo certyfikaty SSH |

Instrukcje uruchamiania: `README.md` w katalogu głównym repozytorium oraz `terraform/README.md`.

## Dokumentacja lokalnie

Strona budowana jest przez [Zensical](<https://zensical.org>) z plików w `docs/`, konfiguracja w `zensical.toml`.

```
pip install zensical        # albo: uv tool install zensical
zensical serve              # http://localhost:8000, przeładowanie na żywo
zensical build --clean      # statyczna strona w site/
```
