Piątek, 17:40. Inżynier z zespołu platformowego uruchamia terraform apply na laptopie, żeby poprawić jedną regułę grupy bezpieczeństwa. W tym samym czasie potok CI/CD wdraża zmianę w tym samym środowisku. Nikt nie ustawił blokady stanu, bo „przecież nas jest tylko trzech”. Dwa procesy zapisują plik stanu jeden po drugim i drugi nadpisuje pierwszego. W poniedziałek plan pokazuje, że Terraform chce usunąć bazę danych, o której istnieniu według stanu nie wie, i utworzyć ją od nowa. Kod w repozytorium jest poprawny. Problem leży gdzie indziej.

Takie historie nie biorą się z wyboru złego narzędzia. Biorą się z tego, że firmy zaczynają infrastrukturę jako kod od pisania modułów, a o pliku stanu myślą dopiero wtedy, gdy coś się w nim zepsuje. W tym samym czasie od trzech lat toczy się głośna dyskusja „Terraform czy OpenTofu”, która przyciąga uwagę, jakby od niej zależało wszystko.

Ten artykuł jest dla liderów DevOps i zespołów platformowych, które zaczynają albo porządkują infrastrukturę jako kod. Teza, której będziemy bronić, może brzmieć przekornie: wybór między Terraform a OpenTofu to decyzja na jedno popołudnie i dziś wciąż da się ją cofnąć, natomiast decyzja o tym, gdzie leży stan, kto może go czytać i jak jest podzielony, to decyzja na lata, której cofnięcie kosztuje najwięcej. Dlatego zaczynaj od stanu, nie od narzędzia. A pierwszym krokiem w firmie, która ma już środowiska w chmurze, nie są piękne moduły od zera, tylko przejęcie tego, co już działa.

Od czego naprawdę zaczyna się infrastruktura jako kod?

Infrastruktura jako kod (IaC) to opisywanie serwerów, sieci, baz danych, uprawnień i usług chmurowych w plikach tekstowych, które przechowujesz w repozytorium, przeglądasz jak kod aplikacji i wdrażasz przez zautomatyzowany potok. W wersji deklaratywnej, którą stosują Terraform i OpenTofu, opisujesz stan docelowy („ma istnieć sieć z trzema podsieciami”), a narzędzie samo wylicza, co trzeba utworzyć, zmienić albo usunąć.

Żeby to wyliczyć, narzędzie musi wiedzieć trzy rzeczy: co jest w kodzie, co istnieje w chmurze i które obiekty w chmurze odpowiadają którym blokom w kodzie. Tę trzecią informację przechowuje właśnie plik stanu. Bez niego Terraform nie wie, że instancja i-0abc to zasób aws_instance.api z Twojego repozytorium. Kod opisuje zamiar, chmura jest rzeczywistością, a stan jest mapą, która je łączy.

Stąd praktyczny wniosek dla kogoś, kto zaczyna. Zanim zespół napisze pierwszy moduł, powinien odpowiedzieć na pięć pytań:

  • Gdzie będzie leżał stan i czy backend obsługuje blokadę równoczesnego zapisu oraz wersjonowanie?
  • Jak stan będzie podzielony: na środowiska, na komponenty, na zespoły?
  • Kto może czytać i zapisywać stan i czy to te same osoby, które mają uprawnienia administratora w chmurze?
  • Kto i skąd uruchamia apply: tylko potok CI/CD czy także laptopy inżynierów?
  • Co robimy z tym, co już istnieje: importujemy, odbudowujemy czy zostawiamy poza kodem?

Narzędzie jest piątym, a nie pierwszym pytaniem na tej liście. Ma znaczenie, ale mniejsze, niż sugeruje dyskusja w mediach branżowych. Jeśli dopiero porządkujesz procesy wdrożeniowe, pomocny będzie też nasz opis wdrożenia potoku CI/CD krok po kroku, bo IaC bez potoku szybko wraca do „apply z laptopa”. Elementy samego potoku opisuje też hasło CI/CD pipeline w naszym słowniku.

Dlaczego stan, a nie kod, jest najcenniejszym artefaktem? Kod infrastruktury możesz odtworzyć: jest w repozytorium, ma historię, recenzje i kopie na komputerach całego zespołu. Plik stanu jest inny. Zawiera identyfikatory rzeczywistych zasobów, ich atrybuty w chwili ostatniego odczytu i zależności między nimi. Jeśli go stracisz albo uszkodzisz, kod nadal istnieje, ale narzędzie przestaje wiedzieć, którymi obiektami w chmurze zarządza. Następny plan zaproponuje utworzenie wszystkiego od nowa, a infrastruktura, która działa, zostanie osierocona.

Druga cecha stanu jest mniej oczywista: to dokument o wysokiej wrażliwości. Dokumentacja Terraform mówi wprost, że sekrety wpisane w konfigurację trafiają do pliku stanu i do plików planu, a przy lokalnym stanie leżą w zwykłym pliku tekstowym. Co ważniejsze, każdy, kto ma dostęp do stanu, może odczytać te wartości, nawet jeśli w kodzie oznaczono je jako sensitive. Oznaczenie sensitive ukrywa wartość w wyjściu konsoli, ale nie w stanie.

Trzecia cecha: stan jest współdzielonym zasobem z możliwością konfliktów. Dwa równoczesne zapisy, ręczna edycja pliku, terraform state rm wykonane na złym adresie, przerwany apply w połowie operacji — każda z tych sytuacji może sprawić, że mapa przestaje odpowiadać terenowi. Dlatego dojrzałe zespoły traktują stan tak jak bazę danych produkcyjnych: z kopiami zapasowymi, blokadami, ograniczonym dostępem i procedurą odtworzenia.

Jeśli przyjmiesz tę perspektywę, wiele decyzji staje się prostszych. Przestajesz pytać „którego narzędzia użyć”, a zaczynasz pytać „jak zaprojektować przechowywanie i podział tej bazy danych, żeby jedna pomyłka nie dotknęła całej firmy”. Do tego wrócimy w osobnych sekcjach. Najpierw jednak trzeba uporządkować kontekst, który od 2023 roku zaciemnia każdą rozmowę o IaC.

Co zmieniła licencja BSL w 2023 roku i kogo naprawdę dotyczy?

10 sierpnia 2023 roku HashiCorp ogłosił, że przyszłe wydania jego produktów, w tym Terraform, przechodzą z licencji open source Mozilla Public License 2.0 na Business Source License 1.1 (BSL, w plikach licencji oznaczaną jako BUSL). Interfejsy API, SDK i niemal wszystkie biblioteki pozostały na MPL 2.0. Według zestawień publikowanych po zmianie ostatnim wydaniem Terraform na MPL było 1.5.7 z 7 września 2023 roku, a pierwszym na BUSL — 1.6.0. Plik licencji w repozytorium Terraform obejmuje wersje 1.6.0 i nowsze.

Co ta licencja realnie ogranicza? Kluczowy jest tak zwany dodatkowy grant użycia. W obecnym brzmieniu pozwala na użycie produkcyjne, o ile Twoje użycie nie polega na oferowaniu Terraform stronom trzecim w celu konkurowania z płatnymi wersjami licencjodawcy. Licencja ma też datę zmiany: każde wydanie przechodzi na MPL 2.0 cztery lata po publikacji. Najstarsze wydania na BSL staną się więc ponownie otwarte dopiero w 2027 roku, a każde kolejne cztery lata po swojej premierze.

Dla typowej firmy, która zarządza własną infrastrukturą w AWS, Azure czy Google Cloud, wniosek jest uspokajający: wewnętrzne użycie Terraform pozostaje dozwolone i bezpłatne. Ogłoszenie HashiCorp z 2023 roku wprost zapewniało, że użytkownicy końcowi mogą nadal kopiować, modyfikować i rozpowszechniać kod do celów niekomercyjnych i komercyjnych, z wyjątkiem oferowania produktu konkurencyjnego. Ograniczenie dotyka przede wszystkim dostawców platform automatyzacji, którzy budowali usługi zarządzane na bazie Terraform.

Szara strefa pojawia się w dwóch miejscach. Pierwsze to firmy świadczące usługi zarządzania infrastrukturą chmurową dla klientów, zwłaszcza gdy budują wokół Terraform własny portal czy produkt. Drugie to organizacje, których polityka wymaga licencji zatwierdzonych przez Open Source Initiative, bo BSL nią nie jest. W obu przypadkach decyzja przestaje być techniczna i przechodzi do działu prawnego. Jeśli masz w firmie proces oceny licencji oprogramowania, to dobry moment, żeby wpisać do niego narzędzia IaC; podstawy opisuje hasło licencjonowanie oprogramowania w naszym słowniku.

Warto też nazwać to, czego licencja nie zmieniła. Dostawcy (providers) Terraform, czyli wtyczki do AWS, Azure, Kubernetesa czy setek usług SaaS, są osobnymi projektami z własnymi licencjami i w ogromnej większości pozostały otwarte. Język HCL, format stanu i sposób pracy też się nie zmieniły. Zmieniło się to, kto może zbudować biznes na rdzeniu narzędzia, i to wystarczyło, żeby powstał fork.

Czym jest OpenTofu po trzech latach i kto za nim stoi?

Dokładnie trzy lata temu, 20 września 2023 roku, Linux Foundation ogłosiła projekt OpenTofu (wcześniej OpenTF) jako otwartą, rozwijaną przez społeczność odpowiedź na zmianę licencji Terraform. W komunikacie mowa była o deklaracjach poparcia od ponad 140 organizacji i 600 osób oraz o zobowiązaniu do finansowania co najmniej 18 pełnoetatowych programistów przez co najmniej pięć lat. Wśród firm wspierających wymieniono m.in. Harness, Gruntwork, Spacelift, env0, Scalr i Terramate, czyli w dużej mierze dostawców platform, których model biznesowy BSL bezpośrednio dotknął.

Pierwsze stabilne wydanie, OpenTofu 1.6, pojawiło się w styczniu 2024 roku. 23 kwietnia 2025 roku projekt został przyjęty do Cloud Native Computing Foundation na poziomie Sandbox, czyli najniższym poziomie dojrzałości w tej fundacji. To ważny sygnał zarządczy: projekt ma neutralne miejsce w strukturze fundacji, ale nie przeszedł jeszcze ścieżki, którą przeszedł na przykład Kubernetes.

Ważniejsze od deklaracji jest jednak tempo rozwoju. Od pierwszego wydania OpenTofu dostarcza funkcje, których Terraform nie ma albo które dostał później:

  • 1.7 (kwiecień 2024): szyfrowanie stanu po stronie klienta, niezależne od backendu, blok removed i importy w pętli, przydatne przy masowym przejmowaniu zasobów.
  • 1.10 (czerwiec 2025): natywna blokada stanu w S3 bez DynamoDB, dystrybucja dostawców i modułów przez rejestry OCI (ważne w środowiskach odciętych od internetu), oznaczanie zmiennych i wyjść jako przestarzałych.
  • 1.11 (grudzień 2025): zasoby ulotne (ephemeral), atrybuty tylko do zapisu i meta-argument enabled jako czytelniejsza alternatywa dla count = 0/1.
  • 1.12 (maj 2026): dynamiczne prevent_destroy zależne od zmiennych, meta-argument destroy = false usuwający zasób ze stanu bez niszczenia obiektu w chmurze, pełniejsze sumy kontrolne dostawców.

Z tej listy wynikają dwa wnioski. Pierwszy: OpenTofu nie jest już „Terraformem 1.5 na innej licencji”, tylko samodzielnie rozwijanym narzędziem. Drugi, ważniejszy dla tezy tego artykułu: każda taka funkcja zmniejsza odwracalność wyboru. Dopóki używasz wspólnego podzbioru języka, możesz przejść w jedną i drugą stronę. Gdy włączysz szyfrowanie stanu w OpenTofu, którego Terraform nie obsługuje, albo zbudujesz procesy na funkcjach dostępnych tylko w HCP Terraform, powrót staje się osobnym projektem.

Co przejęcie HashiCorp przez IBM zmienia dla użytkownika Terraform?

IBM ogłosił zamiar przejęcia HashiCorp 24 kwietnia 2024 roku, oferując 35 dolarów za akcję w gotówce, co dawało wartość przedsiębiorstwa 6,4 mld dolarów. Transakcja została zamknięta 27 lutego 2025 roku, po zgodach regulatorów, w tym amerykańskiej FTC i brytyjskiego CMA. IBM zapowiedział, że Terraform i Vault będą dostępne w ramach jego portfolio oprogramowania do automatyzacji.

Dla zespołu, który po prostu używa Terraform CLI, w krótkim terminie zmieniło się niewiele. Plik licencji w repozytorium wskazuje dziś jako licencjodawcę International Business Machines Corporation, ale warunki BSL pozostały takie same, a grant użycia odwołuje się teraz do płatnych wersji IBM. Nie ma sygnałów powrotu do MPL, choć po przejęciu część społeczności na to liczyła.

Pojawił się natomiast inny sygnał, który warto odnotować przy planowaniu na lata: porządkowanie portfolio. Projekt CDK for Terraform (CDKTF), pozwalający pisać konfigurację Terraform w TypeScript, Pythonie czy Javie, został wygaszony i zarchiwizowany 10 grudnia 2025 roku. README projektu zaleca migrację do standardowego HCL (z pomocą cdktf synth --hcl), a użytkownikom związanym z AWS — przejście na AWS CDK. Zespoły, które wybrały CDKTF jako „Terraform dla programistów”, musiały w ciągu kilku miesięcy zaplanować migrację, na którą nie miały budżetu.

Nie wynika z tego, że Terraform jest zagrożony. To dojrzały, szeroko stosowany produkt, wokół którego IBM buduje ofertę dla dużych klientów. Wynika natomiast, że ryzyko dostawcy w IaC to nie tylko licencja, ale też kierunek rozwoju produktu i jego dodatków. Rdzeń narzędzia i HCL są bezpieczne w obu projektach. Najbardziej narażone są warstwy wokół: platformy zarządzane, eksperymentalne SDK, funkcje dostępne tylko w płatnym planie. Projektuj tak, żeby to, co trudno wymienić, było jak najmniejsze.

Terraform czy OpenTofu: jak podjąć decyzję w jedno popołudnie?

Skoro oba narzędzia czytają ten sam język, korzystają z tych samych dostawców i mają zbliżony model pracy, decyzja sprowadza się do kilku pytań o kontekst organizacji, a nie o technologię. Poniższa tabela zbiera kryteria, które warto przejść na jednym spotkaniu z udziałem lidera DevOps, architekta i osoby odpowiedzialnej za zgodność.

KryteriumWskazuje na TerraformWskazuje na OpenTofu
Platforma uruchomieniowaUżywasz lub planujesz HCP Terraform albo Terraform EnterpriseUżywasz własnego potoku CI/CD lub platformy niezależnej od HashiCorp/IBM
Polityka licencyjnaBSL jest akceptowana przez dział prawnyWymagana licencja zatwierdzona przez OSI (OpenTofu jest na MPL 2.0)
Model biznesowyZarządzasz wyłącznie własną infrastrukturąOferujesz usługi zarządzania infrastrukturą klientom albo budujesz na IaC własny produkt
Wsparcie komercyjnePotrzebujesz umowy wsparcia z producentem narzędziaWystarczy wsparcie fundacji, społeczności i niezależnych dostawców platform
Wymagane funkcjePotrzebujesz integracji tylko w ekosystemie HCP (np. Sentinel, zarządzanie workspace’ami w chmurze producenta)Potrzebujesz szyfrowania stanu po stronie klienta, rejestrów OCI w sieci odciętej od internetu
Zespół i rynek pracyRekrutujesz osoby ze znajomością Terraform (to samo HCL)Jak obok: umiejętności przenoszą się niemal w całości
OdwracalnośćZachowasz ją, unikając funkcji tylko z HCPZachowasz ją, odkładając szyfrowanie stanu do świadomej decyzji

Jak czytać tę tabelę? Jeśli Twoja organizacja kupuje lub zamierza kupić HCP Terraform albo Terraform Enterprise, wybór jest prosty: zostań przy Terraform, bo cała wartość tych platform zakłada jego użycie. Jeśli nie kupujesz platformy producenta, a potok budujesz sam (GitHub Actions, GitLab CI, Atlantis, platforma zewnętrzna), OpenTofu jest rozsądnym ustawieniem domyślnym: ma otwartą licencję, neutralną fundację i funkcje bezpieczeństwa stanu, które przy samodzielnie zarządzanym backendzie mają realną wartość.

Ta rekomendacja jest celowo wyraźna, bo spotkania „Terraform czy OpenTofu” mają skłonność do ciągnięcia się tygodniami. Tymczasem z perspektywy pliku stanu, modułów i procesu przeglądu kodu różnica jest dziś niewielka. Ważniejsze jest, żeby zapisać decyzję wraz z uzasadnieniem w rejestrze decyzji architektonicznych (ADR), określić warunki jej rewizji (np. zmiana licencji, zakup platformy, wymóg audytu) i przejść do rzeczy, które naprawdę trudno później zmienić.

Jeden praktyczny warunek: przypnij wersje. Niezależnie od wyboru ustaw w kodzie wymaganą wersję narzędzia i dostawców, commituj plik blokady dostawców (.terraform.lock.hcl) i aktualizuj je świadomie, a nie przy okazji. Większość niespodzianek przy migracji między narzędziami i między wersjami wynika z nieprzypiętych wersji, a nie z różnic licencyjnych.

Kiedy Pulumi, AWS CDK albo CloudFormation są lepszym wyborem niż HCL?

Dyskusja Terraform kontra OpenTofu przesłania fakt, że nie są to jedyne opcje. Zanim zespół zdecyduje się na HCL, warto uczciwie sprawdzić trzy alternatywy.

Pulumi pozwala pisać infrastrukturę w językach ogólnego przeznaczenia: TypeScript, JavaScript, Python, Go, .NET, Java oraz w YAML. Jest dostępny na licencji Apache 2.0. Sprawdza się tam, gdzie infrastrukturę piszą głównie programiści aplikacji, którzy chcą testów jednostkowych, prawdziwych pętli i abstrakcji z bibliotek. Pulumi też ma stan i trzeba o niego zadbać: domyślnym backendem jest Pulumi Cloud, ale można przechowywać stan w S3, Azure Blob Storage, Google Cloud Storage, PostgreSQL czy lokalnie. Sekrety w stanie są szyfrowane wybranym dostawcą szyfrowania niezależnie od backendu, co jest różnicą na plus wobec domyślnego zachowania Terraform.

AWS CDK to framework do definiowania infrastruktury w TypeScript, JavaScript, Pythonie, Javie, C# i Go, który generuje szablony CloudFormation i wdraża je przez tę usługę. Zaleta: stan i wycofywanie zmian po błędzie obsługuje CloudFormation, więc zespół nie zarządza plikiem stanu samodzielnie. Wada: działa wyłącznie dla AWS, a usługi SaaS, DNS u innego dostawcy czy klastry poza AWS wymagają osobnego narzędzia.

CloudFormation, Azure Bicep i podobne narzędzia natywne mają sens, gdy organizacja jest związana z jedną chmurą i chce, żeby to dostawca chmury przechowywał stan. Płacisz za to przenośnością i ograniczeniem do jednego ekosystemu.

Kryterium rozstrzygające jest zwykle jedno: kto będzie utrzymywał ten kod za trzy lata. Deklaratywny HCL ma ograniczoną ekspresję i to jest jego zaleta w przeglądzie: plan pokazuje, co się zmieni, a recenzent nie musi śledzić logiki programu, żeby zrozumieć wynik. Kod Pulumi czy CDK jest bardziej elastyczny, ale ta elastyczność wymaga dyscypliny inżynierskiej, której zespoły infrastrukturalne nie zawsze mają czas pilnować. Historia CDKTF pokazuje też, że warstwy „język programowania nad innym narzędziem” niosą dodatkowe ryzyko wygaszenia.

Jeśli w organizacji powstaje zespół platformowy, który będzie dostarczał gotowe moduły innym zespołom, podejście platform engineering dobrze łączy się z HCL: platforma publikuje przetestowane moduły, a zespoły produktowe składają z nich swoje środowiska bez pisania niskopoziomowych zasobów.

Gdzie trzymać stan i jak go zablokować przed równoczesnym zapisem?

Lokalny plik terraform.tfstate na laptopie jest dopuszczalny wyłącznie w eksperymentach. W pierwszym dniu prawdziwej pracy stan musi trafić do zdalnego backendu, który spełnia cztery warunki: obsługuje blokadę zapisu, wersjonuje kolejne wersje pliku, szyfruje dane w spoczynku i pozwala precyzyjnie ograniczyć dostęp.

W AWS standardem jest backend S3. Przez lata blokadę realizowała osobna tabela DynamoDB, co było częstym źródłem błędów konfiguracji („mamy bucket, tabelę dodamy później”). To się zmieniło. Od Terraform 1.11.0 z 27 lutego 2025 roku natywna blokada w S3 przez argument use_lockfile jest ogólnie dostępna, a argumenty związane z DynamoDB są oznaczone jako przestarzałe; dokumentacja zapowiada ich usunięcie w przyszłej wersji. Blokada tworzy obok pliku stanu plik z rozszerzeniem .tflock. OpenTofu wprowadził natywną blokadę w S3 w wersji 1.10 z czerwca 2025 roku. Ważny szczegół: w dokumentacji Terraform blokada w S3 jest opcjonalna i domyślnie wyłączona, więc trzeba ją jawnie włączyć.

Minimalna konfiguracja zdrowego backendu w AWS wygląda tak:

terraform {
  backend "s3" {
    bucket       = "firma-iac-state-prod"
    key          = "network/terraform.tfstate"
    region       = "eu-central-1"
    encrypt      = true
    kms_key_id   = "arn:aws:kms:eu-central-1:111122223333:key/..."
    use_lockfile = true
  }
}

Do tego bucket z włączonym wersjonowaniem (żeby móc wrócić do poprzedniej wersji stanu po uszkodzeniu), blokadą publicznego dostępu, polityką dostępu ograniczoną do roli potoku CI/CD i małej grupy administratorów oraz z kopią w innym regionie lub koncie, jeśli wymaga tego plan ciągłości działania. Dane uwierzytelniające nie powinny trafiać do bloku backendu ani do parametrów -backend-config, bo dokumentacja ostrzega, że mogą wtedy wylądować w katalogu .terraform i w plikach planu.

W Azure analogiczną rolę pełni backend azurerm z blokadą przez dzierżawę obiektu blob, w Google Cloud — backend gcs. Alternatywą są platformy zarządzane: HCP Terraform (rozliczany od liczby zarządzanych zasobów) albo niezależni dostawcy, którzy obsługują zarówno Terraform, jak i OpenTofu. Platforma zdejmuje z zespołu część pracy, ale przenosi stan do zewnętrznej firmy, co trzeba uwzględnić w ocenie ryzyka dostawcy.

Najważniejsza zasada, niezależnie od backendu: apply na środowiskach współdzielonych uruchamia potok, a nie człowiek. Inżynierowie mogą uruchamiać plan lokalnie z uprawnieniami tylko do odczytu, ale zapis stanu i zmiany w chmurze przechodzą przez proces z przeglądem i śladem audytowym. To jedna reguła, która eliminuje większość scenariuszy z początku tego artykułu.

Jak podzielić stan, żeby jeden błąd nie dotykał całej firmy?

Najczęstszy błąd zespołów, które zaczynają od entuzjazmu: jeden wielki stan dla całej infrastruktury. Na początku jest wygodnie, bo wszystko widać w jednym planie. Po roku plan trwa kilkanaście minut, każdy apply dotyka setek zasobów, blokada stanu sprawia, że zespoły czekają na siebie nawzajem, a pomyłka w jednym module może zaplanować zniszczenie zasobów, których autor zmiany w ogóle nie dotykał.

Dobry podział stanu kieruje się dwiema zasadami. Pierwsza to promień rażenia (blast radius): ile może się zepsuć w wyniku jednej błędnej zmiany. Druga to tempo zmian: zasoby zmieniane codziennie nie powinny dzielić stanu z zasobami zmienianymi raz na kwartał. W praktyce daje to podział w dwóch wymiarach:

  • Środowiska: osobny stan dla produkcji, stagingu i środowisk deweloperskich, najlepiej w osobnych kontach lub subskrypcjach chmurowych, z osobnymi uprawnieniami. Pomyłka na stagingu nie może fizycznie dotknąć produkcji.
  • Warstwy: fundament (konta, sieć, DNS, tożsamość), platforma (klastry, bazy danych, kolejki), aplikacje (usługi poszczególnych zespołów). Fundament zmienia się rzadko i wymaga najwęższego dostępu, aplikacje zmieniają się często i mogą należeć do zespołów produktowych.

Podział rodzi pytanie, jak warstwy mają się ze sobą komunikować, skoro aplikacja potrzebuje identyfikatora sieci z warstwy fundamentu. Najprostsza odpowiedź, źródło danych terraform_remote_state, ma poważną wadę. Dokumentacja Terraform zaznacza, że użytkownik tego mechanizmu musi mieć dostęp do całego snapshotu stanu, który często zawiera informacje poufne, a odczyt wyjść daje w praktyce dostęp do całego pliku. Rekomendowana alternatywa to jawne publikowanie wspólnych danych w osobnym miejscu: w AWS Systems Manager Parameter Store, w obiektach w buckecie, w rekordach DNS czy w ConfigMapach Kubernetesa, z własną kontrolą dostępu. Zespół aplikacyjny dostaje wtedy identyfikator sieci, ale nie dostaje stanu fundamentu.

Ile stanów to za dużo? Nie ma uniwersalnej liczby. Sygnałem, że podział jest zbyt drobny, jest sytuacja, w której jedna zmiana biznesowa wymaga skoordynowanego apply w pięciu stanach w ściśle określonej kolejności. Sygnałem, że jest zbyt gruby, jest plan, którego nikt nie czyta do końca, bo ma kilkaset linii. Narzędzia takie jak Terragrunt czy Terramate pomagają zarządzać wieloma stanami, ale nie zastąpią decyzji o tym, gdzie przebiegają granice.

Jak chronić sekrety, skoro stan przechowuje je jawnym tekstem?

Przez większość historii Terraform odpowiedź brzmiała: „chroń stan, bo sekretów z niego nie usuniesz”. Hasło do bazy danych przekazane w zasobie aws_db_instance lądowało w stanie, nawet jeśli pochodziło z menedżera sekretów. Jedyną obroną było szyfrowanie backendu i wąski dostęp.

W latach 2024–2025 sytuacja zmieniła się w obu narzędziach, ale różnymi drogami.

Terraform wprowadził w wersji 1.10 wartości ulotne: argument ephemeral dla zmiennych i wyjść modułów oraz blok ephemeral, który pobiera dane (np. sekret z menedżera sekretów) tylko na czas wykonania, bez zapisywania ich w stanie i planie. Wersja 1.11 dodała argumenty tylko do zapisu (write-only) w zasobach zarządzanych, zwykle z przyrostkiem _wo i towarzyszącym _wo_version, które przekazują wartość do dostawcy bez jej utrwalania. Warunek: dostawca musi obsługiwać takie argumenty dla danego zasobu.

OpenTofu poszedł najpierw inną drogą: w wersji 1.7 z kwietnia 2024 roku dodał szyfrowanie całego stanu i planów po stronie klienta, z kluczami z PBKDF2 (hasło), AWS KMS, GCP KMS, Azure Key Vault, OpenBao albo zewnętrznego programu. Szyfrowanie działa niezależnie od backendu, więc nawet ktoś z dostępem do bucketu widzi tylko zaszyfrowany plik. W wersji 1.11 z grudnia 2025 roku OpenTofu dodał też zasoby ulotne i atrybuty tylko do zapisu.

Szyfrowanie stanu w OpenTofu ma koszt, który dokumentacja opisuje uczciwie: bez właściwego klucza stan i plany stają się nieodzyskiwalne. Trzeba mieć kopię zapasową kluczy, przetestowany plan odtworzenia i tymczasową niezaszyfrowaną kopię stanu na czas wdrożenia. Migracja istniejącego projektu wymaga metody unencrypted i bloku fallback, a zmiana nazw dostawców kluczy po zaszyfrowaniu jest zabroniona. To mechanizm dla zespołu, który ma dojrzałe zarządzanie kluczami, a nie pierwszy krok w projekcie, w którym nikt jeszcze nie wie, kto odpowiada za KMS.

Rekomendowana kolejność dla zespołu, który zaczyna:

  1. Zdalny backend z szyfrowaniem w spoczynku i dostępem ograniczonym do potoku oraz kilku osób.
  2. Sekrety w menedżerze sekretów (AWS Secrets Manager, Azure Key Vault, HashiCorp Vault, OpenBao), nigdy w plikach .tfvars w repozytorium.
  3. Wartości ulotne i argumenty tylko do zapisu wszędzie, gdzie dostawca je obsługuje, zwłaszcza dla haseł baz danych i tokenów.
  4. Szyfrowanie stanu po stronie klienta w OpenTofu jako świadoma decyzja po ustaleniu procedur zarządzania kluczami.

Bezpieczeństwo IaC nie kończy się na stanie: skanowanie konfiguracji pod kątem błędnych ustawień i przegląd uprawnień ról potoku to elementy szerszej praktyki, którą w naszym modelu dojrzałości opisujemy w wymiarze bezpieczeństwa. Jeśli chcesz ocenić, gdzie jest dziś Twoja organizacja, skorzystaj z modelu dojrzałości DevOps z checklistą samooceny.

Jak przejąć istniejącą infrastrukturę, zamiast budować wszystko od zera?

Niemal każda firma, która „zaczyna IaC”, ma już działające środowiska założone ręcznie w konsoli, skryptami albo przez poprzedni zespół. Kusi, żeby zostawić je w spokoju i budować nowe środowisko od zera, „porządnie”. To często błąd: nowe środowisko powstaje, stare dalej działa, a firma ma teraz dwie infrastruktury, z których tylko jedna jest w kodzie, a ruch produkcyjny obsługuje druga.

Dlatego bronimy tezy, że pierwszym projektem IaC powinno być przejęcie istniejącego komponentu, a nie budowa nowego. Od Terraform 1.5.0 z 12 czerwca 2023 roku narzędzie ma bloki import, które deklarują w kodzie, że dany obiekt w chmurze ma zostać przejęty pod określony adres. Import jest planowalny: terraform plan pokazuje, co zostanie zaimportowane, zanim cokolwiek trafi do stanu. Flaga -generate-config-out pozwala wygenerować bloki zasobów dla importowanych obiektów, które nie mają jeszcze konfiguracji; dokumentacja zaleca przegląd i ręczną poprawę tak wygenerowanego kodu. OpenTofu od wersji 1.7 obsługuje importy w pętli, co upraszcza przejmowanie dziesiątek podobnych zasobów.

Praktyczny przebieg przejęcia jednego komponentu wygląda tak:

  1. Wybierz komponent o niskim ryzyku i wyraźnych granicach, na przykład buckety z zasobami statycznymi albo sieć środowiska testowego. Nie zaczynaj od produkcyjnej bazy danych.
  2. Zinwentaryzuj zasoby z identyfikatorami, które będą potrzebne w blokach import.
  3. Wygeneruj konfigurację, a potem ją przepisz: nazwy, zmienne, moduły. Wygenerowany kod jest punktem wyjścia, nie produktem.
  4. Doprowadź do pustego planu. Komponent jest przejęty dopiero wtedy, gdy plan po imporcie nie pokazuje żadnych zmian. Każda różnica to albo błąd w kodzie, albo dryf, który trzeba świadomie rozstrzygnąć.
  5. Zablokuj ręczne zmiany dla tego komponentu: odbierz uprawnienia zapisu w konsoli wszystkim poza procedurą awaryjną.

Po przejęciu przychodzi refaktoryzacja, i tu przydają się bloki moved (zmiana adresu zasobu w kodzie bez jego niszczenia) oraz removed (usunięcie zasobu ze stanu bez usuwania go z chmury). OpenTofu 1.12 dodał jeszcze meta-argument destroy = false, który robi to samo deklaratywnie z poziomu cyklu życia zasobu. Dzięki tym mechanizmom porządkowanie struktury modułów nie wymaga ręcznych operacji state mv, które są jednym z głównych źródeł uszkodzonych stanów.

Przejmowanie istniejącej infrastruktury jest też naturalnym etapem projektów migracji. Jeśli właśnie wybierasz partnera do przeniesienia systemów do chmury, warto w zakresie zlecenia wprost zapisać, że wynikiem ma być infrastruktura w kodzie z przekazanym stanem; o tym, jak to ująć w umowie i modelu rozliczenia, piszemy w tekście o wyborze partnera do migracji do chmury.

Jak wykrywać dryf i pilnować, żeby nikt nie klikał w konsoli?

Dryf to różnica między tym, co opisuje kod i stan, a tym, co faktycznie istnieje w chmurze. Powstaje z trzech źródeł: ręcznych zmian w konsoli („tylko na chwilę, bo incydent”), zmian wprowadzanych przez inne narzędzia albo samego dostawcę chmury oraz zmian, które ktoś wdrożył z innej gałęzi kodu i nie scalił. Dryf jest groźny, bo następny apply może cofnąć zmianę, od której zależy działanie produkcji, albo zawieść w połowie z powodu konfliktu.

Wykrywanie dryfu nie wymaga drogich narzędzi. Wystarczy zaplanowane zadanie w potoku, które regularnie (np. co noc) uruchamia plan z flagą -detailed-exitcode dla każdego stanu. Kod wyjścia 0 oznacza brak zmian, 1 — błąd, a 2 — plan z różnicami. Kod 2 na gałęzi głównej, na której nikt niczego nie zmieniał, to dryf, który powinien trafić do kanału zespołu jako zgłoszenie do rozstrzygnięcia.

Rozstrzygnięcie ma dwie drogi. Jeśli ręczna zmiana była błędem, apply przywraca stan opisany w kodzie. Jeśli była zamierzona (np. ktoś podczas incydentu zwiększył limit), trzeba ją przenieść do kodu, a stan uzgodnić z rzeczywistością. Do tego służy tryb -refresh-only, który aktualizuje stan i wyjścia, żeby odpowiadały zmianom wprowadzonym poza narzędziem, bez zmieniania infrastruktury. Dokumentacja Terraform ostrzega też przed rutynowym używaniem -target, bo prowadzi do niewykrytego dryfu, oraz przed pomijaniem odświeżania (-refresh=false), bo plan ignoruje wtedy zmiany zewnętrzne.

Technika to połowa sprawy. Druga połowa to zasady dostępu. Jeśli każdy inżynier ma uprawnienia administratora w konsoli produkcyjnej, dryf będzie powstawał szybciej, niż zespół zdąży go usuwać. Dojrzały model wygląda tak: codzienna praca odbywa się z uprawnieniami tylko do odczytu, zmiany przechodzą przez kod i potok, a na wypadek awarii istnieje procedura „rozbicia szyby” (break-glass) z czasowym podniesieniem uprawnień, rejestrowana i rozliczana po incydencie, łącznie z obowiązkiem przeniesienia zmian do kodu w ciągu jednego lub dwóch dni.

Te zasady są równie ważne jak wybór narzędzia, a w wielu organizacjach trudniejsze, bo zmieniają przyzwyczajenia ludzi. Właśnie dlatego tak dużo zależy od kompetencji osób, które wdrażają IaC. Przy rekrutacji albo ocenie inżynierów warto sprawdzić nie tylko znajomość HCL, ale też to, jak kandydat podchodzi do stanu, dryfu i uprawnień; listę takich pytań znajdziesz w artykule o ocenie umiejętności inżyniera DevOps.

Jak wygląda plan na pierwsze 90 dni z infrastrukturą jako kod?

Teoria jest przydatna, ale lider DevOps potrzebuje planu, który da się przedstawić zespołowi i przełożonym. Poniżej propozycja na pierwszy kwartał dla organizacji, która ma środowiska w jednej lub dwóch chmurach i niewielką część infrastruktury w kodzie.

OkresCelKonkretne wynikiKryterium zakończenia
Tydzień 1–2Decyzje fundamentalneADR: narzędzie (Terraform lub OpenTofu), backend stanu, podział stanu, model uprawnieńDecyzje zapisane i zaakceptowane przez architekta i bezpieczeństwo
Tydzień 2–3Fundament stanuBucket/kontener ze stanem: wersjonowanie, szyfrowanie, blokada, kopia, polityka dostępuTest: równoczesne apply z dwóch miejsc zostaje zablokowane
Tydzień 3–4Potokplan w każdym pull requeście, apply tylko z gałęzi głównej przez potok, przypięte wersjeŻaden apply na współdzielonym środowisku nie pochodzi z laptopa
Tydzień 4–7Pierwsze przejęcieJeden komponent o niskim ryzyku zaimportowany, kod przepisany na modułyPlan po imporcie jest pusty, ręczne uprawnienia zapisu odebrane
Tydzień 7–10Sekrety i dryfSekrety w menedżerze sekretów, wartości ulotne tam, gdzie to możliwe, nocne wykrywanie dryfuBrak sekretów w repozytorium i w nowych wersjach stanu, raport dryfu trafia do zespołu
Tydzień 10–13SkalowanieKolejne komponenty według ryzyka, procedura break-glass, szkolenie zespołów produktowychProcent zasobów produkcyjnych w kodzie mierzony i raportowany co miesiąc

Dwie uwagi do tego planu. Po pierwsze, metryką postępu nie jest liczba linii HCL ani liczba modułów, tylko odsetek zasobów produkcyjnych zarządzanych przez kod przy pustym planie. Tę liczbę da się policzyć, porównując inwentarz chmury z zawartością stanów, i to ona pokazuje, czy firma faktycznie odzyskuje kontrolę. Po drugie, kolejność jest ważniejsza od tempa. Zespół, który w ciągu kwartału przejmie trzy komponenty z pustym planem i zablokowaną konsolą, jest w lepszej sytuacji niż zespół, który napisał czterdzieści modułów do nowego środowiska, z którego nikt jeszcze nie korzysta.

Plan zakłada też, że w zespole jest ktoś, kto już przeprowadzał takie przejęcie. Import, refaktoryzacja z blokami moved i podział stanu to operacje, przy których pomyłka może kosztować dzień pracy albo, w gorszym przypadku, przerwę w działaniu usługi. Jeśli takiej osoby nie ma, rozważ wzmocnienie zespołu na pierwszy kwartał, zamiast uczyć się na produkcji.

Jakie są kluczowe wnioski i od czego zacząć w poniedziałek?

Infrastruktura jako kod jest dziś standardem, a nie eksperymentem, ale wciąż często wdraża się ją od niewłaściwego końca: od wyboru narzędzia i pisania modułów, zamiast od decyzji o stanie i przejęcia tego, co już działa. Licencja BSL, powstanie OpenTofu i przejęcie HashiCorp przez IBM zmieniły rynek narzędzi, ale nie zmieniły tego, co decyduje o sukcesie wdrożenia.

Zapamiętaj sześć rzeczy. Po pierwsze, plik stanu jest najcenniejszym i najbardziej wrażliwym artefaktem IaC: traktuj go jak produkcyjną bazę danych, z kopiami, blokadą, szyfrowaniem i wąskim dostępem. Po drugie, Terraform czy OpenTofu to decyzja na jedno spotkanie: jeśli kupujesz platformę HCP, zostań przy Terraform; jeśli budujesz potok sam, OpenTofu jest rozsądnym ustawieniem domyślnym. Zapisz decyzję w ADR i przejdź dalej. Po trzecie, odwracalność tej decyzji maleje z każdą funkcją specyficzną dla jednego narzędzia, więc wchodź w nie świadomie. Po czwarte, dziel stan według promienia rażenia i tempa zmian, a dane między warstwami publikuj jawnie zamiast udostępniać cały stan. Po piąte, sekrety trzymaj poza stanem dzięki wartościom ulotnym i argumentom tylko do zapisu, a szyfrowanie stanu włączaj dopiero przy dojrzałym zarządzaniu kluczami. Po szóste, zacznij od przejęcia jednego istniejącego komponentu i doprowadź go do pustego planu oraz zablokowanej konsoli.

W poniedziałek zrób jedną rzecz: sprawdź, gdzie dziś leżą wszystkie pliki stanu w Twojej organizacji, kto ma do nich dostęp i czy backend ma włączoną blokadę oraz wersjonowanie. Ta jedna inwentaryzacja zwykle pokazuje więcej niż tygodnie dyskusji o narzędziach.

Jeśli potrzebujesz osób, które przeprowadziły już import, podział stanu i wdrożenie potoku, zobacz, jak pracują inżynierowie DevOps ARDURA. Doświadczonych inżynierów DevOps, którzy pracują z Terraform, Kubernetesem i CI/CD, dostarczamy standardowo w ciągu 2 tygodni, z 2-tygodniową gwarancją bezpłatnej wymiany specjalisty i 30-dniowym okresem wypowiedzenia. Przy projektowaniu struktury kont, sieci i fundamentu pod IaC pomogą też nasi architekci cloud. Jeśli wolisz najpierw porozmawiać o swojej sytuacji, umów rozmowę.