容器化应用程序

在本指南的其余部分,您将使用一个简单的待办事项列表管理器,它运行在 Node.js 上。如果您不熟悉 Node.js,请不要担心。本指南不需要任何 JavaScript 的先前经验。

先决条件

获取应用程序

在运行应用程序之前,您需要将应用程序源代码获取到您的机器上。

  1. 使用以下命令克隆 getting-started-app 仓库

    $ git clone https://github.com/docker/getting-started-app.git
    
  2. 查看克隆仓库的内容。您应该看到以下文件和子目录。

    ├── getting-started-app/
    │ ├── .dockerignore
    │ ├── package.json
    │ ├── README.md
    │ ├── spec/
    │ ├── src/
    │ └── yarn.lock

构建应用程序的镜像

要构建镜像,您需要使用 Dockerfile。Dockerfile 只是一个简单的文本文件,没有文件扩展名,其中包含指令脚本。Docker 使用此脚本构建容器镜像。

  1. getting-started-app 目录中(与 package.json 文件相同的目录),创建一个名为 Dockerfile 的文件,内容如下:

    # syntax=docker/dockerfile:1
    
    FROM node:lts-alpine
    WORKDIR /app
    COPY . .
    RUN yarn install --production
    CMD ["node", "src/index.js"]
    EXPOSE 3000

    此 Dockerfile 从 node:lts-alpine 基础镜像开始,这是一个轻量级的 Linux 镜像,预装了 Node.js 和 Yarn 包管理器。它将所有源代码复制到镜像中,安装必要的依赖项并启动应用程序。

  2. 使用以下命令构建镜像:

    在终端中,确保您位于 getting-started-app 目录中。将 /path/to/getting-started-app 替换为您 getting-started-app 目录的路径。

    $ cd /path/to/getting-started-app
    

    构建镜像。

    $ docker build -t getting-started .
    

    docker build 命令使用 Dockerfile 构建一个新镜像。您可能已经注意到 Docker 下载了很多“层”。这是因为您指示构建器要从 node:lts-alpine 镜像开始。但是,由于您的机器上没有该镜像,因此 Docker 需要下载该镜像。

    Docker 下载镜像后,Dockerfile 中的指令会复制您的应用程序并使用 yarn 安装应用程序的依赖项。CMD 指令指定从该镜像启动容器时要运行的默认命令。

    最后,-t 标志标记您的镜像。可以将其视为最终镜像的人类可读名称。由于您将镜像命名为 getting-started,因此在运行容器时可以参考该镜像。

    docker build 命令末尾的 . 告诉 Docker 应该在当前目录中查找 Dockerfile

启动应用程序容器

现在您有了镜像,可以使用 docker run 命令在容器中运行应用程序。

  1. 使用 docker run 命令运行您的容器,并指定您刚刚创建的镜像的名称:

    $ docker run -d -p 127.0.0.1:3000:3000 getting-started
    

    -d 标志(代表 --detach)在后台运行容器。这意味着 Docker 启动您的容器并返回到终端提示符。

    -p 标志(代表 --publish)在主机和容器之间创建端口映射。-p 标志采用 HOST:CONTAINER 格式的字符串值,其中 HOST 是主机上的地址,CONTAINER 是容器上的端口。该命令将容器的 3000 端口发布到主机上的 127.0.0.1:3000 (localhost:3000)。如果没有端口映射,您将无法从主机访问应用程序。

  2. 几秒钟后,在您的 Web 浏览器中打开 http://localhost:3000。您应该看到您的应用程序。

    Empty todo list
  3. 添加一两个项目,看看它是否按预期工作。您可以将项目标记为已完成并将其删除。您的前端已成功地将项目存储在后端。

此时,您有一个运行的待办事项列表管理器,其中包含一些项目。

如果您快速查看您的容器,您应该会看到至少一个正在运行的容器,该容器使用 getting-started 镜像并在 3000 端口上运行。要查看您的容器,您可以使用 CLI 或 Docker Desktop 的图形界面。


在终端中运行 docker ps 命令以列出您的容器。

$ docker ps

应该出现类似以下的输出。

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                      NAMES
df784548666d        getting-started     "docker-entrypoint.s…"   2 minutes ago       Up 2 minutes        127.0.0.1:3000->3000/tcp   priceless_mcclintock

在 Docker Desktop 中,选择“容器”选项卡以查看容器列表。

Docker Desktop with get-started container running

总结

在本节中,您学习了关于创建 Dockerfile 以构建镜像的基础知识。构建镜像后,您启动了一个容器并看到了正在运行的应用程序。

相关信息

后续步骤

接下来,您将修改您的应用程序,并学习如何使用新镜像更新正在运行的应用程序。在此过程中,您还将学习一些其他有用的命令。