使用内容信任实现自动化
目录
将 Docker 内容信任内置到现有自动化系统中是非常普遍的。为了让工具能够封装 Docker 并推送受信任的内容,可以通过环境变量传递给客户端。
本指南遵循 使用 Docker 内容信任为镜像签名 中描述的步骤。请确保您理解并遵循先决条件。
当直接使用 Notary 客户端时,它会使用其自己的一套环境变量。
添加委托私钥
为了自动化将委托私钥导入本地 Docker 信任库,我们需要为新密钥传递一个密码。每次该委托对标签进行签名时,都需要这个密码。
$ export DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE="mypassphrase123"
$ docker trust key load delegation.key --name jeff
Loading key from "delegation.key"...
Successfully imported key from delegation.key
添加委托公钥
如果您在添加委托公钥的同时初始化一个仓库,那么您将需要使用本地 Notary 规范根密钥的密码来创建仓库的信任数据。如果仓库已经初始化,那么您只需要仓库的密码。
# Export the Local Root Key Passphrase if required.
$ export DOCKER_CONTENT_TRUST_ROOT_PASSPHRASE="rootpassphrase123"
# Export the Repository Passphrase
$ export DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE="repopassphrase123"
# Initialize Repo and Push Delegation
$ docker trust signer add --key delegation.crt jeff registry.example.com/admin/demo
Adding signer "jeff" to registry.example.com/admin/demo...
Initializing signed repository for registry.example.com/admin/demo...
Successfully initialized "registry.example.com/admin/demo"
Successfully added signer: registry.example.com/admin/demo
为镜像签名
最后,在为镜像签名时,我们需要导出签名密钥的密码。这是在通过 $ docker trust key load 将密钥加载到本地 Docker 信任库时创建的。
$ export DOCKER_CONTENT_TRUST_REPOSITORY_PASSPHRASE="mypassphrase123"
$ docker trust sign registry.example.com/admin/demo:1
Signing and pushing trust data for local image registry.example.com/admin/demo:1, may overwrite remote trust data
The push refers to repository [registry.example.com/admin/demo]
428c97da766c: Layer already exists
2: digest: sha256:1a6fd470b9ce10849be79e99529a88371dff60c60aab424c077007f6979b4812 size: 524
Signing and pushing trust metadata
Successfully signed registry.example.com/admin/demo:1
使用内容信任进行构建
您还可以使用内容信任进行构建。在运行 docker build 命令之前,您应该手动或以脚本方式设置环境变量 DOCKER_CONTENT_TRUST。请看下面这个简单的 Dockerfile。
# syntax=docker/dockerfile:1
FROM docker/trusttest:latest
RUN echoFROM 标签正在拉取一个已签名的镜像。您不能构建一个其 FROM 镜像既不存在于本地也未被签名的镜像。假设 latest 标签存在内容信任数据,那么以下构建应该会成功。
$ docker build -t docker/trusttest:testing .
Using default tag: latest
latest: Pulling from docker/trusttest
b3dbab3810fc: Pull complete
a9539b34a6ab: Pull complete
Digest: sha256:d149ab53f871
如果启用了内容信任,从依赖于没有信任数据的标签的 Dockerfile 构建,会导致构建命令失败。
$ docker build -t docker/trusttest:testing .
unable to process Dockerfile: No trust data for notrust