terraform-provider-docker/templates/resources/image.md.tmpl
Martin 59fcfcc269
feat: Implement triggers attribute for docker_image. (#425)
* feat: Implement triggers attribute for docker_image.

* fix: Update repo_digest value in test.
2022-08-10 13:57:14 +02:00

40 lines
1.2 KiB
Cheetah

---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "{{.Type}} {{.Name}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---
<!-- Bug: Type and Name are switched -->
# {{.Type}} ({{.Name}})
{{ .Description | trimspace }}
## Example Usage
### Basic
Finds and downloads the latest `ubuntu:precise` image but does not check
for further updates of the image
{{tffile "examples/resources/docker_image/resource.tf"}}
### Dynamic updates
To be able to update an image dynamically when the `sha256` sum changes,
you need to use it in combination with `docker_registry_image` as follows:
{{tffile "examples/resources/docker_image/resource-dynamic.tf"}}
### Build
You can also use the resource to build an image.
In this case the image "zoo" and "zoo:develop" are built.
{{tffile "examples/resources/docker_image/resource-build.tf"}}
You can use the `triggers` argument to specify when the image should be rebuild. This is for example helpful when you want to rebuild the docker image whenever the source code changes.
{{tffile "examples/resources/docker_image/resource-build-triggers.tf"}}
{{ .SchemaMarkdown | trimspace }}