diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9006ad21..9937a177 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,21 @@
+
+## [v3.8.0](https://github.com/kreuzwerker/terraform-provider-docker/compare/v3.7.0...v3.8.0) (2025-10-08)
+
+### Feat
+
+* Add build attribute for docker_registry_image ([#805](https://github.com/kreuzwerker/terraform-provider-docker/issues/805))
+* Add build option for additional contexts ([#798](https://github.com/kreuzwerker/terraform-provider-docker/issues/798))
+* implement mac_address for networks_advanced ([#794](https://github.com/kreuzwerker/terraform-provider-docker/issues/794))
+* Implement docker cluster volume ([#793](https://github.com/kreuzwerker/terraform-provider-docker/issues/793))
+
+
-## [v3.7.0](https://github.com/kreuzwerker/terraform-provider-docker/compare/v3.6.2...v3.7.0) (2025-08-13)
+## [v3.7.0](https://github.com/kreuzwerker/terraform-provider-docker/compare/v3.6.2...v3.7.0) (2025-08-19)
+
+### Chore
+
+* Prepare release v3.7.0 ([#774](https://github.com/kreuzwerker/terraform-provider-docker/issues/774))
### Feat
diff --git a/README.md b/README.md
index 2bd83697..819b82c6 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@ Do you want to migrate from `v2.x` to `v3.x`? Please read the [migration guide](
## Example usage
-Take a look at the examples in the [documentation](https://registry.terraform.io/providers/kreuzwerker/docker/3.7.0/docs) of the registry
+Take a look at the examples in the [documentation](https://registry.terraform.io/providers/kreuzwerker/docker/3.8.0/docs) of the registry
or use the following example:
@@ -38,7 +38,7 @@ terraform {
# since new versions are released frequently
docker = {
source = "kreuzwerker/docker"
- version = "3.7.0"
+ version = "3.8.0"
}
}
}
diff --git a/docs/index.md b/docs/index.md
index 63d65613..addf80a6 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -25,7 +25,7 @@ terraform {
required_providers {
docker = {
source = "kreuzwerker/docker"
- version = "3.7.0"
+ version = "3.8.0"
}
}
}
diff --git a/docs/resources/registry_image.md b/docs/resources/registry_image.md
index 373eb1ae..d591747c 100644
--- a/docs/resources/registry_image.md
+++ b/docs/resources/registry_image.md
@@ -38,6 +38,7 @@ resource "docker_image" "image" {
### Optional
- `auth_config` (Block List, Max: 1) Authentication configuration for the Docker registry. It is only used for this resource. (see [below for nested schema](#nestedblock--auth_config))
+- `build` (Block Set, Max: 1) Configuration to build an image. Requires the `Use containerd for pulling and storing images` option to be disabled in the Docker Host(https://github.com/kreuzwerker/terraform-provider-docker/issues/534). Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too. (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`
- `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))
@@ -58,6 +59,96 @@ Required:
- `username` (String) The username for the Docker registry.
+
+### Nested Schema for `build`
+
+Required:
+
+- `context` (String) Value to specify the build context. Currently, only a `PATH` context is supported. You can use the helper function '${path.cwd}/context-dir'. This always refers to the local working directory, even when building images on remote hosts. Please see https://docs.docker.com/build/building/context/ for more information about build contexts.
+
+Optional:
+
+- `additional_contexts` (List of String) A list of additional build contexts. Only supported when using a buildx builder. Example: `["name=path", "src = https://example.org"}`. Please see https://docs.docker.com/reference/cli/docker/buildx/build/#build-context for more information.
+- `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 of `ENDPOINT : "https://example.com"`
+- `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.
+- `build_log_file` (String) Path to a file where the buildx log are written to. Only available when `builder` is set. If not set, no logs are available. The path is taken as is, so make sure to use a path that is available.
+- `builder` (String) Set the name of the buildx builder to use. If not set, the legacy builder is used.
+- `cache_from` (List of String) External cache sources (e.g., `user/app:cache`, `type=local,src=path/to/dir`). Only supported when using a buildx builder.
+- `cache_to` (List of String) Cache export destinations (e.g., `user/app:cache`, `type=local,dest=path/to/dir`). Only supported when using a buildx builder.
+- `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) Name of the Dockerfile. 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
+- `label` (Map of String) Set metadata for an image
+- `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 the target platform for the build. Defaults to `GOOS/GOARCH`. For more information see the [docker documentation](https://github.com/docker/buildx/blob/master/docs/reference/buildx.md#-set-the-target-platforms-for-the-build---platform)
+- `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. Will be ignored if `builder` is set.
+- `remove` (Boolean) Remove intermediate containers after a successful build. Defaults to `true`.
+- `secrets` (Block List) Set build-time secrets. Only available when you use a buildx builder. (see [below for nested schema](#nestedblock--build--secrets))
+- `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
+- `tag` (List of String) Name and optionally a tag in the 'name:tag' format
+- `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
+
+
+### 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
+
+
+
+### Nested Schema for `build.secrets`
+
+Required:
+
+- `id` (String) ID of the secret. By default, secrets are mounted to /run/secrets/
+
+Optional:
+
+- `env` (String) Environment variable source of the secret
+- `src` (String) File source of the secret. Takes precedence over `env`
+
+
+
+### Nested Schema for `build.ulimit`
+
+Required:
+
+- `hard` (Number) soft limit
+- `name` (String) type of ulimit, e.g. `nofile`
+- `soft` (Number) hard limit
+
+
+
### Nested Schema for `timeouts`
diff --git a/examples/provider/provider-tf13.tf b/examples/provider/provider-tf13.tf
index 6f5b8a67..709c022f 100644
--- a/examples/provider/provider-tf13.tf
+++ b/examples/provider/provider-tf13.tf
@@ -2,7 +2,7 @@ terraform {
required_providers {
docker = {
source = "kreuzwerker/docker"
- version = "3.7.0"
+ version = "3.8.0"
}
}
}