terraform-provider-uds

command module

v0.5.0-nightly Latest Latest Go to latest Published: Jul 30, 2026 License: AGPL-3.0 Imports: 8 Imported by: 0

README ¶

OpenTofu Provider for UDS (Unified Defense Stack)

Manage UDS resources with OpenTofu. Currently, the provider supports deploying and managing UDS packages.

Installation

Provider releases are currently distributed as OCI artifacts. Publication to the OpenTofu Registry and Terraform Registry is planned.

Until then, add the following mirror to your OpenTofu CLI configuration:

provider_installation {
  oci_mirror {
    repository_template = "ghcr.io/defenseunicorns/opentofu-providers/defenseunicorns/uds"
    include             = ["defenseunicorns/uds"]
  }

  direct {}
}

Usage

terraform {
  required_providers {
    uds = {
      source  = "defenseunicorns/uds"
      version = "~> 0.4.1" # x-release-please-version
    }
  }
}

resource "uds_package" "init" {
  source = "oci://ghcr.io/zarf-dev/packages/init:v0.82.0"
}

  # init is keyless-signed. This example skips verification for brevity.
  signature_verification = {
    verify = false
  }
}

resource "uds_package" "dos_games" {
  depends_on = [uds_package.init]
  source     = "oci://ghcr.io/zarf-dev/packages/dos-games:1.3.0"
  namespace  = "demo"

  # dos-games is key-signed. This example skips verification for brevity.
  signature_verification = {
    verify = false
  }
}

tofu init
tofu plan
tofu apply

Documentation

Development

See CONTRIBUTING.md.

License

See LICENSE.

Documentation ¶

Overview ¶

Package main provides the entrypoint for the UDS Terraform provider.

Source Files ¶

View all Source files

main.go

Directories ¶

Path	Synopsis
internal
cluster Package cluster provides interfaces and implementations for Zarf cluster operations.	Package cluster provides interfaces and implementations for Zarf cluster operations.
fileutil Package fileutil provides file utility functions.	Package fileutil provides file utility functions.
fixzarf Package fixzarf provides utilities to fix zarf argument handling and initialization ordering.	Package fixzarf provides utilities to fix zarf argument handling and initialization ordering.
packager Package packager provides interfaces and implementations for Zarf package operations.	Package packager provides interfaces and implementations for Zarf package operations.
provider Package provider implements the UDS Terraform provider.	Package provider implements the UDS Terraform provider.
provider/validator Package validator provides custom validation functions for Terraform attributes.	Package validator provides custom validation functions for Terraform attributes.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL