Generator Terraform AWS

Generator Terraform AWS

Terraform opisuje infrastrukturę jako kod. Zamiast klikać w konsoli AWS, definiujesz zasoby w plikach i wdrażasz je powtarzalnie. Generator Terraform AWS składa kompletny plik main.tf dla jednego zasobu: bucketu S3, instancji EC2 albo bazy RDS, razem z blokiem terraform, providerem, tagami i outputami.

Wspierane zasoby

Każdy plik zaczyna się od required_version = ">= 1.5" i providera hashicorp/aws w wersji ~> 5.0. Po wygenerowaniu kod można skopiować albo pobrać od razu jako main.tf.

Workflow

1. terraform init – pobiera providera AWS i przygotowuje katalog.
2. terraform fmt i terraform validate – formatowanie i kontrola składni bez tworzenia zasobów.
3. terraform plan -out=tfplan – podgląd zmian zapisany do pliku planu.
4. terraform apply tfplan – wykonanie dokładnie tego planu w AWS.
5. terraform output – odczyt ID, ARN, adresu IP lub endpointu bazy.

Zasoby usuwa terraform destroy. Bucket S3 z plikami da się tak usunąć tylko z włączoną opcją force_destroy.

Bezpieczeństwo

• Hasło bazy podawaj przez zmienną środowiskową TF_VAR_db_password albo zaznacz opcję Secrets Manager, wtedy hasło tworzy i przechowuje AWS.
• Nie commituj pliku stanu (terraform.tfstate): var.db_password zapisuje się w nim jawnym tekstem, nawet z sensitive = true. Użyj zdalnego, szyfrowanego backendu.
• Blokada publicznego dostępu do S3 jest domyślnie włączona (cztery przełączniki). Odznacz ją tylko wtedy, gdy bucket ma serwować treści publicznie.

Jak działa generator Terraform AWS

Generator działa jak konwerter formularza na kod w składni HCL. Wybierasz zasób, wypełniasz pola i klikasz „Generuj Terraform”. Kod jest budowany na serwerze webp.pl, ale bez połączenia z AWS: nie podajesz kluczy dostępu, a narzędzie nie wysyła zapytań do API AWS i nie tworzy niczego w chmurze.

Przed złożeniem kodu formularz sprawdza dane według reguł AWS: format regionu (np. eu-central-1), nazwę bucketu S3 (3–63 znaki, małe litery, cyfry, kropki i myślniki, bez „..” i bez postaci adresu IP), identyfikator RDS (mała litera na początku, bez „--” i bez myślnika na końcu), typ instancji, ID AMI, klasę bazy, rozmiar dysku od 20 do 65 536 GiB i nazwę użytkownika (do 16 znaków). Błędne pole jest oznaczane, a kod nie powstaje, dopóki go nie poprawisz.

Mechanizm jest deterministyczny: te same wartości dają ten sam plik. Etykieta zasobu w Terraform powstaje z nazwy po zamianie znaków innych niż litery, cyfry i „_” na podkreślnik, więc app-bucket daje adres aws_s3_bucket.app_bucket. Nazwa zaczynająca się cyfrą dostaje prefiks r_. Tagi wpisujesz jako klucz=wartość, po jednej parze w linii; tag Name dodaje się sam z nazwy zasobu.

Generator odpowiada tylko za zapis konfiguracji. Nie sprawdza, czy nazwa jest wolna, czy typ maszyny jest dostępny w regionie ani czy limity konta pozwolą uruchomić zasób. To weryfikują Terraform i AWS przy plan i apply.

Przykład krok po kroku: baza RDS PostgreSQL

1. Wybierz RDS i ustaw region eu-central-1. Ta wartość trafia do bloku provider "aws".
2. Wpisz identyfikator sklep-db. Etykieta w kodzie to sklep_db, więc zasób ma adres aws_db_instance.sklep_db.
3. Zostaw silnik PostgreSQL, klasę db.t3.micro, dysk 20 GiB i użytkownika dbadmin. Wersję silnika wybierze AWS (domyślną dla regionu).
4. Nie zaznaczaj Secrets Manager. Plik dostanie wtedy password = var.db_password i blok variable "db_password" z walidacją długości co najmniej 8 znaków.
5. Zostaw „Pomiń końcowy snapshot” dla środowiska testowego. Po odznaczeniu pojawi się final_snapshot_identifier = "sklep-db-final".
6. Kliknij „Generuj Terraform” i pobierz main.tf. Tabela pod kodem pokaże bloki: terraform, provider, aws_db_instance.sklep_db, db_password oraz outputy sklep_db_id i sklep_db_endpoint.
7. Uruchom export TF_VAR_db_password='…', a potem terraform init i terraform plan. Baza trafi do domyślnego VPC regionu i domyślnej grupy zabezpieczeń.

Dla EC2 działa to podobnie, z jedną różnicą: zamiast stałego ID obrazu dostajesz blok data "aws_ami", który przy plan wyszukuje najnowszy obraz w regionie. Typy Graviton (np. t4g.small, m6g.large) dostają filtr na obraz arm64, pozostałe na x86_64.

Argumenty w wygenerowanym kodzie

Praktyczne wskazówki użycia

• Generator tworzy jeden zasób na plik. Jeśli potrzebujesz bucketu i bazy, wygeneruj dwa pliki i połącz je w jednym katalogu, usuwając powtórzony blok terraform i provider.
• Ustal konwencję nazw przed pierwszym uruchomieniem. Przedrostek z nazwą projektu lub środowiska (np. firma-prod-backup) chroni przed kolizją globalnie unikalnych nazw S3.
• Drugi zasób tego samego typu wymaga innej nazwy, bo z niej powstaje etykieta. Dwa bloki aws_instance.web_1 w jednym katalogu zatrzymają terraform validate.
• Na produkcji odznacz pomijanie końcowego snapshotu RDS, aby przed usunięciem bazy powstała jej kopia.
• Kod jest tekstem, więc diff w Git pokazuje dokładnie, co zmieniłeś. Do repozytorium dodaj main.tf, ale nie terraform.tfstate ani pliki .tfvars z sekretami.

Czego narzędzie nie uwzględnia

• Stanu konta AWS: zajętej nazwy bucketu, istniejącego identyfikatora bazy ani dostępności typu instancji w regionie.
• Kosztów. Klasa instancji i rozmiar dysku to parametry konfiguracji, a nie wycena; ceny sprawdzisz w kalkulatorze AWS.
• Sieci. Nie powstaje VPC, podsieć, grupa bezpieczeństwa ani para kluczy SSH, więc EC2 i RDS lądują w domyślnym VPC. Dla produkcji dopisz te zasoby samodzielnie.
• Wersji silnika bazy, backendu stanu i modułów. Formularz sprawdza format danych, ale reszta konfiguracji zostaje po Twojej stronie.