Allow image Created date to be configurable

A `createdDate` option on the Maven `spring-boot:build-image` goal
and the Gradle `bootBuildImage` task can be used to set the `Created`
metadata field on a generated OCI image to a specified date or to
the current date.

Closes gh-28798

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/java/org/springframework/boot/maven/BuildImageTests.java

@@ -21,6 +21,7 @@ import java.io.IOException;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
+import java.time.OffsetDateTime;
 import java.util.Random;
 import java.util.stream.IntStream;
 
@@ -29,6 +30,7 @@ import org.junit.jupiter.api.extension.ExtendWith;
 
 import org.springframework.boot.buildpack.platform.docker.DockerApi;
 import org.springframework.boot.buildpack.platform.docker.DockerApi.VolumeApi;
+import org.springframework.boot.buildpack.platform.docker.type.Image;
 import org.springframework.boot.buildpack.platform.docker.type.ImageName;
 import org.springframework.boot.buildpack.platform.docker.type.ImageReference;
 import org.springframework.boot.buildpack.platform.docker.type.VolumeName;
@@ -240,14 +242,18 @@ class BuildImageTests extends AbstractArchiveIntegrationTests {
 			.systemProperty("spring-boot.build-image.pullPolicy", "IF_NOT_PRESENT")
 			.systemProperty("spring-boot.build-image.imageName", "example.com/test/cmd-property-name:v1")
 			.systemProperty("spring-boot.build-image.builder",
-					"projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1")
+					"projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2")
 			.systemProperty("spring-boot.build-image.runImage", "projects.registry.vmware.com/springboot/run:tiny-cnb")
+			.systemProperty("spring-boot.build-image.createdDate", "2020-07-01T12:34:56Z")
 			.execute((project) -> {
 				assertThat(buildLog(project)).contains("Building image")
 					.contains("example.com/test/cmd-property-name:v1")
 					.contains("---> Test Info buildpack building")
 					.contains("---> Test Info buildpack done")
 					.contains("Successfully built image");
+				Image image = new DockerApi().image()
+					.inspect(ImageReference.of("example.com/test/cmd-property-name:v1"));
+				assertThat(image.getCreated()).isEqualTo("2020-07-01T12:34:56Z");
 				removeImage("example.com/test/cmd-property-name", "v1");
 			});
 	}
@@ -387,6 +393,47 @@ class BuildImageTests extends AbstractArchiveIntegrationTests {
 			});
 	}
 
+	@TestTemplate
+	void whenBuildImageIsInvokedWithCreatedDate(MavenBuild mavenBuild) {
+		String testBuildId = randomString();
+		mavenBuild.project("build-image-created-date")
+			.goals("package")
+			.systemProperty("spring-boot.build-image.pullPolicy", "IF_NOT_PRESENT")
+			.systemProperty("test-build-id", testBuildId)
+			.execute((project) -> {
+				assertThat(buildLog(project)).contains("Building image")
+					.contains("docker.io/library/build-image-created-date:0.0.1.BUILD-SNAPSHOT")
+					.contains("Successfully built image");
+				Image image = new DockerApi().image()
+					.inspect(ImageReference.of("docker.io/library/build-image-created-date:0.0.1.BUILD-SNAPSHOT"));
+				assertThat(image.getCreated()).isEqualTo("2020-07-01T12:34:56Z");
+				removeImage("build-image-created-date", "0.0.1.BUILD-SNAPSHOT");
+			});
+	}
+
+	@TestTemplate
+	void whenBuildImageIsInvokedWithCurrentCreatedDate(MavenBuild mavenBuild) {
+		String testBuildId = randomString();
+		mavenBuild.project("build-image-current-created-date")
+			.goals("package")
+			.systemProperty("spring-boot.build-image.pullPolicy", "IF_NOT_PRESENT")
+			.systemProperty("test-build-id", testBuildId)
+			.execute((project) -> {
+				assertThat(buildLog(project)).contains("Building image")
+					.contains("docker.io/library/build-image-current-created-date:0.0.1.BUILD-SNAPSHOT")
+					.contains("Successfully built image");
+				Image image = new DockerApi().image()
+					.inspect(ImageReference
+						.of("docker.io/library/build-image-current-created-date:0.0.1.BUILD-SNAPSHOT"));
+				OffsetDateTime createdDateTime = OffsetDateTime.parse(image.getCreated());
+				OffsetDateTime current = OffsetDateTime.now();
+				assertThat(createdDateTime.getYear()).isEqualTo(current.getYear());
+				assertThat(createdDateTime.getMonth()).isEqualTo(current.getMonth());
+				assertThat(createdDateTime.getDayOfMonth()).isEqualTo(current.getDayOfMonth());
+				removeImage("build-image-current-created-date", "0.0.1.BUILD-SNAPSHOT");
+			});
+	}
+
 	@TestTemplate
 	void failsWhenBuildImageIsInvokedOnMultiModuleProjectWithBuildImageGoal(MavenBuild mavenBuild) {
 		mavenBuild.project("build-image-multi-module")

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-bad-buildpack/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<buildpacks>
 									<buildpack>urn:cnb:builder:example/does-not-exist:0.0.1</buildpack>
 								</buildpacks>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-bindings/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<bindings>
 									<binding>${basedir}/bindings/ca-certificates:/platform/bindings/ca-certificates</binding>
 								</bindings>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-builder-error/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<env>
 									<FORCE_FAILURE>true</FORCE_FAILURE>
 								</env>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-caches-multiple/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<buildCache>
 									<volume>
 										<name>build-cache-volume1</name>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-caches/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<buildCache>
 									<volume>
 										<name>cache-${test-build-id}.build</name>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-classifier-source-with-repackage/pom.xml

@@ -45,7 +45,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-classifier-source/pom.xml

@@ -39,7 +39,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-classifier-with-repackage/pom.xml

@@ -29,7 +29,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-classifier/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-cmd-line/pom.xml

@@ -19,7 +19,7 @@
 					<version>@project.version@</version>
 					<configuration>
 						<image>
-							<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+							<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 						</image>
 					</configuration>
 				</plugin>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-created-date/pom.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<groupId>org.springframework.boot.maven.it</groupId>
+	<artifactId>build-image-created-date</artifactId>
+	<version>0.0.1.BUILD-SNAPSHOT</version>
+	<properties>
+		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+		<maven.compiler.source>@java.version@</maven.compiler.source>
+		<maven.compiler.target>@java.version@</maven.compiler.target>
+	</properties>
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>@project.groupId@</groupId>
+				<artifactId>@project.artifactId@</artifactId>
+				<version>@project.version@</version>
+				<executions>
+					<execution>
+						<goals>
+							<goal>build-image-no-fork</goal>
+						</goals>
+						<configuration>
+							<image>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
+								<createdDate>2020-07-01T12:34:56Z</createdDate>
+							</image>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+</project>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-created-date/src/main/java/org/test/SampleApplication.java

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2012-2023 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.test;
+
+public class SampleApplication {
+
+	public static void main(String[] args) throws Exception {
+		System.out.println("Launched");
+		synchronized(args) {
+			args.wait(); // Prevent exit"
+		}
+	}
+
+}

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-current-created-date/pom.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<groupId>org.springframework.boot.maven.it</groupId>
+	<artifactId>build-image-current-created-date</artifactId>
+	<version>0.0.1.BUILD-SNAPSHOT</version>
+	<properties>
+		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+		<maven.compiler.source>@java.version@</maven.compiler.source>
+		<maven.compiler.target>@java.version@</maven.compiler.target>
+	</properties>
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>@project.groupId@</groupId>
+				<artifactId>@project.artifactId@</artifactId>
+				<version>@project.version@</version>
+				<executions>
+					<execution>
+						<goals>
+							<goal>build-image-no-fork</goal>
+						</goals>
+						<configuration>
+							<image>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
+								<createdDate>now</createdDate>
+							</image>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+</project>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-current-created-date/src/main/java/org/test/SampleApplication.java

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2012-2023 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.test;
+
+public class SampleApplication {
+
+	public static void main(String[] args) throws Exception {
+		System.out.println("Launched");
+		synchronized(args) {
+			args.wait(); // Prevent exit"
+		}
+	}
+
+}

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-custom-builder/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<runImage>projects.registry.vmware.com/springboot/run:tiny-cnb</runImage>
 							</image>
 						</configuration>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-custom-buildpacks/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<buildpacks>
 									<buildpack>urn:cnb:builder:spring-boot/test-info</buildpack>
 								</buildpacks>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-custom-name/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<name>example.com/test/build-image:${project.version}</name>
 							</image>
 						</configuration>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-empty-env-entry/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<env>
 									<EMPTY_KEY></EMPTY_KEY>
 								</env>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-final-name/pom.xml

@@ -25,7 +25,7 @@
 						<configuration>
 							<finalName>final-name</finalName>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-multi-module/app/pom.xml

@@ -31,7 +31,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-network/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<network>none</network>
 							</image>
 						</configuration>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-publish/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<publish>true</publish>
 							</image>
 						</configuration>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-tags/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 								<tags>
 									<tag>${project.artifactId}:latest</tag>
 								</tags>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-war-packaging/pom.xml

@@ -24,7 +24,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-with-repackage/pom.xml

@@ -29,7 +29,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image-zip-packaging/pom.xml

@@ -26,7 +26,7 @@
 				<configuration>
 					<layout>ZIP</layout>
 					<image>
-						<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+						<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 					</image>
 				</configuration>
 			</plugin>

spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/intTest/projects/build-image/pom.xml

@@ -23,7 +23,7 @@
 						</goals>
 						<configuration>
 							<image>
-								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.1</builder>
+								<builder>projects.registry.vmware.com/springboot/spring-boot-cnb-builder:0.0.2</builder>
 							</image>
 						</configuration>
 					</execution>