使用 Docker Compose 的快速指南

Docker Compose 是一个与 Docker 原生集成的工具,让管理多容器应用程序变得轻而易举。

Docker Compose 提供的好处很多,其中包括:

  1. 轻松管理容器网络: 通过 Docker 网络连接两个容器在 Docker Compose 中非常简单,就像定义一个网络并告诉容器连接到它一样简单。 此外,Docker Compose 可以在您创建和销毁容器本身时自动创建和销毁网络。
  2. 容器依赖: 你有一个 Docker 容器,它需要另一个 Docker 容器来启动并运行,比如一个数据库。 Docker Compose 允许您为容器定义依赖项,要求依赖项启动并运行,然后才能启动其他任何操作。
  3. 可重现的设置: 由于容器设置将在创建任何内容之前定义,这允许设置的可重复性,从而更容易将它们转移到其他系统。 虽然理论上你可以在 Bash 之类的东西中这样做,但它会使事情变得不那么灵活并且更难适应变化。

在 Linux 上安装 Docker Compose

Docker Compose 在大多数发行版存储库中都很容易获得。

您可以使用以下命令在基于 Ubuntu 和 Debian 的发行版上安装 Docker Compose:

sudo apt install docker-compose

在 Arch 和 Manjaro 上,您可以使用:

sudo pacman -S docker-compose

在 Fedora,您可以使用 dnf 命令:

sudo dnf install docker-compose

在 CentOS 上安装 Docker Compose 时可能需要付出更多努力。

对于任何其他发行版,您始终可以查看 安装文档 有关获取所需软件包的信息。

创建我们的第一个 Docker Compose 文件

本指南假定您已经熟悉并熟悉 docker CLI 工具。 如果不是,请考虑这样做,否则您可能会遇到一堆简单的打嗝。

Docker Compose 文件存储在名称下 docker-compose.yml并在您运行时自动找到 docker-compose 同一目录中的命令。 你猜对了,它的语法采用 YAML 的形式。

如果您有兴趣了解 YAML 基础知识,我们有专门的教程。

我们将从一个创建 Nextcloud 实例的文件开始,然后回顾它实际上是如何做到的。

首先,您需要创建撰写文件。 在系统上创建一个空目录,然后创建 docker-compose.yml 文件。

接下来,用以下内容填充文件:

version: '3.5'
services:
  nextcloud_app:
    container_name: nextcloud_app
    image: nextcloud
    restart: unless-stopped
    networks:
      - nextcloud
    ports:
      - 80:80
    volumes:
      - ./data/app:/var/www/html
    depends_on:
      - nextcloud_mariadb

  nextcloud_mariadb:
    container_name: nextcloud_mariadb
    image: mariadb
    restart: unless-stopped
    networks:
      - nextcloud
    volumes:
      - ./data/mariadb:/var/lib/mysql
    environment:
      MARIADB_ROOT_PASSWORD: 'mariadb'

networks:
  nextcloud:
    name: nextcloud_docker_network

现在你所要做的就是 docker-compose up -d,并且您将使用 Docker 成功部署 Nextcloud。

这是Nextcloud的登录页面。

Nextcloud 安装

了解我们的 Docker Compose 文件

现在您已经看到该文件确实有效,让我们回顾一下文件的内容,以便您真正了解它到底在做什么。

“版本”标签

version: '3.5'

首先要做的事情是 version 标签。 这只是指定 Docker Compose 文件格式的版本,因为不同的版本会有不同的语法。 您通常希望将其保留为最新版本,但并非必须如此,如果您有一些旧文件,这会很有帮助。

“服务”标签

services:
  nextcloud_app:
    container_name: nextcloud_app
    image: nextcloud
    restart: unless-stopped
    networks:
      - nextcloud
    ports:
      - 80:80
    volumes:
      - ./data/app:/var/www/html
    depends_on:
      - nextcloud_mariadb

  nextcloud_mariadb:
    container_name: nextcloud_mariadb
    image: mariadb
    restart: unless-stopped
    networks:
      - nextcloud
    volumes:
      - ./data/mariadb:/var/lib/mysql
    environment:
      MARIADB_ROOT_PASSWORD: 'mariadb'

接下来,您会看到 services 标签。 这将启动创建的所有应用程序的列表 docker-compose up -d 被跑了。

接下来我们开始列出我们的第一个容器, nextcloud_app. 这用作应用程序的标识符,可供其他 Docker Compose 命令使用。 请注意,这 不是 容器本身的名称 – 在下一部分中指定。

现在,您开始定义有关容器的所有内容。 以下是对所有字段含义的复习,但如果您已经了解 Docker,大多数字段应该是不言自明的:

  • container_name – 定义容器的名称。 相当于 --name 选项。
  • image – 定义从容器中提取的图像。
  • restart – 定义容器的重启策略。 相当于 --restart.
  • networks – 定义容器连接的网络。 该网络可以创建,也可以已经存在。 此值用作标识符 docker-compose 并且不是网络的实际名称(在 networks 标签部分)。
  • ports – 定义容器可以连接的主机端口。 相当于 --publish.
  • volumes – 定义容器的体积。 相当于 --volume.
  • environment – 定义容器的环境变量。 相当于 --env. 此选项支持两种语法类型。 第一个是 variable: value,这就是这里使用的。 另一个选项,如果您习惯于 docker CLI 语法是 - variable=value.
  • depends_on – 指定容器依赖项。 这用于要求容器在其依赖项拥有之前不启动。 这接受来自容器列表的值。 (不是 container_name!)

“网络”标签

networks:
  nextcloud:
    name: nextcloud_docker_network

现在你到了 networks 标签。 这用于定义我们在下面列出的网络 networks 对于我们的容器。

在 – 的里面 networks 部分,您首先在下面列出您提供给网络的标识符 services. 在这里,那是 nextcloud.

接下来,您定义可以看到的网络名称 docker network ls. 在这里,我们将其命名为 nextcloud_docker_network.

如果您希望容器加入已经存在的网络,您将使用以下语法,替换 network_name 使用 Docker 网络的名称:

networks:
  nextcloud:
    external: true
    name: network_name

你去吧。 这总结了整个文件!

您可以将 yml 文件命名为任何名称,但在使用 docker-compose 命令时必须指定文件名。 保持传统并将其命名为 docker-compose.yml 以保持命令简短。

关闭

现在您了解了使用 Docker Compose 的基础知识,以及您可以通过使用它获得的好处。 现在,您还可以了解人们在通过 Compose 文件分发容器时在做什么。

有些东西不起作用,或者有一些挥之不去的问题? 欢迎您将它们留在下面的评论部分。