mirror of
https://github.com/kreuzwerker/terraform-provider-docker.git
synced 2026-01-06 14:59:37 -05:00
112 lines
No EOL
5.1 KiB
Markdown
112 lines
No EOL
5.1 KiB
Markdown
---
|
||
# generated by https://github.com/hashicorp/terraform-plugin-docs
|
||
page_title: "Resource docker_registry_image - terraform-provider-docker"
|
||
subcategory: ""
|
||
description: |-
|
||
Manages the lifecycle of docker image/tag in a registry means it can store one or more version of specific docker images and identified by their tags.
|
||
---
|
||
<!-- Bug: Type and Name are switched -->
|
||
# Resource (docker_registry_image)
|
||
|
||
Manages the lifecycle of docker image/tag in a registry means it can store one or more version of specific docker images and identified by their tags.
|
||
|
||
## Example Usage
|
||
|
||
To be able to update an image itself when an updated image arrives.
|
||
|
||
```terraform
|
||
resource "docker_registry_image" "helloworld" {
|
||
name = "helloworld:1.0"
|
||
|
||
build {
|
||
context = "${path.cwd}/absolutePathToContextFolder"
|
||
}
|
||
}
|
||
```
|
||
|
||
<!-- schema generated by tfplugindocs -->
|
||
## Schema
|
||
|
||
### Required
|
||
|
||
- `name` (String) The name of the Docker image.
|
||
|
||
### Optional
|
||
|
||
- `build` (Block List, Max: 1) Definition for building the image (see [below for nested schema](#nestedblock--build))
|
||
- `insecure_skip_verify` (Boolean) If `true`, the verification of TLS certificates of the server/registry is disabled. Defaults to `false`
|
||
- `keep_remotely` (Boolean) If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker registry on destroy operation. Defaults to `false`
|
||
- `triggers` (Map of String) A map of arbitrary strings that, when changed, will force the `docker_registry_image` resource to be replaced. This can be used to rebuild an image when contents of source code folders change or to repush a local image
|
||
|
||
### Read-Only
|
||
|
||
- `id` (String) The ID of this resource.
|
||
- `sha256_digest` (String) The sha256 digest of the image.
|
||
|
||
<a id="nestedblock--build"></a>
|
||
### Nested Schema for `build`
|
||
|
||
Required:
|
||
|
||
- `context` (String) The absolute path to the context folder. You can use the helper function '${path.cwd}/context-dir'.
|
||
|
||
Optional:
|
||
|
||
- `auth_config` (Block List) The configuration for the authentication (see [below for nested schema](#nestedblock--build--auth_config))
|
||
- `build_args` (Map of String) Pairs for build-time variables in the form TODO
|
||
- `build_id` (String) BuildID is an optional identifier that can be passed together with the build request. The same identifier can be used to gracefully cancel the build with the cancel request.
|
||
- `cache_from` (List of String) Images to consider as cache sources
|
||
- `cgroup_parent` (String) Optional parent cgroup for the container
|
||
- `cpu_period` (Number) The length of a CPU period in microseconds
|
||
- `cpu_quota` (Number) Microseconds of CPU time that the container can get in a CPU period
|
||
- `cpu_set_cpus` (String) CPUs in which to allow execution (e.g., `0-3`, `0`, `1`)
|
||
- `cpu_set_mems` (String) MEMs in which to allow execution (`0-3`, `0`, `1`)
|
||
- `cpu_shares` (Number) CPU shares (relative weight)
|
||
- `dockerfile` (String) Dockerfile file. Defaults to `Dockerfile`
|
||
- `extra_hosts` (List of String) A list of hostnames/IP mappings to add to the container’s /etc/hosts file. Specified in the form ["hostname:IP"]
|
||
- `force_remove` (Boolean) Always remove intermediate containers
|
||
- `isolation` (String) Isolation represents the isolation technology of a container. The supported values are
|
||
- `labels` (Map of String) User-defined key/value metadata
|
||
- `memory` (Number) Set memory limit for build
|
||
- `memory_swap` (Number) Total memory (memory + swap), -1 to enable unlimited swap
|
||
- `network_mode` (String) Set the networking mode for the RUN instructions during build
|
||
- `no_cache` (Boolean) Do not use the cache when building the image
|
||
- `platform` (String) Set platform if server is multi-platform capable
|
||
- `pull_parent` (Boolean) Attempt to pull the image even if an older image exists locally
|
||
- `remote_context` (String) A Git repository URI or HTTP/HTTPS context URI
|
||
- `remove` (Boolean) Remove intermediate containers after a successful build (default behavior)
|
||
- `security_opt` (List of String) The security options
|
||
- `session_id` (String) Set an ID for the build session
|
||
- `shm_size` (Number) Size of /dev/shm in bytes. The size must be greater than 0
|
||
- `squash` (Boolean) If true the new layers are squashed into a new image with a single new layer
|
||
- `suppress_output` (Boolean) Suppress the build output and print image ID on success
|
||
- `target` (String) Set the target build stage to build
|
||
- `ulimit` (Block List) Configuration for ulimits (see [below for nested schema](#nestedblock--build--ulimit))
|
||
- `version` (String) Version of the underlying builder to use
|
||
|
||
<a id="nestedblock--build--auth_config"></a>
|
||
### Nested Schema for `build.auth_config`
|
||
|
||
Required:
|
||
|
||
- `host_name` (String) hostname of the registry
|
||
|
||
Optional:
|
||
|
||
- `auth` (String) the auth token
|
||
- `email` (String) the user emal
|
||
- `identity_token` (String) the identity token
|
||
- `password` (String) the registry password
|
||
- `registry_token` (String) the registry token
|
||
- `server_address` (String) the server address
|
||
- `user_name` (String) the registry user name
|
||
|
||
|
||
<a id="nestedblock--build--ulimit"></a>
|
||
### Nested Schema for `build.ulimit`
|
||
|
||
Required:
|
||
|
||
- `hard` (Number) soft limit
|
||
- `name` (String) type of ulimit, e.g. `nofile`
|
||
- `soft` (Number) hard limit |