Nhấp vào xung quanh bảng điều khiển đám mây là tốt cho một máy chủ. Nó bị hỏng khi bạn cần thiết lập tương tự trong quá trình dàn dựng và sản xuất hoặc khi ai đó hỏi ai đã thay đổi quy tắc tường lửa vào tháng 3 năm ngoái. Hướng dẫn về Terraform dành cho người mới bắt đầu này chỉ cho bạn một cách tốt hơn: mô tả cơ sở hạ tầng của bạn bằng mã và để một công cụ biến nó thành hiện thực.

Hầu hết các hướng dẫn đều bắt đầu bằng tài khoản đám mây, điều này làm tăng thêm rủi ro thanh toán trước khi bạn học được bất kỳ điều gì. Chúng tôi bắt đầu với nhà cung cấp local của Terraform, nhà cung cấp này chỉ tạo các tệp trên máy tính của bạn nên những sai sót sẽ không gây tổn thất gì. Các ví dụ này và kết quả đầu ra mẫu là những minh họa tiêu chuẩn mà chúng tôi không thực hiện cho bài viết này và cách diễn đạt chính xác sẽ khác nhau tùy theo phiên bản.

Terraform là gì?

Terraform là một công cụ cơ sở hạ tầng dưới dạng mã (IaC) của HashiCorp. Bạn viết các tệp cấu hình bằng HCL, Ngôn ngữ cấu hình HashiCorp, mô tả kết quả cuối cùng mà bạn mong muốn. Terraform sau đó sẽ tìm ra những gì cần tạo, thay đổi hoặc xóa để đạt được điều đó.

Nó giao tiếp với các nền tảng thông qua các plugin có tên nhà cung cấp. Có các nhà cung cấp cho AWS, Azure, Google Cloud, Kubernetes, GitHub, Cloudflare và nhiều nhà cung cấp khác, vì vậy bạn có thể sử dụng một quy trình làm việc trên tất cả các nhà cung cấp đó.

Một điều cần biết: vào năm 2023, HashiCorp đã chuyển Terraform sang Giấy phép Nguồn Kinh doanh. Sau đó, cộng đồng đã tạo OpenTofu, một nhánh phân nhánh nguồn mở sử dụng các lệnh và cấu hình rất giống nhau. Những gì bạn học được ở đây phần lớn áp dụng cho cả hai.

Tại sao cơ sở hạ tầng là mã?

Terraform cũng là khai báo. Bạn nói “phải có ba máy chủ”, chứ không phải “tạo một máy chủ ba lần”. Nếu hai đã tồn tại, nó sẽ thêm một. Một tập lệnh chỉ lặp lại các bước của nó có thể tạo ra thêm ba bước nữa.

Cài đặt địa hình

Cài đặt nó bằng cách sử dụng hướng dẫn chính thức của HashiCorp dành cho hệ điều hành của bạn và sau đó xác nhận rằng nó hoạt động:

terraform -version

Tạo một thư mục trống cho dự án. Terraform đọc mọi tệp .tf trong thư mục hiện tại, vì vậy một thư mục tương đương với một cấu hình.

Cấu hình đầu tiên của bạn

Tạo một tệp có tên 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"
}

Hãy nhìn vào khối resource, vì hầu hết mọi thứ bạn viết đều theo hình dạng này. local_file là loại tài nguyên và greeting là tên riêng của bạn cho loại tài nguyên đó trong cấu hình. Cùng nhau, họ tạo thành địa chỉ của nó: local_file.greeting. Các đối số bên trong mô tả những gì bạn muốn.

Quy trình làm việc: khởi tạo, lập kế hoạch, áp dụng

địa hình ban đầu

Việc này sẽ chuẩn bị thư mục và tải xuống các nhà cung cấp mà bạn yêu cầu. Chạy nó một lần khi bắt đầu và chạy lại bất cứ khi nào bạn thêm nhà cung cấp hoặc mô-đun. Nó cũng tạo một tệp .terraform.lock.hcl, ghi lại các phiên bản chính xác của nhà cung cấp. Cam kết tập tin đó với Git.

terraform init

kế hoạch địa hình

Điều này so sánh mã của bạn với những gì tồn tại và hiển thị các thay đổi theo kế hoạch mà không cần chạm vào bất cứ điều gì:

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.

Tìm hiểu các ký hiệu, bởi vì bạn sẽ đọc được rất nhiều kế hoạch:

áp dụng địa hình

Điều này hiển thị lại kế hoạch, yêu cầu xác nhận và thực hiện các thay đổi:

terraform apply

Nhập yes và hello.txt xuất hiện. Bây giờ hãy chạy lại terraform plan. Nó sẽ báo cáo không có thay đổi nào vì thực tế đã khớp với mã của bạn. Thuộc tính này, khi việc chạy nó nhiều lần sẽ không gây ra thay đổi nào nữa, được gọi là idempotence.

Thay đổi và phá hủy

Chỉnh sửa dòng content và chạy terraform plan. Terraform nhận ra sự khác biệt và đề xuất thay đổi. Đối với tài nguyên này, nó thay thế tệp. Hãy chú ý đến những thay thế trên cơ sở hạ tầng thực, vì việc tạo lại cơ sở dữ liệu có thể đồng nghĩa với việc mất dữ liệu.

Tiếp theo, xóa hello.txt bằng tay và lập kế hoạch lại. Terraform nhận thấy nó bị thiếu và đề nghị tạo lại nó. Sự khác biệt giữa mã của bạn và thực tế được gọi là drift và việc phát hiện nó là một trong những lợi ích chính của công cụ.

Để xóa mọi thứ mà cấu hình này quản lý, hãy chạy:

terraform destroy

Các biến và đầu ra

Các giá trị được mã hóa cứng ngăn bạn sử dụng lại mã. Các biến đầu vào làm cho cấu hình trở nên linh hoạt và kết quả đầu ra báo cáo lại các giá trị hữu ích:

# 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
}

Đặt giá trị trên dòng lệnh hoặc giữ chúng trong tệp có tên terraform.tfvars, tệp này được tải tự động:

terraform apply -var="environment=staging"

Sử dụng local_file.config.filename trong đầu ra cũng là cách các tài nguyên tham chiếu lẫn nhau. Terraform đọc những tài liệu tham khảo đó để tìm ra thứ tự chính xác để tạo ra mọi thứ.

Trạng thái địa hình

Sau khi đăng ký, bạn sẽ tìm thấy một tệp có tên terraform.tfstate. Đây là bản ghi của Terraform về những gì nó quản lý, ánh xạ mã của bạn tới các đối tượng thực. Không có nó, Terraform sẽ không biết rằng local_file.greeting là tệp cụ thể đó.

Ba quy tắc quan trọng ở đây:

1. Không bao giờ cam kết trạng thái với Git. Nó có thể chứa mật khẩu và các bí mật khác ở dạng văn bản thuần túy.
2. Không chỉnh sửa bằng tay. Sử dụng các lệnh như terraform state list và terraform state mv.
3. Sử dụng chương trình phụ trợ từ xa cho các dự án nhóm. Chương trình phụ trợ dùng chung lưu trữ trạng thái tập trung và khóa nó để hai người không thể đăng ký cùng một lúc.

Đây là một chương trình phụ trợ điển hình sử dụng Amazon S3, với nhóm bạn tạo trước:

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

Tài nguyên đám mây thực sự

Quy trình làm việc không thay đổi khi bạn chuyển sang đám mây. Đây là nhóm S3 trên AWS. Trước tiên hãy kiểm tra giá và hủy mọi thứ bạn tạo trong khi thực hành:

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

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

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

Terraform nhận thông tin xác thực từ các biến môi trường hoặc thiết lập AWS CLI của bạn. Không bao giờ ghi khóa truy cập vào tệp .tf.

Mô-đun

Một mô-đun chỉ đơn giản là một thư mục chứa các tệp Terraform mà bạn có thể gọi bằng các đầu vào khác nhau. Nó hoạt động giống như một hàm, cho phép bạn xác định một mẫu một lần và sử dụng lại nó:

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"
}

Sổ đăng ký Terraform công khai cũng có các mô-đun được tạo sẵn nhưng hãy đọc chúng trước khi bạn dựa vào chúng và ghim phiên bản. Đừng xây dựng mô-đun quá sớm. Đợi cho đến khi bạn lặp lại một mẫu ít nhất hai lần.

Quy trình làm việc nhóm an toàn

1. Tạo một nhánh và thay đổi tệp .tf. Hãy xem Hướng dẫn về Git dành cho người mới bắt đầu của chúng tôi nếu bạn cần ôn lại.
2. Chạy terraform fmt và terraform validate.
3. Mở một yêu cầu kéo, có đính kèm đầu ra terraform plan để xem xét.
4. Sau khi được phê duyệt, hãy áp dụng kế hoạch đã lưu đó từ một nơi được kiểm soát, lý tưởng nhất là một đường ống.

Việc lưu kế hoạch sẽ đảm bảo bạn áp dụng chính xác những gì đã được xem xét:

terraform plan -out=tfplan
terraform apply tfplan

Điều này tự nhiên phù hợp với CI/CD và Hành động GitHub. Terraform thường cung cấp cụm và các công cụ như Kubernetes sẽ chạy các ứng dụng trên cụm đó.

Những lỗi thường gặp

• Đăng ký mà không cần đọc kế hoạch. Một -/+ trên cơ sở dữ liệu có thể là một bất ngờ rất tốn kém.
• Giữ trạng thái trên một máy tính xách tay. Mất máy tính xách tay đó và Terraform sẽ mất dấu vết cơ sở hạ tầng của bạn.
• Thực hiện các thay đổi thủ công trên bảng điều khiển. Chúng gây ra hiện tượng lệch và lần áp dụng tiếp theo có thể hoàn tác chúng.
• Sử dụng các phiên bản đã bỏ ghim. Ghim các phiên bản mô-đun và nhà cung cấp để việc nâng cấp diễn ra có mục đích.
• Sử dụng một cấu hình lớn. Việc phân chia theo môi trường hoặc hệ thống sẽ hạn chế thiệt hại do bất kỳ sai sót nào.

Lời kết

Bây giờ bạn đã thấy các ý tưởng đằng sau gần như tất cả công việc của Terraform: khai báo tài nguyên, xem xét kế hoạch, áp dụng kế hoạch và bảo vệ trạng thái. Thực hành với nhà cung cấp local cho đến khi quy trình làm việc trở nên tự nhiên, sau đó quản lý một tài nguyên thực nhỏ trong tài khoản cấp miễn phí. Đưa trạng thái và mô-đun từ xa vào khi có nhiều người hoặc nhiều môi trường tham gia.

Câu hỏi thường gặp

Tiếp tục học hỏi