包装 OCI 图像

该插件可以使用云原生构建包(CNB)从jar或war文件创建OCI镜像。 图像可以通过启动构建图像任务。spring-doc.cadn.net.cn

出于安全考虑,镜像以非root用户身份构建和运行。 更多细节请参见CNB规范

Java战争插件被应用,是 的实例启动构建映像.spring-doc.cadn.net.cn

Docker 守护进程

启动构建图像任务需要访问 Docker 守护进程。 该任务将检查本地 Docker CLI 配置文件以确定当前上下文,并利用上下文连接信息与 Docker 守护进程通信。 如果无法确定当前上下文或上下文没有连接信息,任务将使用默认的本地连接。 这在所有支持的平台上的 Docker Engine 无需配置即可运行。spring-doc.cadn.net.cn

环境变量可以设置为配置启动构建图像任务是使用替代的本地或远程连接。 下表展示了环境变量及其值:spring-doc.cadn.net.cn

环境变量 描述

DOCKER_CONFIGspring-doc.cadn.net.cn

用于确定当前上下文的Docker CLI配置文件位置(默认为$HOME/.docker)spring-doc.cadn.net.cn

DOCKER_CONTEXTspring-doc.cadn.net.cn

应用于从 Docker CLI 配置文件中获取主机信息的上下文名称(覆盖DOCKER_HOST)spring-doc.cadn.net.cn

DOCKER_HOSTspring-doc.cadn.net.cn

包含 Docker 守护进程主机和端口的 URL - 例如。tcp://192.168.99.100:2376spring-doc.cadn.net.cn

DOCKER_TLS_VERIFYspring-doc.cadn.net.cn

当设置为 时启用安全HTTPS协议1(可选)spring-doc.cadn.net.cn

DOCKER_CERT_PATHspring-doc.cadn.net.cn

HTTPS的证书和密钥文件路径(如果需要DOCKER_TLS_VERIFY=1否则忽略)spring-doc.cadn.net.cn

Docker 守护进程连接信息也可以通过以下方式提供Jetty工人插件配置中的属性。 下表总结了可用的属性:spring-doc.cadn.net.cn

属性 描述

上下文spring-doc.cadn.net.cn

应用于从 Docker CLI 配置文件中获取主机信息的上下文名称spring-doc.cadn.net.cn

主机spring-doc.cadn.net.cn

包含 Docker 守护进程主机和端口的 URL - 例如。tcp://192.168.99.100:2376spring-doc.cadn.net.cn

tlsVerify(转折点)spring-doc.cadn.net.cn

当设置为 时启用安全HTTPS协议true(可选)spring-doc.cadn.net.cn

certPathspring-doc.cadn.net.cn

HTTPS的证书和密钥文件路径(如果需要tlsVerify(转折点)true否则忽略)spring-doc.cadn.net.cn

bindHostToBuilderspring-doc.cadn.net.cn

什么时候true, 的值主机属性将提供给为CNB构建器创建的容器(可选)spring-doc.cadn.net.cn

更多细节,请参见示例spring-doc.cadn.net.cn

Docker 注册表

如果 Docker 镜像由架构工人runImage属性存储在需要认证的私有 Docker 映像注册表中,认证凭证可以通过以下方式提供docker.builderRegistry性能。spring-doc.cadn.net.cn

如果生成的 Docker 镜像要发布到 Docker 镜像注册表,认证凭证可以通过以下方式提供docker.publishRegistry性能。spring-doc.cadn.net.cn

为用户认证或身份Tokens认证提供了属性。 请参阅用于存储镜像的 Docker 注册表文档,了解更多支持的认证方法信息。spring-doc.cadn.net.cn

下表总结了可用的性质docker.builderRegistrydocker.publishRegistry:spring-doc.cadn.net.cn

属性 描述

用户名spring-doc.cadn.net.cn

Docker 映像注册用户的用户名。用户认证必修。spring-doc.cadn.net.cn

密码spring-doc.cadn.net.cn

Docker 映像注册表用户的密码。用户认证必修。spring-doc.cadn.net.cn

网址spring-doc.cadn.net.cn

Docker 镜像注册表的地址。用户认证时可选。spring-doc.cadn.net.cn

电子邮件spring-doc.cadn.net.cn

Docker 映像注册表用户的电子邮件地址。用户认证时可选。spring-doc.cadn.net.cn

Tokensspring-doc.cadn.net.cn

为 Docker 映像注册表用户提供身份Tokens。Tokens认证必不可少。spring-doc.cadn.net.cn

更多细节,请参见示例spring-doc.cadn.net.cn

如果未提供凭证,插件会读取用户现有的 Docker 配置文件(通常位于$HOME/.docker/config.json)以确定认证方法。 通过这些方法,插件尝试为所请求的图像提供认证凭证。spring-doc.cadn.net.cn

该插件支持以下认证方法:spring-doc.cadn.net.cn

  • 凭证助手:在 Docker 配置文件中配置的外部工具,用于为特定注册库提供凭证。例如,像这样的工具osxkeychainECR-登录处理某些注册机构的身份验证。spring-doc.cadn.net.cn

  • 凭证存储:一种默认的备用机制,安全存储和检索凭证(例如,桌面适用于Docker Desktop)。spring-doc.cadn.net.cn

  • 静态凭据:直接存储在 Docker 配置文件中,下面是授权部分。spring-doc.cadn.net.cn

图像定制

该插件调用构建器来协调图像生成。 构建器包含多个构建包,可以检查应用程序以影响生成的图像。 默认情况下,插件会选择构建器镜像。 生成图像的名称是根据项目属性推导出来的。spring-doc.cadn.net.cn

任务属性可用于配置构建者在项目中的作方式。 下表总结了可用的属性及其默认值:spring-doc.cadn.net.cn

属性 命令行选项 描述 默认值

架构工人spring-doc.cadn.net.cn

--架构工人spring-doc.cadn.net.cn

使用建造器镜像的名称。spring-doc.cadn.net.cn

Paketobuildpacks/builder-noble-java-tiny:最新spring-doc.cadn.net.cn

信任构建器spring-doc.cadn.net.cn

——trustBuilderspring-doc.cadn.net.cn

是否应该把建造商当作值得信赖的人。spring-doc.cadn.net.cn

true如果建造者是以下之一paketobuildpacks/builder-noble-java-tiny,Paketobuildpacks/builder-jammy-java-tiny,Paketobuildpacks/builder-jammy-tiny,Paketobuildpacks/builder-jammy-base,Paketobuildpacks/builder-jammy-full(满载者),Paketobuildpacks/builder-jammy-buildpackless-tiny,Paketobuildpacks/builder-jammy-buildpackless-base(无构建包),Paketobuildpacks/builder-jammy-buildpackless-full,gcr.io/buildpacks/builder,赫罗库/建造者; false否则。spring-doc.cadn.net.cn

imagePlatformspring-doc.cadn.net.cn

--imagePlatformspring-doc.cadn.net.cn

任何被拉取的构建器、运行和构建包镜像的平台(作系统和架构)。 必须以 的形式出现作系统[/架构[/变体]]Linux/AMD 64,Linux/arm64Linux/ARM/V5. 请参阅所用构建器的文档,以确定可用的镜像作系统和架构选项。spring-doc.cadn.net.cn

没有默认值,表示应使用主机平台。spring-doc.cadn.net.cn

runImagespring-doc.cadn.net.cn

——runImagespring-doc.cadn.net.cn

使用运行图像的名称。spring-doc.cadn.net.cn

不应使用构建器元数据中指定的运行镜像的默认值。spring-doc.cadn.net.cn

imageNamespring-doc.cadn.net.cn

--imageNamespring-doc.cadn.net.cn

生成图像的图像名称spring-doc.cadn.net.cn

docker.io/library/${project.name}:${project.version}spring-doc.cadn.net.cn

pullPolicyspring-doc.cadn.net.cn

--pullPolicyspring-doc.cadn.net.cn

用来决定何时拉取构建器并从注册表运行映像的策略。 可接受的值为总是,从不IF_NOT_PRESENT.spring-doc.cadn.net.cn

总是spring-doc.cadn.net.cn

环境spring-doc.cadn.net.cn

应该传递给构建者的环境变量。spring-doc.cadn.net.cn

空。spring-doc.cadn.net.cn

构建包spring-doc.cadn.net.cn

构建者在构建镜像时应该使用的构建包。 只会使用指定的构建包,覆盖构建者中包含的默认构建包。 构建包引用必须以以下形式之一进行:spring-doc.cadn.net.cn

没有,说明建造者应该使用其中的构建包。spring-doc.cadn.net.cn

绑定spring-doc.cadn.net.cn

绑定挂载应该挂载到构建器容器上,这样可以构建映像。 在创建构建容器时,绑定会未解析且未验证地传递给 Docker。 装订必须采用以下形式之一:spring-doc.cadn.net.cn

哪里<选项>可包含:spring-doc.cadn.net.cn

网络spring-doc.cadn.net.cn

--网络spring-doc.cadn.net.cn

构建容器将被配置为使用的网络驱动。 在创建构建容器时,提供的值会在未验证的情况下传递给 Docker。spring-doc.cadn.net.cn

cleanCachespring-doc.cadn.net.cn

--cleanCachespring-doc.cadn.net.cn

是否在建造前清理缓存。spring-doc.cadn.net.cn

falsespring-doc.cadn.net.cn

verboseLogmingspring-doc.cadn.net.cn

支持对架构商作的详细记录。spring-doc.cadn.net.cn

falsespring-doc.cadn.net.cn

发布spring-doc.cadn.net.cn

--publishImagespring-doc.cadn.net.cn

是否将生成的镜像发布到Docker注册表。spring-doc.cadn.net.cn

falsespring-doc.cadn.net.cn

标签spring-doc.cadn.net.cn

一个或多个附加标签的列表,用于应用于生成图像。 提供给标签选项应该是完整的图片参考。 详情请参见标签部分spring-doc.cadn.net.cn

buildWorkspacespring-doc.cadn.net.cn

一个临时工作区,供构建器和构建包在构建映像时存储文件。 该值可以是命名卷或绑定挂载位置。spring-doc.cadn.net.cn

Docker 守护进程中的一个命名卷,名称源自镜像名。spring-doc.cadn.net.cn

build缓存spring-doc.cadn.net.cn

一个包含由构建包创建并用于图像构建过程的图层的缓存。 该值可以是命名卷或绑定挂载位置。spring-doc.cadn.net.cn

Docker 守护进程中的一个命名卷,名称源自镜像名。spring-doc.cadn.net.cn

launchCachespring-doc.cadn.net.cn

一个包含由构建包创建并用于镜像启动过程的层的缓存。 该值可以是命名卷或绑定挂载位置。spring-doc.cadn.net.cn

Docker 守护进程中的一个命名卷,名称源自镜像名。spring-doc.cadn.net.cn

创建日期spring-doc.cadn.net.cn

--创建日期spring-doc.cadn.net.cn

一个将用来设定创建生成图像元数据中的字段。 该值必须是ISO 8601即时格式中的字符串,或现在使用当前的日期和时间。spring-doc.cadn.net.cn

一个固定日期,以便构建可重复spring-doc.cadn.net.cn

applicationDirectoryspring-doc.cadn.net.cn

--applicationDirectoryspring-doc.cadn.net.cn

构建器镜像中应用内容将上传到的目录路径。 应用内容也会出现在生成图像的这个位置。spring-doc.cadn.net.cn

/工作spring-doc.cadn.net.cn

安全选项spring-doc.cadn.net.cn

——安全选项spring-doc.cadn.net.cn

安全选项将应用到构建器容器,以字符串数组形式提供spring-doc.cadn.net.cn

[“label=disable”]在Linux和macOS上,在Windows上[]spring-doc.cadn.net.cn

该插件通过 JavaPlugin 的目标兼容性财产。 使用默认的 Paketo 构建器和构建包时,插件会指示构建包安装相同的 Java 版本。 你可以像构建器配置示例中那样覆盖这个行为。
默认构建器Paketobuildpacks/builder-noble-java-tiny:最新包含简化的系统库集,且不包含 shell。 需要shell来运行启动脚本的应用程序,比如当应用插件应用到生成分发式zip压缩,或依赖于不存在的系统库的应用,应覆盖runImage配置以使用包含壳层和更广泛的系统库集的配置,例如paketobuildpacks/ubuntu-noble-run:最新.

标签格式

提供给标签选项应该是完整的图片参考。 公认的格式为[domainHost:port/][path/]name[:tag][@digest].spring-doc.cadn.net.cn

如果域名缺失,则默认为docker.io. 如果路径缺失,则默认为图书馆. 如果缺少标签,则默认为最近的.spring-doc.cadn.net.cn

举几个例子:spring-doc.cadn.net.cn

例子

自定义图像构建器和运行映像

如果你需要自定义用于创建镜像的构建器或用于启动构建镜像的运行镜像,请按照以下示例配置任务:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	builder = "mine/java-cnb-builder"
	runImage = "mine/java-cnb-run"
}
tasks.named<BootBuildImage>("bootBuildImage") {
	builder.set("mine/java-cnb-builder")
	runImage.set("mine/java-cnb-run")
}

该配置将使用带有名称的构建器镜像矿山/Java-CNB-构建器以及标签最近的,以及名为mine/java-cnb-run以及标签最近的.spring-doc.cadn.net.cn

构建器和运行镜像也可以在命令行中指定,如本例所示:spring-doc.cadn.net.cn

$ gradle bootBuildImage --builder=mine/java-cnb-builder --runImage=mine/java-cnb-run

建造者配置

如果构建者暴露了配置选项,这些选项可以通过环境财产。spring-doc.cadn.net.cn

以下是 Paketo Java 构建包在构建时配置 JVM 版本的示例:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	environment["BP_JVM_VERSION"] = "17"
}
tasks.named<BootBuildImage>("bootBuildImage") {
	environment.put("BP_JVM_VERSION", "17")
}

如果构建器运行的 Docker 守护进程和构建包下载工件的网络位置之间存在网络代理,你需要配置建构者使用该代理。 使用Paketo构建器时,可以通过设置HTTPS_PROXY和/或HTTP_PROXY环境变量如下例所示:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	environment["HTTP_PROXY"] = "http://proxy.example.com"
	environment["HTTPS_PROXY"] = "https://proxy.example.com"
}
tasks.named<BootBuildImage>("bootBuildImage") {
	environment.putAll(mapOf("HTTP_PROXY" to "http://proxy.example.com",
						"HTTPS_PROXY" to "https://proxy.example.com"))
}

运行时JVM 配置

Paketo Java 构建包通过设置JAVA_TOOL_OPTIONS环境变量。 构建包提供的版本JAVA_TOOL_OPTIONS值可以修改以定制应用镜像在容器中启动时的 JVM 运行时行为。spring-doc.cadn.net.cn

应存储在镜像中并应用于每次部署的环境变量修改,可以按照Paketo文档中的描述设置,并展示如下示例:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	environment["BPE_DELIM_JAVA_TOOL_OPTIONS"] = " "
	environment["BPE_APPEND_JAVA_TOOL_OPTIONS"] = "-XX:+HeapDumpOnOutOfMemoryError"
}
tasks.named<BootBuildImage>("bootBuildImage") {
	environment.putAll(mapOf(
		"BPE_DELIM_JAVA_TOOL_OPTIONS" to " ",
		"BPE_APPEND_JAVA_TOOL_OPTIONS" to "-XX:+HeapDumpOnOutOfMemoryError"
	))
}

自定义图片名称

默认情况下,图像名称是从以下名称以及版本项目中,类似这样的docker.io/library/${project.name}:${project.version}. 你可以通过设置任务属性来控制名称,如下示例所示:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	imageName = "example.com/library/${project.name}"
}
tasks.named<BootBuildImage>("bootBuildImage") {
	imageName.set("example.com/library/${project.name}")
}

注意,这种配置不提供显式标签,因此最近的被使用。 也可以指定标签,比如${project.version},构建中可用的任何属性或硬编码版本。spring-doc.cadn.net.cn

图像名称也可以在命令行中指定,如示例所示:spring-doc.cadn.net.cn

$ gradle bootBuildImage --imageName=example.com/library/my-app:v1

构建包

默认情况下,构建器会使用构建器镜像中包含的构建包,并按预定义顺序应用。 还可以提供一套替代的构建包,用于应用未包含在构建包中的构建包,或改变包含构建包的顺序。 当提供一个或多个构建包时,只有指定的构建包会被应用。spring-doc.cadn.net.cn

以下示例指示构建者使用一个自定义构建包,封装在.tgz文件,接着是构建器中包含的构建包。spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	buildpacks = ["file:///path/to/example-buildpack.tgz", "urn:cnb:builder:paketo-buildpacks/java"]
}
tasks.named<BootBuildImage>("bootBuildImage") {
	buildpacks.set(listOf("file:///path/to/example-buildpack.tgz", "urn:cnb:builder:paketo-buildpacks/java"))
}

构建包可以通过以下任何形式来指定。spring-doc.cadn.net.cn

位于CNB构建器中的构建包(如果构建器中只有一个构建包与buildpack-id):spring-doc.cadn.net.cn

一个指向包含构建包内容目录的路径(Windows不支持):spring-doc.cadn.net.cn

一个指向包含构建包内容的 gzip tar 文件的路径:spring-doc.cadn.net.cn

Image 出版

生成的镜像可以通过启用发布选择。spring-doc.cadn.net.cn

如果 Docker 注册表需要认证,凭证可以通过以下方式配置docker.publishRegistry性能。 如果 Docker 注册表不需要认证,那么docker.publishRegistry配置可以省略。spring-doc.cadn.net.cn

图像将被发布到的注册表由图像名称中的注册表部分决定(docker.example.com在这些例子中)。 如果docker.publishRegistry凭据配置包括网址该属性,该值传递给注册局,但不用于确定出版注册局的位置。
tasks.named("bootBuildImage") {
	imageName.set("docker.example.com/library/${project.name}")
	publish = true
	docker {
		publishRegistry {
			username = "user"
			password = "secret"
		}
	}
}
tasks.named<BootBuildImage>("bootBuildImage") {
	imageName.set("docker.example.com/library/${project.name}")
	publish.set(true)
	docker {
		publishRegistry {
			username.set("user")
			password.set("secret")
		}
	}
}

发布选项也可以在命令行中指定,如下示例所示:spring-doc.cadn.net.cn

$ gradle bootBuildImage --imageName=docker.example.com/library/my-app:v1 --publishImage

构建缓存与工作区配置

CNB 构建器缓存用于构建和启动映像时使用的层。默认情况下,这些缓存以命名卷的形式存储在 Docker 守护进程中,名称源自目标图像的全名。如果图像名称频繁更改,例如当项目版本作为图像名称中的标签时,缓存可能会频繁失效。spring-doc.cadn.net.cn

缓存卷可以配置为使用替代名称,以便更好地控制缓存生命周期,如下示例所示:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	buildCache {
		volume {
			name = "cache-${rootProject.name}.build"
		}
	}
	launchCache {
		volume {
			name = "cache-${rootProject.name}.launch"
		}
	}
}
tasks.named<BootBuildImage>("bootBuildImage") {
	buildCache {
		volume {
			name.set("cache-${rootProject.name}.build")
		}
	}
	launchCache {
		volume {
			name.set("cache-${rootProject.name}.launch")
		}
	}
}

构建器和构建包需要一个存放临时文件的地方,在构建映像时。默认情况下,这个临时构建工作区存储在一个命名卷中。spring-doc.cadn.net.cn

缓存和构建工作区可以配置为使用绑定挂载而非命名卷,如下示例所示:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	buildWorkspace {
		bind {
			source = "/tmp/cache-${rootProject.name}.work"
		}
	}
	buildCache {
		bind {
			source = "/tmp/cache-${rootProject.name}.build"
		}
	}
	launchCache {
		bind {
			source = "/tmp/cache-${rootProject.name}.launch"
		}
	}
}
tasks.named<BootBuildImage>("bootBuildImage") {
	buildWorkspace {
		bind {
			source.set("/tmp/cache-${rootProject.name}.work")
		}
	}
	buildCache {
		bind {
			source.set("/tmp/cache-${rootProject.name}.build")
		}
	}
	launchCache {
		bind {
			source.set("/tmp/cache-${rootProject.name}.launch")
		}
	}
}

Docker 配置

Docker Configuration for minikube

该插件可以与 minikube 提供的 Docker 守护进程通信,而非默认的本地连接。spring-doc.cadn.net.cn

在 Linux 和 macOS 上,环境变量可以通过以下命令设置Eval $(minikube Docker-env)在迷你久部启动之后。spring-doc.cadn.net.cn

插件还可以通过提供类似下例所示的连接细节来配置使用 minikube 守护进程:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	docker {
		host = "tcp://192.168.99.100:2376"
		tlsVerify = true
		certPath = "/home/user/.minikube/certs"
	}
}
tasks.named<BootBuildImage>("bootBuildImage") {
	docker {
		host.set("tcp://192.168.99.100:2376")
		tlsVerify.set(true)
		certPath.set("/home/user/.minikube/certs")
	}
}

Docker Configuration for podman

该插件可以与 podman 容器引擎通信。spring-doc.cadn.net.cn

该插件可以通过提供类似于下例所示的连接细节来配置为使用 Podman 本地连接:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	docker {
		host = "unix:///run/user/1000/podman/podman.sock"
		bindHostToBuilder = true
	}
}
tasks.named<BootBuildImage>("bootBuildImage") {
	docker {
		host.set("unix:///run/user/1000/podman/podman.sock")
		bindHostToBuilder.set(true)
	}
}
舱体人CLI安装了命令podman 信息 --format='{{.Host.RemoteSocket.Path}}'可以用来获得docker.host本例所示的配置性质。

Colima 的 Docker 配置

该插件可以与 Colima 提供的 Docker 守护进程通信。 这DOCKER_HOST环境变量可以通过以下命令设置:spring-doc.cadn.net.cn

$ export DOCKER_HOST=$(docker context inspect colima -f '{{.Endpoints.docker.Host}}')

插件还可以通过提供类似下例所示的连接细节来配置使用 Colima 守护进程:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	docker {
		host = "unix://${System.properties['user.home']}/.colima/docker.sock"
	}
}
tasks.named<BootBuildImage>("bootBuildImage") {
	docker {
		host.set("unix://${System.getProperty("user.home")}/.colima/docker.sock")
	}
}

身份验证用的 Docker 配置

如果构建器或运行镜像存储在支持用户认证的私有 Docker 注册表中,可以通过以下方式提供认证细节docker.builderRegistry如下例所示的性质:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	docker {
		builderRegistry {
			username = "user"
			password = "secret"
			url = "https://docker.example.com/v1/"
			email = "[email protected]"
		}
	}
}
tasks.named<BootBuildImage>("bootBuildImage") {
	docker {
		builderRegistry {
			username.set("user")
			password.set("secret")
			url.set("https://docker.example.com/v1/")
			email.set("[email protected]")
		}
	}
}

如果构建器或运行镜像存储在支持Tokens认证的私有 Docker 注册表中,则可以通过以下方式提供Tokens值docker.builderRegistry如下例所示:spring-doc.cadn.net.cn

tasks.named("bootBuildImage") {
	docker {
		builderRegistry {
			token = "9cbaf023786cd7..."
		}
	}
}
tasks.named<BootBuildImage>("bootBuildImage") {
	docker {
		builderRegistry {
			token.set("9cbaf023786cd7...")
		}
	}
}