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
checkblock. 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
assertconditions, plus an optional scoped data source, evaluated on every plan and apply. Warning only. - Child module
- A module called from another module through a
moduleblock cloudblock- The
terraformsub-block that connects a configuration to HCP Terraform or Terraform Enterprise. It replacesbackend. - 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
ephemeralblock 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
checkblocks and conditions (continuous validation) - HCL
- HashiCorp Configuration Language, used in
.tffiles - 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_eachsince 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
localsblock, referenced aslocal.NAME - Lock file
.terraform.lock.hcl, which records selected provider versions and checksums- Module
- A directory of
.tffiles. Every configuration is a root module. movedblock- 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.OUTor withterraform output - Partial configuration
- Backend settings omitted from code and supplied at
inittime 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 removedblock- 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 taintcommand 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, andtriggers_replace, which replacesnull_resource(1.4+) terraform_remote_state- A data source that reads another configuration's root module outputs
tfe_outputs- A
tfeprovider 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.7or>= 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_versionargument