Merge pull request #2953 from radriaanse/add-docker-nocache

plugin/docker: add no-cache option

.changelog/2953.txt

@@ -0,0 +1,3 @@
+```release-note:improvement
+plugin/docker: Add parameter to disable the build cache
+```

builtin/docker/builder.go

@@ -71,6 +71,9 @@ type BuilderConfig struct {
 
 	// Controls the passing of the target stage
 	Target string `hcl:"target,optional"`
+
+	// Disable the build cache
+	NoCache bool `hcl:"no_cache,optional"`
 }
 
 func (b *Builder) Documentation() (*docs.Documentation, error) {
@@ -167,6 +170,14 @@ build {
 		),
 	)
 
+	doc.SetField(
+		"no_cache",
+		"Do not use cache when building the image",
+		docs.Summary(
+			"Ensures a clean image build.",
+		),
+	)
+
 	return doc, nil
 }
 
@@ -309,7 +320,7 @@ func (b *Builder) Build(
 	// Build
 	step.Done()
 	step = nil
-	if err := b.buildWithDocker(ctx, ui, sg, cli, contextDir, relDockerfile, result.Name(), b.config.Platform, b.config.BuildArgs, b.config.Target, log); err != nil {
+	if err := b.buildWithDocker(ctx, ui, sg, cli, contextDir, relDockerfile, result.Name(), b.config.Platform, b.config.BuildArgs, b.config.Target, b.config.NoCache, log); err != nil {
 		return nil, err
 	}
 
@@ -384,6 +395,7 @@ func (b *Builder) buildWithDocker(
 	platform string,
 	buildArgs map[string]*string,
 	target string,
+	noCache bool,
 	log hclog.Logger,
 ) error {
 	excludes, err := build.ReadDockerignore(contextDir)
@@ -432,6 +444,7 @@ func (b *Builder) buildWithDocker(
 		Platform:   platform,
 		BuildArgs:  buildArgs,
 		Target:     target,
+		NoCache:    noCache,
 	}
 
 	// Buildkit builds need a session under most circumstances, but sessions are only supported in >1.39

website/content/partials/components/builder-docker.mdx

@@ -83,6 +83,15 @@ Set this when the Dockerfile is not APP-PATH/Dockerfile.
 - Type: **string**
 - **Optional**
 
+#### no_cache
+
+Do not use cache when building the image.
+
+Ensures a clean image build.
+
+- Type: **bool**
+- **Optional**
+
 #### platform
 
 Set target platform to build container if server is multi-platform capable.