terraform-provider-envbuilder/docs/data-sources/cached_image.md
Cian Johnston c9e7cb8178
implement first pass at cached image data source ()
implements envbuilder_cached_image data source
2024-08-01 21:26:44 +01:00

5.2 KiB

page_title subcategory description
envbuilder_cached_image Data Source - envbuilder The cached image data source can be used to retrieve a cached image produced by envbuilder. Reading from this data source will clone the specified Git repository, read a Devcontainer specification or Dockerfile, and check for its presence in the provided cache repo.

envbuilder_cached_image (Data Source)

The cached image data source can be used to retrieve a cached image produced by envbuilder. Reading from this data source will clone the specified Git repository, read a Devcontainer specification or Dockerfile, and check for its presence in the provided cache repo.

Example Usage

data "envbuilder_cached_image" "example" {
  builder_image = "ghcr.io/coder/envbuilder:latest"
  git_url       = "https://github.com/coder/envbuilder-starter-devcontainer"
  cache_repo    = "localhost:5000/local/test-cache"
  extra_env = {
    "ENVBUILDER_VERBOSE" : "true"
  }
}

resource "docker_container" "container" {
  image = envbuilder_cached_image.example.image
  env   = data.envbuilder_image.cached.env
}

Schema

Required

  • builder_image (String) The envbuilder image to use if the cached version is not found.
  • cache_repo (String) (Envbuilder option) The name of the container registry to fetch the cache image from.
  • git_url (String) (Envbuilder option) The URL of a Git repository containing a Devcontainer or Docker image to clone.

Optional

  • base_image_cache_dir (String) (Envbuilder option) The path to a directory where the base image can be found. This should be a read-only directory solely mounted for the purpose of caching the base image.
  • build_context_path (String) (Envbuilder option) Can be specified when a DockerfilePath is specified outside the base WorkspaceFolder. This path MUST be relative to the WorkspaceFolder path into which the repo is cloned.
  • cache_ttl_days (Number) (Envbuilder option) The number of days to use cached layers before expiring them. Defaults to 7 days.
  • devcontainer_dir (String) (Envbuilder option) The path to the folder containing the devcontainer.json file that will be used to build the workspace and can either be an absolute path or a path relative to the workspace folder. If not provided, defaults to .devcontainer.
  • devcontainer_json_path (String) (Envbuilder option) The path to a devcontainer.json file that is either an absolute path or a path relative to DevcontainerDir. This can be used in cases where one wants to substitute an edited devcontainer.json file for the one that exists in the repo.
  • docker_config_base64 (String) (Envbuilder option) The base64 encoded Docker config file that will be used to pull images from private container registries.
  • dockerfile_path (String) (Envbuilder option) The relative path to the Dockerfile that will be used to build the workspace. This is an alternative to using a devcontainer that some might find simpler.
  • exit_on_build_failure (Boolean) (Envbuilder option) Terminates upon a build failure. This is handy when preferring the FALLBACK_IMAGE in cases where no devcontainer.json or image is provided. However, it ensures that the container stops if the build process encounters an error.
  • extra_env (Map of String) Extra environment variables to set for the container. This may include envbuilder options.
  • fallback_image (String) (Envbuilder option) Specifies an alternative image to use when neither an image is declared in the devcontainer.json file nor a Dockerfile is present. If there's a build failure (from a faulty Dockerfile) or a misconfiguration, this image will be the substitute. Set ExitOnBuildFailure to true to halt the container if the build faces an issue.
  • git_clone_depth (Number) (Envbuilder option) The depth to use when cloning the Git repository.
  • git_clone_single_branch (Boolean) (Envbuilder option) Clone only a single branch of the Git repository.
  • git_http_proxy_url (String) (Envbuilder option) The URL for the HTTP proxy. This is optional.
  • git_password (String, Sensitive) (Envbuilder option) The password to use for Git authentication. This is optional.
  • git_ssh_private_key_path (String) (Envbuilder option) Path to an SSH private key to be used for Git authentication.
  • git_username (String) (Envbuilder option) The username to use for Git authentication. This is optional.
  • ignore_paths (List of String) (Envbuilder option) The comma separated list of paths to ignore when building the workspace.
  • insecure (Boolean) (Envbuilder option) Bypass TLS verification when cloning and pulling from container registries.
  • ssl_cert_base64 (String) (Envbuilder option) The content of an SSL cert file. This is useful for self-signed certificates.
  • verbose (Boolean) (Envbuilder option) Enable verbose output.

Read-Only

  • env (List of String) Computed envbuilder configuration to be set for the container.
  • exists (Boolean) Whether the cached image was exists or not for the given config.
  • id (String) Cached image identifier. This will generally be the image's SHA256 digest.
  • image (String) Outputs the cached image repo@digest if it exists, and builder image otherwise.