Terraform¶

Terraform is an open-source Infrastructure as Code (IaC) tool developed by HashiCorp. It allows you to securely create, modify, and decommission infrastructure, and version these operations just like any other code. Terraform can manage multiple cloud service providers (such as AWS, Azure, Google Cloud Platform, etc.), network devices, and other resources.

Guance provides a Terraform Provider for managing Guance resources. Users can define and write configurations for Guance resources using the Provider and manage them via the Terraform command-line tool.

Install Terraform¶

For detailed installation instructions for Terraform, please refer to the official documentation. The following lists installation methods for some operating systems only, using Terraform version 1.9.5.

macOS¶

Package Manager

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

Binary Package

• AMD64
• ARM64

Windows¶

Binary Package

• 386
• AMD64

Linux¶

Package Manager

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

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo
sudo yum -y install terraform

sudo dnf install -y dnf-plugins-core
sudo dnf config-manager --add-repo https://rpm.releases.hashicorp.com/fedora/hashicorp.repo
sudo dnf -y install terraform

sudo yum install -y yum-utils shadow-utils
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo
sudo yum -y install terraform

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

Binary Package

• 386
• AMD64
• ARM
• ARM64

Basic Terraform Commands¶

After installing Terraform, you can verify the installation with the following command.

terraform -v

Terraform provides a series of commands to help you manage and operate cloud resources. Here are some commonly used commands:

Initialize¶

The terraform init command is used to initialize a Terraform project, including downloading and installing plugins, configuring local state storage, initializing remote state storage, etc.

Plan and Apply¶

• The terraform plan command generates an execution plan showing the changes that will be made.
• The terraform apply command executes the plan to create, modify, or delete resources.
• The terraform destroy command is used to delete resources.

State Management¶

• The terraform state list command lists all resources in the current state.
• The terraform state show command displays detailed information for a specified resource.
• The terraform state rm command removes a specified resource from the state.

Output¶

The terraform output command displays the output values defined in the current state.

Others¶

• The terraform validate command validates configuration files for correctness.
• The terraform fmt command formats configuration files.