Chuyển tới nội dung chính

Cài đặt và cấu hình

Hướng dẫn này đưa bạn từ một máy chưa có Terraform tới một cấu hình đọc được VPC trên FPT Cloud. Toàn bộ quá trình mất khoảng 10 phút.

Điều kiện tiên quyết​

  • ✅ Tài khoản FPT Cloud có quyền truy cập ít nhất một VPC.
  • ✅ Role của bạn cho phép các thao tác bạn định thực hiện. Terraform dùng quyền của tài khoản bạn, nên không làm được nhiều hơn những gì bạn làm được trên Portal.
  • ✅ Máy tính chạy Linux, macOS hoặc Windows, có kết nối Internet.

Cài Terraform​

Chọn cách cài theo hệ điều hành của bạn.

macOS (Homebrew):

brew tap hashicorp/tap
brew install hashicorp/tap/terraform

Ubuntu và Debian:

wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install terraform

Windows: tải gói cài từ trang cài đặt Terraform, giải nén terraform.exe rồi thêm thư mục chứa file vào biến môi trường PATH.

Kiểm tra cài đặt:

terraform -version

Lệnh in ra phiên bản Terraform, ví dụ Terraform v1.10.5. Các ví dụ trong phần hướng dẫn này cần Terraform 1.5 trở lên.

Tạo Token​

Token cho phép Terraform gọi API của FPT Cloud thay cho bạn.

  1. Đăng nhập FPT Cloud Portal.

  2. Chọn Token ở thanh menu bên trái.

  3. Chọn Create.

  4. Điền Name và chọn Expiration cho token.

  5. Chọn Create.

    Hộp thoại Create New Personal Access Token với trường Name và Expiration

  6. Sao chép token và lưu ở nơi an toàn, ví dụ trình quản lý mật khẩu.

cảnh báo

Token có quyền như tài khoản của bạn. Không ghi token vào file .tf, không commit lên Git và không gửi qua chat.

Chuẩn bị thông tin kết nối​

Ngoài token, provider cần hai thông tin:

Thông tinNơi lấy
Tên tenantTên tenant bạn chọn ở đầu Portal.
RegionRegion chứa VPC của bạn, tra theo bảng dưới đây.
RegionGiá trị region
Hà NộiVN/HAN
Hà Nội 2VN/HAN2
Hồ Chí MinhVN/SGN
Hồ Chí Minh 2VN/SGN2
Nhật Bản (Tokyo)JP/JCSI2

Khai báo thông tin kết nối​

Cách nên dùng là biến môi trường, để token không bao giờ xuất hiện trong mã nguồn.

Linux và macOS:

export FPTCLOUD_TOKEN="YOUR_API_TOKEN"
export FPTCLOUD_TENANT_NAME="YOUR_TENANT_NAME"
export FPTCLOUD_REGION="VN/HAN"

Windows PowerShell:

$env:FPTCLOUD_TOKEN = "YOUR_API_TOKEN"
$env:FPTCLOUD_TENANT_NAME = "YOUR_TENANT_NAME"
$env:FPTCLOUD_REGION = "VN/HAN"

Biến môi trường chỉ có hiệu lực trong cửa sổ terminal hiện tại. Mở terminal mới thì cần khai báo lại.

ghi chú

Với region JP/JCSI2, khai báo thêm FPTCLOUD_API_URL="https://console-api.fptcloud.jp/api".

Cấu hình provider​

  1. Tạo một thư mục mới cho dự án, ví dụ fptcloud-demo.

  2. Tạo file versions.tf trong thư mục đó:

    terraform {
    required_version = ">= 1.5"

    required_providers {
    fptcloud = {
    source = "fpt-corp/fptcloud"
    version = "~> 0.3"
    }
    }
    }

    provider "fptcloud" {}
  3. Tải provider:

    terraform init

Kết quả kết thúc bằng dòng Terraform has been successfully initialized!.

Khối provider "fptcloud" {} để trống vì provider tự đọc token, tenant và region từ biến môi trường. Nếu bạn khai báo trong khối provider, giá trị trong khối được ưu tiên hơn biến môi trường.

Tham số của provider​

Tham sốBiến môi trườngBắt buộcMô tả
tokenFPTCLOUD_TOKENCóToken tạo ở trang Token.
tenant_nameFPTCLOUD_TENANT_NAMECóTên tenant chứa tài nguyên.
regionFPTCLOUD_REGIONCóRegion của VPC, lấy từ bảng region ở trên.
api_endpointFPTCLOUD_API_URLKhôngMặc định https://console-api.fptcloud.com/api. Với Nhật Bản dùng https://console-api.fptcloud.jp/api.
timeoutFPTCLOUD_TIMEOUTKhôngSố phút Terraform chờ một thao tác hoàn tất, mặc định 15.

Khi tạo Instance lớn hoặc hệ thống đang bận, thao tác có thể lâu hơn 15 phút. Khi đó, tăng timeout:

provider "fptcloud" {
timeout = 30
}

Kiểm tra kết nối​

  1. Tạo file main.tf để đọc thông tin VPC. Thay example-vpc bằng tên VPC của bạn:

    data "fptcloud_vpc" "example" {
    name = "example-vpc"
    }

    output "vpc_id" {
    value = data.fptcloud_vpc.example.id
    }
  2. Chạy lệnh:

    terraform apply
  3. Nhập yes để xác nhận.

Terraform in ra vpc_id của VPC. Data source chỉ đọc dữ liệu, nên lệnh này không tạo tài nguyên nào. Nếu gặp lỗi, xem Xử lý sự cố.

Bước tiếp theo​