Skip to content

Version v3.7.0 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.

Terraform

Provision cloud VM with terraform

Terraform is a popular IaC tool. You can create VMs on public cloud with one command.

Aliyun & AWS templates are used as example providers. You can take terraform.tf as an example.


Get Started

You can install terraform with homebrew on macOS

install homebrew and terraform
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install terraform

Then init terraform cloud provider, adjust the terraform.tf config file and apply it:

cd ~/pigsty/terraform
terraform init
terraform apply #-auto-approve

Print public IP Address:

terraform output | grep -Eo '[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}'

AWS Setup

You have to set up aws config & credential to use AWS provider.

# ~/.aws

# ~/.aws/config
[default]
region = cn-northwest-1

# ~/.aws/credentials
[default]
aws_access_key_id = <YOUR_AWS_ACCESS_KEY>
aws_secret_access_key =  <AWS_ACCESS_SECRET>

# ~/.aws/pigsty-key
# ~/.aws/pigsty-key.pub

There’s a contrib example for AWS (Amazon Web Services), but it’s not actively maintained.


Aliyun Setup

You can add your aliyun credentials to the environment file, such as ~/.bash_profile

export ALICLOUD_ACCESS_KEY="<your_access_key>"
export ALICLOUD_SECRET_KEY="<your_secret_key>"
export ALICLOUD_REGION="cn-beijing"

Example config files:

Here are example ECS public OS images used in Aliyun:

Distribution Image Prefix Image Prefix
CentOS 7.9 centos_7_9_x64 rockylinux_8_10_arm6
Rocky 8.10 rockylinux_8_10_x64 rockylinux_9_6_arm64
Rocky 9.6 rockylinux_9_5_x64
Debian 11.11 debian_11_11_x64
Debian 12.11 debian_12_11_x64 debian_12_11_arm64
Ubuntu 20.04 ubuntu_20_04_x64
Ubuntu 22.04 ubuntu_22_04_x64 ubuntu_22_04_arm64
Ubuntu 24.04 ubuntu_24_04_x64 ubuntu_24_04_arm64
Anolis 8.8 anolisos_8_9_x64

QCloud Setup

There’s a contrib example for QCloud (Tencent Cloud), but it’s not actively maintained.