Kurs NestJS · Moduł 12: Konteneryzacja i CI/CD
Infrastructure as Code z Terraform
W tej lekcji5
Serwer produkcyjny postawiono rok temu, klikając w panelu dostawcy. Działa. Ale nikt nie pamięta, jaki dokładnie wybrano rozmiar maszyny, które porty otwarto i czy dysk ma 50 czy 100 gigabajtów. Postawienie identycznego środowiska testowego to teraz kilka godzin zgadywania - i tak wyjdzie inaczej.
Rzymianie nie budowali akweduktów z pamięci. Każdy zaczynał się od planu architektonicznego: rysunku, z którego dowolna ekipa mogła odtworzyć tę samą konstrukcję w innej prowincji. Infrastructure as Code to ten sam pomysł: infrastruktura definiowana w kodzie, a nie klikaniem.
Nie myl tego z narzędziami, które brzmią podobnie, a robią co innego: to nie framework do testowania infrastruktury, nie system monitorowania serwerów i nie narzędzie do kompresji obrazów Dockera. To sposób opisania tego, co ma istnieć.
Plan w pliku
Terraform czyta pliki z rozszerzeniem .tf. Opis składa się z kilku rodzajów bloków:
provider "aws" {
region = "eu-central-1"
}
variable "app_name" {
type = string
default = "legion-api"
}
variable "app_port" {
type = number
default = 3000
}
resource "aws_instance" "legion_server" {
ami = "ami-0abcdef1234567890"
instance_type = "t3.micro"
tags = {
Name = var.app_name
}
}
output "server_ip" {
value = aws_instance.legion_server.public_ip
}provider mówi, u kogo budujemy - tutaj AWS w regionie eu-central-1. variable to parametr planu; dzięki niemu ten sam opis postawi środowisko testowe i produkcyjne, różniące się tylko wartościami. resource opisuje rzecz, która ma istnieć - maszynę, sieć, bazę. output wskazuje, co Terraform ma pokazać po zakończeniu; adres IP zwykle poznajesz dopiero po utworzeniu serwera.
Zwróć uwagę na sposób odwoływania się: var.app_name sięga po zmienną, a aws_instance.legion_server.public_ip - po pole utworzonego zasobu. Z tych odwołań Terraform sam wyprowadza kolejność tworzenia: skoro output potrzebuje adresu maszyny, maszyna musi powstać wcześniej.
Cztery komendy
Praca z Terraformem to zawsze ta sama sekwencja:
terraform init- inicjalizacja projektu; pobiera providery wymienione w plikach.terraform plan- podgląd zmian bez ich stosowania.terraform apply- zastosowanie zmian.terraform output- sprawdzenie wyników.
Drugi krok jest sercem całego narzędzia, więc nazwijmy go wprost: terraform plan to DRY RUN. Porównuje Twój opis ze stanem faktycznym i wypisuje, co zamierza utworzyć, zmienić i usunąć - nie ruszając niczego. Nie tworzy zasobów, nie usuwa infrastruktury i nie pobiera providerów; od pobierania jest init.
Ten podgląd jest jedyną chwilą, w której zobaczysz zamiar narzędzia, zanim stanie się faktem. Czytaj go - zwłaszcza linie zaczynające się od minusa, bo Terraform potrafi uznać, że pewnej zmiany nie da się wykonać w miejscu, i usunąć zasób, żeby utworzyć go na nowo. Przy maszynie testowej to niedogodność; przy bazie z danymi - katastrofa.
Plan zapisany do pliku
W zespole i w CI stosuje się wariant dwuetapowy, żeby mieć pewność, że wdrażasz dokładnie to, co przejrzałeś:
terraform init
terraform plan -out=tfplan
terraform apply tfplan
terraform output-out=tfplan zapisuje wyliczony plan do pliku. apply tfplan stosuje dokładnie ten plan, zamiast wyliczać go na nowo.
Różnica ma znaczenie, gdy między przeglądem a zatwierdzeniem minie kilka minut, a ktoś w tym czasie zmieni infrastrukturę. Zwykłe apply policzyłoby wtedy plan od nowa i zrobiło coś innego, niż przeczytałeś na ekranie.
Stan, którego nie wolno commitować
Terraform musi pamiętać, co już utworzył - inaczej przy każdym uruchomieniu stawiałby wszystko od zera. Zapisuje to w pliku terraform.tfstate.
Ten plik nie należy do repozytorium Git, i to z dwóch powodów naraz. Po pierwsze zawiera wrażliwe dane - hasła do baz, klucze, adresy - zapisane jawnym tekstem, bo Terraform musi je pamiętać między uruchomieniami. Po drugie Git nie zapewnia blokady przy pracy zespołowej: gdy dwie osoby uruchomią apply jednocześnie, powstaną dwie wersje stanu i konflikt, którego nie da się rozstrzygnąć scaleniem, bo to nie jest plik do czytania przez człowieka.
Powody, które czasem się słyszy - że plik jest za duży dla Gita albo że Terraform sam go usuwa po apply - są nieprawdziwe.
Rozwiązaniem jest backend zdalny: wspólne miejsce, które trzyma stan i blokuje go na czas operacji.
terraform {
backend "s3" {
bucket = "imperium-terraform-state"
key = "legion-api/terraform.tfstate"
region = "eu-central-1"
dynamodb_table = "terraform-locks"
}
}Tabela wskazana w dynamodb_table służy właśnie do blokady - druga osoba uruchamiająca apply zobaczy komunikat, że stan jest zajęty, zamiast zepsuć wspólną infrastrukturę.
Podsumowanie
Plan architektoniczny gotowy, prowincje odtwarzalne:
- Infrastructure as Code to podejście, w którym infrastruktura jest definiowana w kodzie - nie framework testowy, nie monitoring, nie kompresja obrazów,
- pliki
.tfzawierają bloki:provider(u kogo),variable(parametry),resource(co ma istnieć),output(co pokazać po zakończeniu), - kolejność tworzenia Terraform wyprowadza sam, z odwołań między zasobami,
- cztery kroki:
terraform init→terraform plan→terraform apply→terraform output, terraform planto DRY RUN - pokazuje podgląd zmian bez ich stosowania; nie tworzy, nie usuwa i nie pobiera providerów,- czytaj plan, zwłaszcza usunięcia - Terraform potrafi odtworzyć zasób zamiast zmienić go w miejscu,
- w zespole:
plan -out=tfplan, potemapply tfplan- wdrażasz dokładnie to, co przejrzałeś, terraform.tfstatenie trafia do Gita: zawiera wrażliwe dane i nie ma blokady dla pracy zespołowej,- rozwiązaniem jest backend zdalny z blokadą stanu na czas operacji.
W następnej lekcji zbierzesz cały ten moduł w jeden projekt - konteneryzację, pipeline i wdrożenie. A na razie zapamiętaj: klikanie w panelu tworzy serwer, którego nikt nie umie odtworzyć; plan w pliku tworzy taki, który odtworzy każdy.
Kod do tej lekcji: src/terraform-iac.ts
// Infrastructure as Code - Plany Architektoniczne Imperium
console.log("=== TERRAFORM - INFRASTRUCTURE AS CODE ===\n");
interface TerraformCommand {
command: string;
description: string;
analogy: string;
}
const commands: TerraformCommand[] = [
{
command: 'terraform init',
description: 'Inicjalizacja - pobierz providery i moduly',
analogy: 'Zebranie materialow budowlanych',
},
{
command: 'terraform plan',
description: 'Podglad zmian (DRY RUN)',
analogy: 'Przejrzenie planow architektonicznych',
},
{
command: 'terraform apply',
description: 'Zastosowanie zmian na infrastrukturze',
analogy: 'Rozpoczecie budowy',
},
{
command: 'terraform destroy',
description: 'Usuniecie calej infrastruktury',
analogy: 'Rozbiorka budowli',
},
];
console.log("Komendy Terraform:\n");
commands.forEach((c, i) => {
console.log(`${i + 1}. ${c.command}`);
console.log(` Opis: ${c.description}`);
console.log(` Analogia: ${c.analogy}\n`);
});
// Porownanie reczne vs IaC
console.log("=== RECZNE vs IaC ===\n");
const comparison = {
'Powtarzalnosc': ['Kazde srodowisko inne', 'Identyczne srodowiska'],
'Historia zmian': ['Brak', 'Pelna historia w Git'],
'Code review': ['Brak', 'Zespol weryfikuje infrastrukture'],
'Disaster recovery': ['Dni', 'Minuty'],
};
console.log("Cecha | Reczne | IaC (Terraform)");
console.log("-".repeat(65));
Object.entries(comparison).forEach(([key, [manual, iac]]) => {
console.log(`${key.padEnd(17)}| ${manual.padEnd(20)}| ${iac}`);
});
// Kluczowe zasoby
console.log("\n=== ZASOBY TERRAFORM DLA NestJS ===\n");
const resources = [
'aws_instance - serwer EC2 dla API',
'aws_docdb_cluster - MongoDB (DocumentDB)',
'aws_security_group - firewall',
'aws_s3_bucket - state backend',
];
resources.forEach(r => console.log(` - ${r}`));
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Czym jest Infrastructure as Code (IaC)?
2. Co robi komenda 'terraform plan'?
To 2 z 8 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Zdefiniuj providera AWS (region eu-central-1), zmienne (environment, app_name, app_port), resource aws_instance z user_data uruchamiającym Docker
- Układanie w pionie
Uporządkuj kroki pracy z Terraform od pierwszego do ostatniego:
- Klikanie w kolejności
Ułóż elementy workflow terraform plan + apply w prawidłowej kolejności:
- Edytor kodu
Oznacz done=true dla wszystkich wymaganych elementów checklisty: Docker, CI/CD, Kubernetes, Observability, IaC, Secrets
- Układanie w pionie
Uporządkuj elementy definicji zasobu EC2 w Terraform (od zewnętrznego do wewnętrznego):
- Układanie w pionie
Uporządkuj kroki wdrożenia aplikacji od początku do końca:
- Klikanie w kolejności
Ułóż elementy konfiguracji healthcheck w Docker:
- Układanie w poziomie
Ułóż elementy instrukcji kopiowania z etapu builder:
- Układanie w pionie
Uporządkuj providerów secrets według priorytetu (od najwyższego):
- Klikanie w kolejności
Ułóż elementy komendy wdrożenia zasobów Kubernetes:
- Układanie w poziomie
Ułóż elementy komendy skalowania Deployment do 5 replik:
Zadania po tej lekcji
- PytanieCzym jest Infrastructure as Code
- PytanieTerraform plan - podgląd zmian
- Zadanie z kodemKonfiguracja Terraform dla NestJS API
- Ułóż w kolejnościCykl pracy z Terraform
- PytanieTerraform state - zarządzanie stanem
- Kliknij w kolejnościKomenda terraform apply z planem
- Zadanie z kodemChecklista DevOps dla aplikacji NestJS
- Ułóż w kolejnościDefinicja resource w Terraform
- Ułóż w kolejnościPowtórzenie: Kroki wdrożenia kontenera na produkcję
- PytaniePowtórzenie: Komenda docker compose down -v
- Kliknij w kolejnościPowtórzenie: Healthcheck w Dockerfile
- PytaniePowtórzenie: Komunikacja kontenerów w Docker Compose
- Ułóż w kolejnościInstrukcja COPY --from w multi-stage
- PytaniePowtórzenie: Non-root user w Dockerfile
- Ułóż w kolejnościPriorytet providerów secrets w NestJS
- Kliknij w kolejnościKomenda kubectl apply w Kubernetes
- PytanieSealed Secrets w Kubernetes
- Ułóż w kolejnościSkalowanie Deployment w Kubernetes
- PytanieTerraform modules - reużywalne komponenty