Konfiguracja: Terraform i Ansible¶
Jak przygotować maszynę, z której uruchamiamy Terraform i Ansible: narzędzia, poświadczenia, zmienne środowiskowe i sprawdzenie, że wszystko działa.
Sekrety
Żaden klucz nie trafia do repozytorium.
Wartości bierzemy z Vault, trzymamy w lokalnym .envrc (jest w .gitignore) albo w ~/.config/scw/config.yaml.
Jedyny sekret w repo to wartości zaszyfrowane ansible-vault.
1. Wymagania¶
| Narzędzie | Wersja | Po co | Skąd wymóg |
|---|---|---|---|
| Terraform | >= 1.6 | tworzenie zasobów Scaleway | required_version; blok endpoints backendu s3 |
provider scaleway/scaleway |
~> 2.60 |
versions.tf, zablokowany w .terraform.lock.hcl |
|
| Python | >= 3.10 | ansible-core, SDK Scaleway | |
| ansible-core | >= 2.15 (testowane 2.21) | konfiguracja hostów | deb822_repository, systemd_service w rolach |
scaleway (Python SDK) |
>= 2.9.0 | wtyczka inwentarza scaleway.scaleway.scaleway |
wymóg kolekcji |
| kolekcje Ansible | community.general, ansible.posix, scaleway.scaleway >= 2.7.2 |
moduły, inwentarz | ansible/collections/requirements.yml |
| ansible-lint | >= 24 | kontrola jakości | .config/ansible-lint.yml |
scw CLI |
dowolna aktualna | sprawdzanie ID projektów i klucza API | opcjonalnie |
| direnv | dowolna | automatyczne ładowanie .envrc |
opcjonalnie |
Hosty docelowe to Ubuntu, a nowe maszyny z Terraforma dostają 24.04 ubuntu_noble.
Instalacja¶
wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" \
| sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install -y terraform python3-venv direnv
Ansible i jego zależności instalujemy w wirtualnym środowisku w katalogu repozytorium.
Katalog .venv/ jest w .gitignore:
cd logintegra-ansible
python3 -m venv .venv
. .venv/bin/activate
pip install -r ansible/requirements.txt
ansible-galaxy collection install -r ansible/collections/requirements.yml
2. Poświadczenia Scaleway¶
Potrzebny jest klucz API aplikacji, tworzony w IAM -> Applications -> API keys, z uprawnieniami:
| Zakres | Uprawnienie | Dla |
|---|---|---|
projekty apollo-qa, apollo-test |
InstancesFullAccess |
Terraform: instancje, IP, security groups |
| projekt z bucketem na state | ObjectStorageFullAccess |
backend Terraform |
| projekty, z których Ansible czyta hosty | InstancesReadOnly |
inwentarz dynamiczny |
Klucz zapisujemy w Vault.
Terraform, Ansible i scw CLI czytają go z tych samych zmiennych SCW_*.
3. Zmienne środowiskowe¶
Wzór wszystkich zmiennych: .envrc.example.
Scaleway - Terraform, Ansible, scw¶
| Zmienna | Wymagana | Kto czyta | Znaczenie |
|---|---|---|---|
SCW_ACCESS_KEY |
tak | provider Terraform, inwentarz Ansible, scw |
identyfikator klucza API (SCW...) |
SCW_SECRET_KEY |
tak | jw. | sekret klucza API (UUID) |
SCW_DEFAULT_ORGANIZATION_ID |
zalecana | jw. | organizacja Logintegra |
SCW_DEFAULT_PROJECT_ID |
nie | scw |
Terraform jej nie używa - projekt bierze z project_id w <env>.tfvars |
SCW_DEFAULT_REGION |
nie | scw |
pl-waw |
SCW_TOKEN |
dla playbooków start/stop | perform-server-action-and-wait.yml (i nakładki start-/stop-/reboot-server-and-wait.yml) |
= SCW_SECRET_KEY; playbook woła API Scaleway bezpośrednio i czyta klucz pod tą nazwą |
SCW_PROFILE, SCW_CONFIG_FILE |
nie | inwentarz Ansible, scw |
alternatywa dla zmiennych: profil z ~/.config/scw/config.yaml (scw init) |
State Terraform - backend s3 na Object Storage¶
| Zmienna | Wymagana | Znaczenie |
|---|---|---|
AWS_ACCESS_KEY_ID |
tak (przy init/plan/apply) |
= SCW_ACCESS_KEY - backend s3 czyta klucze pod nazwami AWS |
AWS_SECRET_ACCESS_KEY |
tak | = SCW_SECRET_KEY |
Ansible¶
| Zmienna | Wymagana | Znaczenie |
|---|---|---|
ANSIBLE_PRIVATE_KEY_FILE |
tak | klucz prywatny pary ansible/playbooks/ansible_key.pub, czyli konta ansible na hostach |
ANSIBLE_REMOTE_USER |
zalecana | ansible - to konto zakłada cloud-init na nowych maszynach i create-ansible-user.yaml na starych |
ANSIBLE_VAULT_PASSWORD_FILE |
gdy używamy vault | plik z hasłem do ansible-vault, poza repozytorium |
ANSIBLE_CONFIG |
nie | tylko gdy uruchamiamy spoza ansible/ - wskazuje ansible/ansible.cfg |
4. Terraform¶
Wartości środowiska są w repo, w terraform/environments/<env>/<env>.tfvars, i nie ma wśród nich sekretów.
Środowisko qa to mirror produkcji na hostach Tomcata w projekcie apollo-qa.
Środowisko test to hosty apollo-docker testerów w projekcie apollo-test.
Jednorazowo, per środowisko¶
- Wpisz
project_idw<env>.tfvars. Dopóki jest"TODO",planzatrzyma się na walidacji - celowo, żeby zasoby nie powstały w projekcie ustawionym akurat w shellu. - Bucket na state to
apollo-terraform-statew Object Storage (regionpl-waw), wpisany wbackend.tf- jeden na wszystkie środowiska, kluczeqa/terraform.tfstate,test/terraform.tfstate. Bucket ma włączone wersjonowanie i Object Lock - historia state jest chroniona (FAQ Terraform).
Praca¶
cd terraform/environments/test # albo qa
terraform init
terraform fmt -check -recursive ../..
terraform validate
terraform plan -var-file=test.tfvars -out=test.tfplan
terraform apply test.tfplan # po akceptacji planu przez drugą osobę
Lokalnie, bez dostępu do state, np. przy sprawdzaniu składni w PR:
.terraform.lock.hcl jest w repo - wersję providera podnosimy świadomie (terraform init -upgrade) osobnym commitem.
5. Ansible¶
Wszystkie polecenia z katalogu ansible/ - stamtąd wczytuje się ansible.cfg (ścieżka ról, force_valid_group_names).
Środowisko test tylko przez VPN
Security groups w test przepuszczają SSH wyłącznie z logintegra-vpn (151.115.59.12).
Bez VPN Ansible zakończy się timeoutem połączenia.
cd ansible
# kogo widzi inwentarz i w jakich grupach (tag `apollo-docker` -> grupa tag_apollo_docker)
ansible-inventory -i inventory/test_scw.yml --graph
# połączenie
ansible -i inventory/test_scw.yml tag_docker -m ansible.builtin.ping
# stan docelowy: najpierw podgląd, potem zmiana
ansible-playbook -i inventory/test_scw.yml playbooks/state/site.yml --check --diff
ansible-playbook -i inventory/test_scw.yml playbooks/state/site.yml
# jedna maszyna
ansible-playbook -i inventory/test_scw.yml -l test-apollo-wombaty-docker-01 playbooks/state/site.yml
# lint
ansible-lint
Dane, które trzeba uzupełnić przed pierwszym uruchomieniem¶
| Co | Gdzie | Skąd |
|---|---|---|
| klucze publiczne agentów TeamCity | inventory/group_vars/all.yml -> teamcity_access_authorized_keys |
Vault: Public key: SSH Access to servers from TeamCity Apollo |
| klucz Bitbucket dla apollo-docker | inventory/group_vars/tag_apollo_docker.yml -> vault_apollo_docker_deploy_key |
Vault; zaszyfrować (niżej) |
ansible-vault encrypt_string --name vault_apollo_docker_deploy_key < klucz_bitbucket
# wynik wkleić do tag_apollo_docker.yml i odkomentować apollo_docker_deploy_key
6. Sprawdzenie konfiguracji¶
terraform version # >= 1.6
ansible --version | head -1 # core >= 2.15
python -c "import scaleway; print(scaleway.__version__)" # >= 2.9, w Pythonie Ansible'a
ansible-galaxy collection list | grep -E "scaleway|posix|community.general"
env | grep -E "^(SCW|AWS|ANSIBLE)_" | sed 's/=.*/=***/' # czy zmienne są ustawione
scw account project list # czy klucz działa
cd ansible && ansible-inventory -i inventory/test_scw.yml --graph
7. Problemy¶
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
Invalid secrets, access_key & secret_key must be defined |
brak SCW_ACCESS_KEY / SCW_SECRET_KEY w środowisku i brak profilu scw |
source .envrc / direnv allow |
authentication is denied ... "reason":"not_found" |
klucz API nie istnieje albo jest z innej organizacji | sprawdzić klucz w Vault / IAM |
Failed to import the required Python library (scaleway) |
SDK w innym Pythonie niż Ansible | pip install -r ansible/requirements.txt w venv Ansible'a |
| inwentarz pusty, bez błędu | żaden host nie ma taga środowiska. qa_scw.yml jest pusty do czasu pierwszego apply w qa. |
tagi hostów w konsoli / w Terraformie |
-l tag_apollo-docker nic nie wybiera |
myślnik w tagu -> podkreślenie w grupie | -l tag_apollo_docker |
the role 'users' was not found / lint zgłasza syntax-check |
uruchomienie spoza ansible/ |
cd ansible albo ANSIBLE_CONFIG=ansible/ansible.cfg |
project_id: ID projektu ... (UUID) przy plan |
project_id = "TODO" w <env>.tfvars |
wpisać ID projektu (sekcja 4) |
Backend initialization required |
brak terraform init w katalogu środowiska |
terraform init |
No valid credential sources found przy init |
brak AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY |
ustawić = klucze Scaleway |
--check: Either user must exist or you must provide full path to key file |
konto jeszcze nie istnieje, a authorized_key w trybie próbnym tego nie przewidzi |
normalne na nowej maszynie; zwykłe uruchomienie przechodzi |
Ostatnia zmiana: 2026-09-28 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e