+1

Terraform Series - Phần 2 - Terraform CLI

Cài đặt Terraform

Hashicorp distribute Terraform như một binary package. Vì thế mình có thể cài đặt thông qua cách sử dụng các package manager, hoặc cài đặt manual. Mình sẽ giới thiệu một số cách cài đặt phổ biến.

Homebrew trên MacOS

  • Cài đặt HashiCorp tab package

    	brew tap hashicorp/tap
    
  • Cài đặt Terraform CLI package

    brew install hashicorp/tap/terraform
    
  • Update latest version Terraform

    brew update
    brew upgrade hashicorp/tap/terraform
    
  • Kiểm tra cài đặt

    terraform -help
    

Chocolatey trên Windows

  • Cài đặt Terraform CLI package

    choco install terraform
    
  • Kiểm tra cài đặt

    terraform -help
    

Ubuntu/Debian

  • Cập nhật hệ thống, và các packages liên quan để chuẩn bị cho phần cài đặt terraform

    sudo apt-get update && sudo apt-get install -y gnupg software-properties-common curl
    
  • Thêm HashiCorp GPG key

    curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
    
  • Tải về HashiCorp Linux repository

    sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
    
  • Cài đặt Terraform CLI package

    sudo apt-get update && sudo apt-get install terraform
    
  • Kiểm tra cài đặt

    terraform -help
    

Ngoài ra còn có các cách cài đặt thủ công khác. Xem chi tiết tại: Terraform CLI Install

Terraform CLI Commands

Để xem danh sách các commands có trong terraform có thể dùng cmd terraform -help . Kết quả sẽ như sau:

Terraform Init

  • Đây là một lệnh bắt buộc cần thực hiện đầu tiên để khởi tạo một Terraform Project.

  • Sau khi cài đặt Terraform CLI, mình tiến hành tạo thư mục Root cho project, tạo file main.tf và tiến hành thêm một số config vào. Mình chưa cần quan tâm nội dung chi tiết của file.

    //main.tf
    
    terraform {
      required_providers {
        aws = {
          source  = "hashicorp/aws"
          version = "~> 3.0"
        }
      }
    }
    # Configure the AWS Provider
    provider "aws" {
      region = "us-east-1"
    }
    # Create a VPC
    resource "aws_vpc" "example" {
      cidr_block = "10.0.0.0/16"
    }
    
  • Tiến hành run CMD

    terraform init
    
  • Khi thực thi lệnh Terraform sẽ tiến hành các bước sau:

    1. Đầu tiên, Terraform sẽ đọc configuration file (file main). Với những plugins được sử dụng sẽ tiến hành cài đặt (AWS 3.55 provider)
    2. Create log file để ghi lại version đã down của plugins
    3. Cuối cùng là tải xuống các external modules để sử dụng trong Terraform template. Lúc này khi kiểm tra thư mục Root, mình sẽ thấy xuất hiện thêm file .terraform.lock.hcl và thư mục .terraform. Trong đó file lock dùng để ghi lại version plugins như mình nói ở trên. Thư mục .terraform chưa các modules đã pull về.

Terraform Validate

  • CMD

    terraform validate
    
  • CMD validate sẽ tiến hành kiểm tra tất cả các Terraform configuration để đảm bảo rằng toàn bộ syntax đều chính xác. Thường sử dụng sau khi configuration files được sửa chữa để kiểm tra hợp lệ.

  • Nếu toàn bộ các configs đều đúng syntax, sẽ nhận được log như sau:

  • Trong trường hợp sai syntax, hệ thống sẽ báo lỗi và chỉ định chỗ lỗi cụ thể:

Terraform Plan

  • CMD

    terraform plan
    
  • CMD plan là một dry-run command, khi thực thi terraform sẽ cấp cho mình một execution plan, có highlight các thay đổi để mình có thể xác định được các thay đổi trong configuration.

  • Execution Plan sẽ bao gồm 3 loại dữ liệu.

    1. Những gì ta đã chỉnh sửa trong Terraform templates
    2. Terraform state file hiện tại
    3. Những thay đổi thực tế trong infrastructure provider
  • Ví dụ kết quả sau khi run plan cmd

Terraform Apply

  • CMD

    terraform apply
    
  • Trong trường hợp chưa run CMD plan trước khi run cmd apply. Terraform sẽ tự động rerun plan và mình cần xác nhận đồng ý với execution plan mới có thể tiến hành apply.

  • Nếu mọi thứ đều hợp lệ và execution plan được approved, Terraform sẽ không lưu lại trạng thái trước khi apply để có thể rollback mà sẽ tuân theo plan mà tiến hành apply. Nếu cần rollback lại trạng thái trước đó, mình cần sử dụng thêm các công cụ Source Control như Git để có thể convert lại trạng thái của các configuration files trước đó và tiến hành apply lại.

  • Mặc định, apply CMD sẽ luôn yêu cầu confirm trước khi thực hiện apply để bảo đảm ta đã approve với execution plan. Mình có thể bypass step này bằng cách gắn thêm parameter “auto-approve” vào CMD

    terraform apply -auto-approve
    

Terraform Destroy

  • CMD

    terraform destroy
    
  • Destroy CMD là lệnh dùng destroy các provided, vì vậy cần cẩn thận và hiểu rõ ý nghĩa những việc đang thực hiện khi sử lệnh này đặc biệt là trên môi trường production.

  • Mặc định, tương tư như apply, destroy CMD sẽ luôn yêu cầu confirm trước khi thực hiện để mình xác nhận lại lần nữa những việc đang làm. Mình có thể bypass step này bằng cách gắn thêm parameter “auto-approve” vào CMD

    terraform destroy -auto-approve
    

Kết bài

Ở phần 2, mình tập trung giới thiệu cách cài đặt Terraform CLI, các command lines cơ bản để có thể hoàn thành được một flow Terraform hoàn chỉnh. Phần tiếp theo mình sẽ giới thiệu về syntax trong Terraform cũng như cách sử dụng cho từng syntax. Bài viết chủ yếu được tổng hợp lại từ những kiến thức mình góp nhặt được trong quá trình tự học Terraform và diễn đạt lại theo cách hiểu của mình. Mình nghĩ sẽ có nhiều chỗ sai sót hoặc mơ hồ. Mong nhận được sự phản hồi, góp ý từ mọi người. Xin cám ơn.


All rights reserved

Viblo
Hãy đăng ký một tài khoản Viblo để nhận được nhiều bài viết thú vị hơn.
Đăng kí