constellation/terraform-provider-constellation/docs/data-sources/image.md
Moritz Sanft e691e26bd3
cli: support for GCP marketplace images (#2792)
* cli: support GCP marketplace images

* ci: support GCP marketplace images

* docs: support GCP marketplace images

* bazel: generate

* ci: allow GCP for mpi e2e test

* Update docs/docs/overview/license.md

Co-authored-by: Thomas Tendyck <51411342+thomasten@users.noreply.github.com>

* terraform-provider: allow GCP MPIs

* terraform-provider: fix error message

---------

Co-authored-by: Thomas Tendyck <51411342+thomasten@users.noreply.github.com>
2024-01-08 15:51:39 +01:00

2.4 KiB

page_title subcategory description
constellation_image Data Source - constellation Data source to resolve the CSP-specific OS image reference for a given version and attestation variant.

constellation_image (Data Source)

Data source to resolve the CSP-specific OS image reference for a given version and attestation variant.

Example Usage

data "constellation_image" "example" {
  version             = "v2.13.0"
  attestation_variant = "aws-sev-snp"
  csp                 = "aws"
  region              = "eu-west-1"
}

Schema

Required

  • attestation_variant (String) Attestation variant the image should work with. Can be one of:
    • aws-sev-snp
    • aws-nitro-tpm
    • azure-sev-snp
    • gcp-sev-es
  • csp (String) CSP (Cloud Service Provider) to use. (e.g. azure) See the full list of CSPs that Constellation supports.

Optional

  • marketplace_image (Boolean) Whether a marketplace image should be used. Currently only supported for Azure and GCP.
  • region (String) Region to retrieve the image for. Only required for AWS. The Constellation OS image must be replicated to the region,and the region must support AMD SEV-SNP, if it is used for Attestation.
  • version (String) Version of the Constellation OS image to use. (e.g. v2.13.0). If not set, the provider version value is used.

Read-Only

Nested Schema for image

Read-Only:

  • reference (String) CSP-specific unique reference to the image. The format differs per CSP.
  • short_path (String) CSP-agnostic short path to the image. The format is vX.Y.Z for release images and ref/$GIT_REF/stream/$STREAM/$SEMANTIC_VERSION for pre-release images.
  • $GIT_REF is the git reference (i.e. branch name) the image was built on, e.g. main.
  • $STREAM is the stream the image was built on, e.g. nightly.
  • $SEMANTIC_VERSION is the semantic version of the image, e.g. vX.Y.Z or vX.Y.Z-pre....
  • version (String) Semantic version of the image.