2.8 KiB
title, homepage, tagline, description
| title | homepage | tagline | description |
|---|---|---|---|
| Terraform | https://www.terraform.io/ | Provision, change, and version resources on any environment. | Terraform is an infrastructure as code (IaC) tool that allows you to build, change, and version infrastructure safely and efficiently. |
To update or switch versions, run webi terraform@stable (or @v1.6.1,
@beta, etc).
Files
These are the files / directories that are created and/or modified with this install:
~/.config/envman/PATH.env
~/.local/bin/terraform
<PROJECT-DIR>/main.tf
Cheat Sheet
With HashiCorp Terraform, provisioning and security can be automated based on infrastructure and policy as code. Infrastructure and policies are codified, shared, managed, and executed within a workflow that is consistent across all infrastructure.
How to Define Infrastructure State
Create configurations that provide an outline for Terraform to provision your target infrastructure. For example:
main.tf:
terraform {
required_providers {
docker = {
source = "kreuzwerker/docker"
version = "~> 2.13.0"
}
}
}
provider "docker" {
# provider-specific configuration goes here, e.g.,
# browse provider documentation here https://registry.terraform.io/browse/providers
}
# Define some resources!
resource "docker_image" "nginx" {
name = "nginx:latest"
keep_locally = false
}
resource "docker_container" "nginx" {
image = docker_image.nginx.latest
name = "web-server"
ports {
internal = 80
external = 8080
}
}
How to Initialize Terraform
Terraform needs to install provider-specific plugins, generate lockfiles, etc. before you can begin provisioning.
terraform init
You should only need to run this on new configurations, or other configurations checked-out from version control.
How to Lint / Check / Validate your Config
To check you have a valid configuration
terraform validate
To format your configuration files
terraform fmt
How to Provision Resources
You can generate an execution plan before committing to provisioning real resources. This command allows you to see exactly what Terraform will do when running the next command.
terraform plan
Then, to apply your configurations and provision infrastructure resources:
terraform apply
Use -auto-approve to automatically accept all user prompts (non-interactive,
batch mode):
terraform apply -auto-approve
How to Execute Plans
Execution plans generated by terraform plan also act as the last working
state of your infrastructure. You may wish to save the generated .tfstate
file so that you may re-provision these resources reliably.
You can pass in the execution plan to terraform apply (example):
terraform apply -auto-approve ./main.tf