OpenTofu lets you declaratively manage your cloud infrastructure.
Go to file
Martin Atkins f1358f9fe8 evalchecks: Suggest -exclude as a workaround for unknown count/for_each
Previously we made a very generic suggestion to use -target to split a
change into two parts as a workaround for the fact that count and for_each
must be known during planning. That works, but we didn't have enough
information available to tell the operator exactly what to target and so
anyone who is not an expert on the configuration they're working with tends
to get stuck unable to figure out exactly what they need to do.

The new -exclude option gives us an opportunity to do better here: we tend
to know for which object we're currently evaluating count or for_each, and
so we can mention that object directly in the error message when if we
recommend to use -exclude instead of -target.

Not all objects that support count/for_each will necessarily be directly
targetable, so we can still potentially recommend -target when we're
dealing with one of those objects. For example, as of this commit that
is true for for_each in a provider block, because there is not currently
any syntax for specifying a provider configuration as an addrs.Targetable.
Perhaps we'll introduce such a thing in the future, but that's outside the
scope of this change that's primarily focused on improving the messaging
for resource and module count/for_each.

Signed-off-by: Martin Atkins <mart@degeneration.co.uk>
2025-01-02 13:24:11 -08:00
.github Bump main to 1.10.0-alpha1 now that 1.9 has been branched (#2291) 2024-12-12 12:13:54 -05:00
cmd/tofu Another batch of minor typos (#1953) 2024-09-09 07:51:39 -04:00
docs Fix typos (#1905) 2024-08-29 13:20:33 -04:00
internal evalchecks: Suggest -exclude as a workaround for unknown count/for_each 2025-01-02 13:24:11 -08:00
rfc rfc: Static Evaluation of Provider Iteration state tracking revision 2024-12-11 12:52:50 -08:00
scripts Fix typos (#1905) 2024-08-29 13:20:33 -04:00
testing Fix typos (#1905) 2024-08-29 13:20:33 -04:00
tools Update copyright notice (#1232) 2024-02-08 09:48:59 +00:00
version Bump main to 1.10.0-alpha1 now that 1.9 has been branched (#2291) 2024-12-12 12:13:54 -05:00
website Functions: decode_tfvars, encode_tfvars, encode_expr on bult-in provider for compatibility (#2306) 2024-12-25 13:21:59 +04:00
.copywrite.hcl ignore any lock file on license header check (#1776) 2024-07-08 15:27:11 +03:00
.devcontainer.json Update devcontainer image to Go 1.21 (#1470) 2024-04-08 11:37:25 +02:00
.gitignore Bug Fix #1403 - Set grade and channel correctly (#1450) 2024-04-09 10:41:35 -04:00
.go-version Bump golang version to 1.22.8 (address CVE-2024-34156) (#2050) 2024-11-19 17:47:57 +01:00
.golangci.yml Fix data provider iteration destroy (#2270) 2024-12-09 07:56:58 -05:00
.goreleaser.yaml Fixes #1931: Dockerfile update / base image deprecation (#1993) 2024-09-17 16:07:07 +02:00
.licensei.toml feat: add license checks on dependencies (#310) 2023-09-13 19:10:41 +03:00
.tfdev Rename github.com/placeholderplaceholderplaceholder/opentf to github.com/opentofu/opentofu (#461) 2023-09-20 14:35:35 +03:00
CHANGELOG.md Functions: decode_tfvars, encode_tfvars, encode_expr on bult-in provider for compatibility (#2306) 2024-12-25 13:21:59 +04:00
CODE_OF_CONDUCT.md Update core team email. (#752) 2023-10-19 12:03:39 +02:00
codecov.yml Update copyright notice (#1232) 2024-02-08 09:48:59 +00:00
CODEOWNERS Add MAINTAINER and update CODEOWNERS (#919) 2023-11-24 14:08:53 +01:00
CONTRIBUTING.md Update CONTRIBUTING.md: Update 'docker run' example (#2005) 2024-09-23 07:23:32 -04:00
CONTRIBUTING.RELEASE.md Update release instructions (#2259) 2024-12-05 16:01:35 +01:00
Dockerfile Fixes #1931: Dockerfile update / base image deprecation (#1993) 2024-09-17 16:07:07 +02:00
go.mod bump golang.org/x/net from 0.25 to 0.33 (#2311) 2024-12-26 15:13:05 +02:00
go.sum bump golang.org/x/net from 0.25 to 0.33 (#2311) 2024-12-26 15:13:05 +02:00
LICENSE Update copyright notice (#1232) 2024-02-08 09:48:59 +00:00
MAINTAINERS Update maintainers file (#1088) 2024-01-10 08:57:47 -05:00
Makefile Update lint make target to match CI (#2025) 2024-10-02 08:26:27 -04:00
README.md [TSC] summary for TSC meetings in August (#1935) 2024-08-27 16:03:56 +02:00
RELEASE.md Creates RELEASE.md (#1758) 2024-09-04 07:14:32 -04:00
SECURITY.md Added Security disclousure policy (#749) 2023-10-19 15:27:59 -07:00
tools.go add automated copyright header check (#1696) 2024-06-03 16:49:36 +03:00
TSC_SUMMARY.md Update TSC_SUMMARY.md (#2279) 2024-12-11 08:40:19 -08:00
WEEKLY_UPDATES.md Weekly update 2024-10-11 (#2068) 2024-10-11 15:20:00 +02:00

OpenTofu

OpenTofu is an OSS tool for building, changing, and versioning infrastructure safely and efficiently. OpenTofu can manage existing and popular service providers as well as custom in-house solutions.

The key features of OpenTofu are:

  • Infrastructure as Code: Infrastructure is described using a high-level configuration syntax. This allows a blueprint of your datacenter to be versioned and treated as you would any other code. Additionally, infrastructure can be shared and re-used.

  • Execution Plans: OpenTofu has a "planning" step where it generates an execution plan. The execution plan shows what OpenTofu will do when you call apply. This lets you avoid any surprises when OpenTofu manipulates infrastructure.

  • Resource Graph: OpenTofu builds a graph of all your resources, and parallelizes the creation and modification of any non-dependent resources. Because of this, OpenTofu builds infrastructure as efficiently as possible, and operators get insight into dependencies in their infrastructure.

  • Change Automation: Complex changesets can be applied to your infrastructure with minimal human interaction. With the previously mentioned execution plan and resource graph, you know exactly what OpenTofu will change and in what order, avoiding many possible human errors.

Getting help and contributing

Tip

For more OpenTofu events, subscribe to the OpenTofu Events Calendar!

Reporting security vulnerabilities

If you've found a vulnerability or a potential vulnerability in OpenTofu please follow Security Policy. We'll send a confirmation email to acknowledge your report, and we'll send an additional email when we've identified the issue positively or negatively.

If you believe you have found any possible copyright or intellectual property issues, please contact liaison@opentofu.org. We'll send a confirmation email to acknowledge your report.

Registry Access

In an effort to comply with applicable sanctions, we block access from specific countries of origin.

License

Mozilla Public License v2.0