切换语言

构建、标记和发布镜像

目录

解释

在本指南中，您将了解以下内容：

  • 构建镜像 - 基于Dockerfile
  • 标记镜像 - 为镜像命名的过程，该过程还决定了镜像的分发位置
  • 发布镜像 - 使用容器注册表分发或共享新创建的镜像的过程

构建镜像

大多数情况下，镜像是使用 Dockerfile 构建的。最基本的命令可能如下所示：docker build

docker build .

命令中的 final 提供生成上下文的路径或 URL。在此位置，生成器将找到 和其他引用的文件。.Dockerfile

当您运行构建时，构建器会根据需要提取基础镜像，然后运行 Dockerfile 中指定的指令。

使用上一个命令时，镜像将没有名称，但输出将提供镜像的 ID。例如，前面的命令可能会生成以下输出：

$ docker build .
[+] Building 3.5s (11/11) FINISHED                                              docker:desktop-linux
 => [internal] load build definition from Dockerfile                                            0.0s
 => => transferring dockerfile: 308B                                                            0.0s
 => [internal] load metadata for docker.io/library/python:3.12                                  0.0s
 => [internal] load .dockerignore                                                               0.0s
 => => transferring context: 2B                                                                 0.0s
 => [1/6] FROM docker.io/library/python:3.12                                                    0.0s
 => [internal] load build context                                                               0.0s
 => => transferring context: 123B                                                               0.0s
 => [2/6] WORKDIR /usr/local/app                                                                0.0s
 => [3/6] RUN useradd app                                                                       0.1s
 => [4/6] COPY ./requirements.txt ./requirements.txt                                            0.0s
 => [5/6] RUN pip install --no-cache-dir --upgrade -r requirements.txt                          3.2s
 => [6/6] COPY ./app ./app                                                                      0.0s
 => exporting to image                                                                          0.1s
 => => exporting layers                                                                         0.1s
 => => writing image sha256:9924dfd9350407b3df01d1a0e1033b1e543523ce7d5d5e2c83a724480ebe8f00    0.0s

在前面的输出中，您可以使用引用的镜像启动容器：

docker run sha256:9924dfd9350407b3df01d1a0e1033b1e543523ce7d5d5e2c83a724480ebe8f00

这个名字肯定不会让人记住，这就是标记变得有用的地方。

标记镜像

标记镜像是提供具有令人难忘名称的镜像的方法。但是，镜像的名称有一个结构。完整镜像名称具有以下结构：

[HOST[:PORT_NUMBER]/]PATH[:TAG]
  • HOST：镜像所在的可选注册表主机名。如果未指定主机，则默认使用 Docker 的公共注册表 at。docker.io
  • PORT_NUMBER：注册表端口号（如果提供了主机名）
  • PATH：镜像的路径，由斜杠分隔的组件组成。对于 Docker Hub，格式遵循 ，其中 namespace 是用户或组织的名称。如果未指定命名空间，则使用 Docker 官方镜像的命名空间。[NAMESPACE/]REPOSITORYlibrary
  • TAG：一种自定义的、人类可读的标识符，通常用于标识镜像的不同版本或变体。如果未指定 tag，则默认使用 。latest

镜像名称的一些示例包括：

  • nginx，等效于 ：这将从注册表、命名空间、镜像存储库和标记中提取镜像。docker.io/library/nginx:latestdocker.iolibrarynginxlatest
  • docker/welcome-to-docker，相当于 ：这会从注册表、命名空间、镜像存储库和标签中提取镜像docker.io/docker/welcome-to-docker:latestdocker.iodockerwelcome-to-dockerlatest
  • ghcr.io/dockersamples/example-voting-app-vote:pr-311：从 GitHub Container Registry、命名空间、镜像仓库和标签中提取镜像dockersamplesexample-voting-app-votepr-311

要在构建过程中标记镜像，请添加 or 标志：-t--tag

docker build -t my-username/my-image .

如果您已经构建了镜像，则可以使用 docker image tag 命令向镜像添加另一个标签：

docker image tag my-username/my-image another-username/another-image:v1

发布镜像

构建并标记镜像后，您就可以将其推送到注册表了。为此，请使用 docker push 命令：

docker push my-username/my-image

在几秒钟内，镜像的所有层都将推送到注册表。

需要身份验证

在将镜像推送到存储库之前，您需要进行身份验证。 为此，只需使用 docker login 命令即可。

试用

在本动手指南中，您将使用提供的 Dockerfile 构建一个简单的镜像，并将其推送到 Docker Hub。

建立

  1. 获取示例应用程序。

    如果您有 Git，则可以克隆示例应用程序的存储库。否则，您可以下载示例应用程序。选择以下选项之一。

    在终端中使用以下命令克隆示例应用程序存储库。

    $ git clone https://github.com/docker/getting-started-todo-app

    下载源代码并解压缩。

    下载源代码

  2. 下载并安装Docker 桌面。

  3. 如果您还没有 Docker 帐户，请立即创建一个。完成此操作后，使用该帐户登录到 Docker Desktop。

构建镜像

现在，您在 Docker Hub 上已经有了存储库，是时候构建镜像并将其推送到存储库了。

  1. 使用示例应用程序存储库根目录中的终端，运行以下命令。替换为您的 Docker Hub 用户名：YOUR_DOCKER_USERNAME

    $ docker build -t <YOUR_DOCKER_USERNAME>/concepts-build-image-demo .

    例如，如果您的用户名是 ，您将运行以下命令：mobywhale

    $ docker build -t mobywhale/concepts-build-image-demo .

  2. 构建完成后，您可以使用以下命令查看镜像：

    $ docker image ls

    该命令将生成类似于以下内容的输出：

    REPOSITORY                             TAG       IMAGE ID       CREATED          SIZE
mobywhale/concepts-build-image-demo    latest    746c7e06537f   24 seconds ago   354MB

  3. 您实际上可以使用 docker image history 命令查看历史记录（或镜像的创建方式）：

    $ docker image history mobywhale/concepts-build-image-demo

    然后，您将看到类似于以下内容的输出：

    IMAGE          CREATED         CREATED BY                                      SIZE      COMMENT
f279389d5f01   8 seconds ago   CMD ["node" "./src/index.js"]                   0B        buildkit.dockerfile.v0
<missing>      8 seconds ago   EXPOSE map[3000/tcp:{}]                         0B        buildkit.dockerfile.v0 
<missing>      8 seconds ago   WORKDIR /app                                    8.19kB    buildkit.dockerfile.v0
<missing>      4 days ago      /bin/sh -c #(nop)  CMD ["node"]                 0B
<missing>      4 days ago      /bin/sh -c #(nop)  ENTRYPOINT ["docker-entry…   0B
<missing>      4 days ago      /bin/sh -c #(nop) COPY file:4d192565a7220e13…   20.5kB
<missing>      4 days ago      /bin/sh -c apk add --no-cache --virtual .bui…   7.92MB
<missing>      4 days ago      /bin/sh -c #(nop)  ENV YARN_VERSION=1.22.19     0B
<missing>      4 days ago      /bin/sh -c addgroup -g 1000 node     && addu…   126MB
<missing>      4 days ago      /bin/sh -c #(nop)  ENV NODE_VERSION=20.12.0     0B
<missing>      2 months ago    /bin/sh -c #(nop)  CMD ["/bin/sh"]              0B
<missing>      2 months ago    /bin/sh -c #(nop) ADD file:d0764a717d1e9d0af…   8.42MB

    此输出显示镜像的图层，突出显示您添加的图层以及从基础镜像继承的图层。

推送镜像

现在您已经构建了镜像，是时候将镜像推送到注册表了。

  1. 使用 docker push 命令推送镜像：

    $ docker push <YOUR_DOCKER_USERNAME>/concepts-build-image-demo

    如果您收到 ，请确保您都已登录，并且您的 Docker 用户名在 image 标记中是正确的。requested access to the resource is denied

    片刻之后，您的镜像应该被推送到 Docker Hub。

其他资源

要了解有关构建、标记和发布镜像的更多信息，请访问以下资源：

后续步骤

现在，您已经了解了如何构建和发布镜像，是时候学习如何使用 Docker 构建缓存来加快构建过程了。

使用构建缓存