deps tf

Downloads all OpenTofu/Terraform providers and modules used by generated cluster infrastructure into deps/tf/ in the Podplane dependency cache.

Provider packages are stored as a filesystem mirror, module source is normalized for local use, and the resolved provider lock information is retained.

Downloads are additive, so provider packages and versioned modules already used by other clusters remain available.

podplane deps tf [--platform OS_ARCH]...

--platform is repeatable. It defaults to the platform reported by the selected OpenTofu/Terraform engine. Pass target platforms explicitly when preparing dependencies for another environment, for example:

podplane deps tf --platform linux_amd64 --platform linux_arm64

Podplane uses PODPLANE_TF_CMD when set and otherwise selects tofu, then terraform. This command requires public registry access. The resulting deps/tf/ directory can be persisted or packaged for offline jobs. Consume a cache with the same engine and version used to create it.

Existing generated clusters do not require a separate dependency manifest. Their generated module source path records the exact module version and their .terraform.lock.hcl records provider versions. Running cluster create will attempt to fetch any of those exact packages that are missing from the shared cache if registry access is available. Running cluster upgrade instead downloads the latest compatible versions and moves the cluster to them.

Cluster generation always uses the cache:

podplane cluster create --no-apply

That command references the exact cached Nstance module version, writes the retained .terraform.lock.hcl, and creates deps/tf/podplane.tfrc in the shared cache pointing to the provider mirror. It does not copy provider, module, or CLI configuration files into the cluster directory. Podplane automatically uses the shared configuration when it runs init. To invoke the engine manually without public registry access, set TF_CLI_CONFIG_FILE to that file in the configured dependency cache:

TF_CLI_CONFIG_FILE="/path/to/dependency-cache/tf/podplane.tfrc" tofu init

Replace tofu with terraform when Terraform was selected while creating the cache.