介绍

本指南的起始资源包括一个简单的 Go 项目和一个 Dockerfile。从这个起点开始，本指南说明了可以改进使用 Docker 构建应用程序的各种方法。

环境设置

要遵循本指南：

  1. 安装 Docker Desktop 或 Docker Engine
  2. 从GitHub 上的应用程序示例克隆或创建新存储库

应用程序

本指南的示例项目是一个客户端-服务器应用程序，用于将消息翻译为虚构语言。

以下是项目中包含的文件的概述：

.
├── Dockerfile
├── cmd
│   ├── client
│   │   ├── main.go
│   │   ├── request.go
│   │   └── ui.go
│   └── server
│       ├── main.go
│       └── translate.go
├── go.mod
└── go.sum

该cmd/目录包含两个应用程序组件的代码：客户端和服务器。客户端是用于编写、发送和接收消息的用户界面。服务器接收来自客户端的消息，对其进行翻译，然后将其发送回客户端。

Dockerfile

Dockerfile 是一个文本文档，您可以在其中定义应用程序的构建步骤。您可以使用特定于域的语言（称为 Dockerfile 语法）编写 Dockerfile。

以下是用作本指南起点的 Dockerfile：

# syntax=docker/dockerfile:1
FROM golang:1.21-alpine
WORKDIR /src
COPY . .
RUN go mod download
RUN go build -o /bin/client ./cmd/client
RUN go build -o /bin/server ./cmd/server
ENTRYPOINT [ "/bin/server" ]

这是这个 Dockerfile 的作用：

  1. # syntax=docker/dockerfile:1

    该注释是一个 Dockerfile 解析器指令。它指定要使用哪个版本的 Dockerfile 语法。该文件使用dockerfile:1最佳实践的语法：它确保您可以访问最新的 Docker 构建功能。

  2. FROM golang:1.21-alpine

    该FROM指令使用1.21-alpine官方golang镜像版本。

  3. WORKDIR /src

    /src在容器内创建工作目录。

  4. COPY . .

    将构建上下文中的文件复制到容器中的工作目录。

  5. RUN go mod download

    将必要的 Go 模块下载到容器中。 Go 模块是 Go 编程语言的依赖管理工具，类似于 npm installJavaScript 或pip installPython。

  6. RUN go build -o /bin/client ./cmd/client

    构建client二进制文件，用于将要翻译的消息发送到 /bin目录中。

  7. RUN go build -o /bin/server ./cmd/server

    server将侦听客户端翻译请求的二进制文件构建到/bin目录中。

  8. ENTRYPOINT [ "/bin/server" ]

    指定容器启动时运行的命令。启动服务器进程。

构建图像

要使用 Dockerfile 构建映像，请使用docker命令行工具。构建镜像的命令是docker build。

运行以下命令来构建映像。

$ docker build --tag=buildme .

这将创建一个带有标签的图像buildme。图像标签是图像的名称。

运行容器

您刚刚构建的映像包含两个二进制文件，一个用于服务器，一个用于客户端。要查看正在运行的翻译服务，请运行托管服务器组件的容器，然后运行另一个调用客户端的容器。

要运行容器，您可以使用该docker run命令。

  1. 以分离模式从映像运行容器。

    $ docker run --name=buildme --rm --detach buildme

    这将启动一个名为 的容器buildme。

  2. buildme在调用客户端二进制文件的容器中运行新命令。

    $ docker exec -it buildme /bin/client

该docker exec命令打开一个终端用户界面，您可以在其中提交消息以供后端（服务器）进程进行翻译。

完成测试后，您可以停止容器：

$ docker stop buildme

概括

本节概述了本指南中使用的示例应用程序，介绍了 Dockerfile 和构建。您已成功构建容器映像并从中创建了容器。

相关信息：

下一步

下一节将探讨如何使用图层缓存来提高构建速度。

层数