Klikanie wokół konsoli chmurowej jest w porządku w przypadku jednego serwera. Zawodzi, gdy potrzebujesz tej samej konfiguracji w fazie testowej i produkcyjnej lub gdy ktoś pyta, kto zmienił regułę zapory sieciowej w marcu zeszłego roku. Ten samouczek Terraform dla początkujących pokazuje lepszy sposób: opisz swoją infrastrukturę w kodzie i pozwól narzędziu urzeczywistnić ją.

Większość samouczków zaczyna się od konta w chmurze, co zwiększa ryzyko rozliczeniowe, zanim nauczysz się czegokolwiek. Zaczynamy od dostawcy Terraform local, który po prostu tworzy pliki na Twoim komputerze, więc błędy nic nie kosztują. Te przykłady i przykładowe wyniki to standardowe ilustracje, których nie wykonaliśmy na potrzeby tego artykułu, a dokładne sformułowanie różni się w zależności od wersji.

Co to jest Terraforma?

Terraform to narzędzie typu infrastruktura jako kod (IaC) firmy HashiCorp. Piszesz pliki konfiguracyjne w HCL, języku konfiguracyjnym HashiCorp, opisując pożądany efekt końcowy. Następnie Terraform ustala, co utworzyć, zmienić lub usunąć, aby to osiągnąć.

Komunikuje się z platformami za pośrednictwem wtyczek zwanych dostawcami. Istnieją dostawcy AWS, Azure, Google Cloud, Kubernetes, GitHub, Cloudflare i wielu innych, dzięki czemu możesz używać jednego przepływu pracy dla nich wszystkich.

Jedna rzecz, którą warto wiedzieć: w 2023 roku HashiCorp przeniosła Terraform na licencję Business Source. Następnie społeczność stworzyła OpenTofu, rozwidlenie typu open source, które używa bardzo podobnych poleceń i konfiguracji. To, czego się tutaj dowiesz, dotyczy w dużej mierze obu.

Dlaczego infrastruktura jako kod?

Terraforma jest również deklaratywna. Mówisz „powinny być trzy serwery”, a nie „utwórz serwer trzy razy”. Jeśli dwa już istnieją, dodaje jeden. Skrypt, który po prostu powtarza swoje kroki, może zakończyć się utworzeniem trzech kolejnych.

Zainstaluj Terraforma

Zainstaluj go, korzystając z oficjalnych instrukcji HashiCorp dla swojego systemu operacyjnego, a następnie potwierdź, że działa:

terraform -version

Utwórz pusty folder dla projektu. Terraform odczytuje każdy .tf plik w bieżącym folderze, więc jeden folder równa się jednej konfiguracji.

Twoja pierwsza konfiguracja

Utwórz plik o nazwie main.tf:

terraform {
  required_providers {
    local = {
      source  = "hashicorp/local"
      version = "~> 2.5"
    }
  }
}

resource "local_file" "greeting" {
  filename = "${path.module}/hello.txt"
  content  = "Hello from Terraform\n"
}

Spójrz na blok resource, ponieważ prawie wszystko, co piszesz, ma ten kształt. local_file to typ zasobu, a greeting to jego własna nazwa w konfiguracji. Razem tworzą jego adres: local_file.greeting. Argumenty wewnątrz opisują, czego chcesz.

Przepływ pracy: inicjuj, planuj, zastosuj

inicjalizacja terraforma

Spowoduje to przygotowanie folderu i pobranie dostawców, o których prosiłeś. Uruchom go raz na początku i ponownie za każdym razem, gdy dodasz dostawcę lub moduł. Tworzy także plik .terraform.lock.hcl, który rejestruje dokładne wersje dostawców. Zatwierdź ten plik w Git.

terraform init

planu terraformy

To porównuje Twój kod z istniejącym i pokazuje planowane zmiany, nie dotykając niczego:

terraform plan

# local_file.greeting will be created
+ resource "local_file" "greeting" {
    + content  = "Hello from Terraform\n"
    + filename = "./hello.txt"
  }

Plan: 1 to add, 0 to change, 0 to destroy.

Naucz się symboli, bo przeczytasz mnóstwo planów:

stosuje się terraformę

To pokazuje plan ponownie, prosi o potwierdzenie i wprowadza zmiany:

terraform apply

Wpisz yes, a pojawi się hello.txt. Teraz ponownie uruchom terraform plan. Nie powinien zgłaszać żadnych zmian, ponieważ rzeczywistość już pasuje do Twojego kodu. Ta właściwość, w przypadku której wielokrotne uruchamianie nie powoduje dalszych zmian, nazywa się idempotencją.

Zmienianie i niszczenie

Edytuj linię content i uruchom terraform plan. Terraform dostrzega różnicę i proponuje zmianę. W przypadku tego zasobu zastępuje on plik. Zwróć uwagę na wymianę prawdziwej infrastruktury, ponieważ odtworzenie bazy danych może oznaczać utratę danych.

Następnie usuń ręcznie hello.txt i zaplanuj ponownie. Terraform zauważa jego brak i oferuje jego odtworzenie. Różnica między Twoim kodem a rzeczywistością nazywa się dryftem, a jej wykrycie jest jedną z głównych zalet tego narzędzia.

Aby usunąć wszystko, czym zarządza ta konfiguracja, uruchom:

terraform destroy

Zmienne i wyjścia

Wartości zakodowane na stałe uniemożliwiają ponowne użycie kodu. Zmienne wejściowe sprawiają, że konfiguracja jest elastyczna, a dane wyjściowe zwracają przydatne wartości:

# variables.tf
variable "environment" {
  type        = string
  description = "Deployment environment"
  default     = "dev"

  validation {
    condition     = contains(["dev", "staging", "prod"], var.environment)
    error_message = "Use dev, staging or prod."
  }
}

# main.tf
resource "local_file" "config" {
  filename = "${path.module}/${var.environment}.txt"
  content  = "environment=${var.environment}\n"
}

# outputs.tf
output "config_path" {
  value = local_file.config.filename
}

Ustaw wartości w wierszu poleceń lub przechowuj je w pliku o nazwie terraform.tfvars, który jest ładowany automatycznie:

terraform apply -var="environment=staging"

Użycie local_file.config.filename na wyjściu oznacza także sposób, w jaki zasoby odnoszą się do siebie. Terraform odczytuje te odniesienia, aby ustalić właściwą kolejność tworzenia rzeczy.

Stan terraformy

Po zastosowaniu znajdziesz plik o nazwie terraform.tfstate. To jest zapis tego, czym Terraform zarządza, mapując Twój kod na rzeczywiste obiekty. Bez tego Terraform nie wiedziałby, że local_file.greeting to ten konkretny plik.

Liczą się tu trzy zasady:

1. Nigdy nie przekazuj stanu Git. Może zawierać hasła i inne sekrety w postaci zwykłego tekstu.
2. Nie edytuj tego ręcznie. Użyj poleceń takich jak terraform state list i terraform state mv.
3. Używaj zdalnego backendu do projektów zespołowych. Współdzielony backend przechowuje stan centralnie i blokuje go, dzięki czemu dwie osoby nie mogą składać wniosków jednocześnie.

Oto typowy backend wykorzystujący Amazon S3 z wiadrem, które utworzysz wcześniej:

terraform {
  backend "s3" {
    bucket       = "my-company-terraform-state"
    key          = "shop/prod/terraform.tfstate"
    region       = "ap-south-1"
    encrypt      = true
    use_lockfile = true
  }
}

Prawdziwe źródło informacji w chmurze

Przepływ pracy nie zmienia się po przejściu do chmury. Oto wiadro S3 na AWS. Najpierw sprawdź cenę i zniszcz wszystko, co stworzysz podczas ćwiczeń:

provider "aws" {
  region = "ap-south-1"
}

resource "aws_s3_bucket" "reports" {
  bucket = "my-unique-reports-bucket-2026"

  tags = {
    Environment = var.environment
    ManagedBy   = "terraform"
  }
}

Terraform pobiera dane uwierzytelniające z konfiguracji interfejsu CLI AWS lub zmiennych środowiskowych. Nigdy nie zapisuj kluczy dostępu do pliku .tf.

Moduły

Moduł to po prostu folder plików Terraform, który można wywołać za pomocą różnych danych wejściowych. Działa podobnie jak funkcja, umożliwiając jednorazowe zdefiniowanie wzorca i ponowne jego użycie:

project/
  main.tf
  modules/
    reports_bucket/
      main.tf
      variables.tf
      outputs.tf

module "staging_reports" {
  source      = "./modules/reports_bucket"
  environment = "staging"
}

module "prod_reports" {
  source      = "./modules/reports_bucket"
  environment = "prod"
}

Publiczny Terraform Registry również posiada gotowe moduły, ale zanim na nich zaczniesz polegać, przeczytaj je i przypnij wersję. Nie buduj modułów zbyt wcześnie. Poczekaj, aż powtórzysz wzór co najmniej dwa razy.

Bezpieczna praca zespołu

1. Utwórz gałąź i zmień pliki .tf. Jeśli potrzebujesz odświeżenia wiedzy, zobacz nasz samouczek Git dla początkujących.
2. Uruchom terraform fmt i terraform validate.
3. Otwórz żądanie ściągnięcia z załączonymi danymi wyjściowymi terraform plan do sprawdzenia.
4. Po zatwierdzeniu zastosuj zapisany plan z jednego kontrolowanego miejsca, najlepiej z rurociągu.

Zapisanie planu gwarantuje zastosowanie dokładnie tego, co zostało sprawdzone:

terraform plan -out=tfplan
terraform apply tfplan

Pasuje to naturalnie do CI/CD i Akcji GitHub. Terraform zwykle udostępnia klaster, a narzędzia takie jak Kubernetes uruchamiają na nim aplikacje.

Typowe błędy

• Aplikowanie bez czytania planu. Jedna -/+ w bazie danych może być bardzo kosztowną niespodzianką.
• Zapisywanie stanu na jednym laptopie. Jeśli stracisz tego laptopa, Terraform straci kontrolę nad Twoją infrastrukturą.
• Ręczne wprowadzanie zmian w konsoli. Powodują one dryf, a kolejne zastosowanie może je cofnąć.
• Korzystanie z wersji nieprzypiętych. Przypinanie wersji dostawców i modułów, aby aktualizacje odbywały się celowo.
• Korzystanie z jednej ogromnej konfiguracji. Podział według środowiska lub systemu ogranicza szkody wynikające z jakiegokolwiek błędu.

Podsumowanie

Poznałeś już idee stojące za niemal wszystkimi działaniami Terraformu: zadeklaruj zasoby, przejrzyj plan, zastosuj go i chroń stan. Ćwicz z dostawcą local, aż przepływ pracy stanie się naturalny, a następnie zarządzaj jednym małym, rzeczywistym zasobem na koncie bezpłatnego poziomu. Wprowadź zdalny stan i moduły, gdy zaangażowana jest więcej niż jedna osoba lub więcej niż jedno środowisko.

Najczęstsze pytania

Ucz się dalej