Glossary

64 terms

Alias (provider)
A name that distinguishes an extra configuration of the same provider, such as aws.west
Apply
Executes a plan, changing real infrastructure and writing state
Assert
A condition inside a check block. Failures produce warnings.
Backend
Where state is stored and how it's locked: local, s3, azurerm, gcs, pg, and others
Check block
A top-level block of assert conditions, plus an optional scoped data source, evaluated on every plan and apply. Warning only.
Child module
A module called from another module through a module block
cloud block
The terraform sub-block that connects a configuration to HCP Terraform or Terraform Enterprise. It replaces backend.
Configuration version
A snapshot of configuration uploaded to HCP Terraform for a run, in the API-driven or CLI-driven workflow
count
A meta-argument that creates N instances addressed by index
Data source
A read-only lookup of an existing object, referenced as data.TYPE.NAME
depends_on
A meta-argument declaring an explicit dependency on whole objects
Drift
A difference between real infrastructure and state, caused by changes made outside Terraform
Dynamic block
Generates repeated nested blocks from a collection
Dynamic provider credentials
Short-lived, per-run cloud credentials that HCP Terraform obtains through OIDC workload identity
Ephemeral resource
An ephemeral block that reads or opens a value each run and never persists it (1.10+)
Ephemeral value
A value that exists only during one operation and is never written to state or plan files: ephemeral variables, outputs, and resources
Execution mode
Where an HCP Terraform workspace runs Terraform: Remote, Local, or Agent
for_each
A meta-argument that creates instances keyed by a map or a set of strings
Health assessment
Scheduled HCP Terraform checks for drift and for check blocks and conditions (continuous validation)
HCL
HashiCorp Configuration Language, used in .tf files
HCP Terraform
HashiCorp's SaaS platform for Terraform, formerly Terraform Cloud
Idempotency
Re-applying an unchanged configuration produces no changes
Implicit dependency
A dependency Terraform infers from a reference between objects
Import block
A plannable declaration that adopts an existing object into state (1.5+, for_each since 1.7)
lifecycle
A resource block containing create_before_destroy, prevent_destroy, ignore_changes, replace_triggered_by, and conditions
Local value
A named expression in a locals block, referenced as local.NAME
Lock file
.terraform.lock.hcl, which records selected provider versions and checksums
Module
A directory of .tf files. Every configuration is a root module.
moved block
Records an address change so that Terraform keeps the object rather than replacing it
Organization
The top level of HCP Terraform, holding teams, billing, projects, and workspaces
Output value
A value exported from a module, read as module.NAME.OUT or with terraform output
Partial configuration
Backend settings omitted from code and supplied at init time with -backend-config
Plan
The proposed set of changes, computed by diffing configuration against refreshed state
Policy set
A group of Sentinel or OPA policies applied to an organization, projects, or workspaces
Postcondition
A lifecycle check evaluated after an object is planned or applied. Can use self. Error on failure.
Precondition
A lifecycle or output check evaluated before an object is evaluated. Error on failure.
Private registry
An HCP Terraform or Enterprise registry for an organization's own modules and providers
Project
An HCP Terraform grouping of workspaces, used to scope permissions and variable sets
Provider
A plugin that implements resource types, data sources, and functions for one API
Provisioner
Runs actions on a machine during create or destroy. A last resort, according to HashiCorp.
Refresh-only
A plan or apply mode that updates state to match reality without changing infrastructure
Registry
The public Terraform Registry (registry.terraform.io) for providers and modules
removed block
Stops managing an object, either keeping it or destroying it according to lifecycle { destroy = … } (1.7+)
Resource
A managed infrastructure object that Terraform creates, updates, and deletes
Resource address
The unique path to a resource, such as module.app.aws_instance.web["a"]
Root module
The working directory where Terraform commands run
Run task
An external service called at defined stages of an HCP Terraform run
Run trigger
Queues a run in one HCP Terraform workspace after another workspace applies
Sentinel
HashiCorp's policy-as-code language. Enforcement levels: advisory, soft-mandatory, hard-mandatory.
Sensitive
A marking that redacts a value in CLI output. The value is still stored in state.
Speculative plan
A plan that can't be applied, run for pull requests and CLI plans in HCP Terraform
Splat
[*] shorthand for selecting an attribute from every element of a list
State
Terraform's record mapping configuration to real objects, with their attributes and metadata
State locking
Prevents concurrent state writes
Taint
Marks a resource for replacement. The terraform taint command is deprecated in favor of -replace.
Terraform Enterprise
The self-hosted distribution of HCP Terraform
terraform_data
A built-in managed resource with input, output, and triggers_replace, which replaces null_resource (1.4+)
terraform_remote_state
A data source that reads another configuration's root module outputs
tfe_outputs
A tfe provider data source that reads an HCP Terraform workspace's outputs
Variable set
A reusable group of HCP Terraform variables, scoped to the organization, projects, or workspaces
Version constraint
An expression limiting acceptable versions, such as ~> 3.7 or >= 1.0, < 2.0
Workspace (CLI)
An additional named state within one backend
Workspace (HCP Terraform)
A unit holding state, variables, runs, settings, permissions, and policies
Write-only argument
A provider argument whose value is sent during apply but never stored (1.11+), usually paired with a _wo_version argument