将堆栈部署到 Swarm

Table of contents

当 Docker Engine 在 swarm 模式下运行时，您可以使用 docker stack deploy 将完整的应用程序堆栈部署到 swarm。deploy 命令接受以 Compose 文件形式描述的堆栈。

Note

docker stack deploy 命令使用的是旧版 Compose 文件版本 3 格式，该格式由 Compose V1 使用。最新的格式由 Compose 规范定义，与 docker stack deploy 命令不兼容。

有关 Compose 演进的更多信息，请参阅 Compose 历史。

要完成本教程，您需要：

一台在 Swarm 模式下运行的 Docker Engine。如果您不熟悉 Swarm 模式，建议先阅读 Swarm 模式关键概念和服务工作原理。

Note

如果您是在本地开发环境中尝试操作，可以使用 docker swarm init 将您的引擎置于 Swarm 模式。

如果您已经运行了一个多节点 swarm，请记住所有 docker stack 和 docker service 命令都必须从管理节点运行。
当前版本的 Docker Compose。

设置 Docker 注册表

由于 swarm 由多个 Docker Engine 组成，因此需要一个注册表来将镜像分发到所有节点。您可以使用 Docker Hub 或维护自己的注册表。以下是创建一个临时注册表的方法，使用后可以丢弃。

在您的 swarm 上将注册表作为服务启动：

$ docker service create --name registry --publish published=5000,target=5000 registry:2

使用 docker service ls 检查其状态：

$ docker service ls

ID            NAME      REPLICAS  IMAGE                                                                               COMMAND
l7791tpuwkco  registry  1/1       registry:2@sha256:1152291c7f93a4ea2ddc95e46d142c31e743b6dd70e194af9e6ebe530f782c17

当 REPLICAS 列显示 1/1 时，表示服务正在运行。如果显示 0/1，则可能仍在拉取镜像。

使用 curl 检查其是否正常工作：
$ curl http://127.0.0.1:5000/v2/ {}

创建示例应用程序

本指南中使用的应用程序基于开始使用 Docker Compose 指南中的点击计数器应用。它包含一个 Python 应用，该应用在 Redis 实例中维护一个计数器，并在每次访问时递增该计数器。

为项目创建一个目录：
$ mkdir stackdemo $ cd stackdemo

在项目目录中创建一个名为 app.py 的文件，并粘贴以下内容：

from flask import Flask
from redis import Redis

app = Flask(__name__)
redis = Redis(host='redis', port=6379)

@app.route('/')
def hello():
    count = redis.incr('hits')
    return 'Hello World! I have been seen {} times.\n'.format(count)

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000, debug=True)

创建一个名为 requirements.txt 的文件，并粘贴以下两行：
flask redis

创建一个名为 Dockerfile 的文件，并粘贴以下内容：

# syntax=docker/dockerfile:1
FROM python:3.4-alpine
ADD . /code
WORKDIR /code
RUN pip install -r requirements.txt
CMD ["python", "app.py"]

创建一个名为 compose.yaml 的文件，并粘贴以下内容：
services: web: image: 127.0.0.1:5000/stackdemo build: . ports: - "8000:8000" redis: image: redis:alpine
web 应用的镜像是使用上面定义的 Dockerfile 构建的。它也被标记为 127.0.0.1:5000 - 即之前创建的注册表地址。这在将应用程序分发到 swarm 时非常重要。

使用 Compose 测试应用程序

使用 docker compose up 启动应用程序。这将构建 web 应用镜像，如果您没有 Redis 镜像则会拉取它，并创建两个容器。

您会看到一条关于 Engine 正在 swarm 模式下运行的警告。这是因为 Compose 不利用 swarm 模式，而是将所有内容部署到单个节点。您可以安全地忽略此警告。

$ docker compose up -d

WARNING: The Docker Engine you're using is running in swarm mode.

Compose does not use swarm mode to deploy services to multiple nodes in
a swarm. All containers are scheduled on the current node.

To deploy your application across the swarm, use `docker stack deploy`.

Creating network "stackdemo_default" with the default driver
Building web
...(build output)...
Creating stackdemo_redis_1
Creating stackdemo_web_1

使用 docker compose ps 检查应用程序是否正在运行：

$ docker compose ps

      Name                     Command               State           Ports
-----------------------------------------------------------------------------------
stackdemo_redis_1   docker-entrypoint.sh redis ...   Up      6379/tcp
stackdemo_web_1     python app.py                    Up      0.0.0.0:8000->8000/tcp

您可以使用 curl 测试应用程序：

$ curl http://localhost:8000
Hello World! I have been seen 1 times.

$ curl http://localhost:8000
Hello World! I have been seen 2 times.

$ curl http://localhost:8000
Hello World! I have been seen 3 times.

关闭应用程序：

$ docker compose down --volumes

Stopping stackdemo_web_1 ... done
Stopping stackdemo_redis_1 ... done
Removing stackdemo_web_1 ... done
Removing stackdemo_redis_1 ... done
Removing network stackdemo_default

将生成的镜像推送到注册表

为了将 web 应用的镜像分发到整个 swarm，需要将其推送到您之前设置的注册表。使用 Compose，这非常简单：

$ docker compose push

Pushing web (127.0.0.1:5000/stackdemo:latest)...
The push refers to a repository [127.0.0.1:5000/stackdemo]
5b5a49501a76: Pushed
be44185ce609: Pushed
bd7330a79bcf: Pushed
c9fc143a069a: Pushed
011b303988d2: Pushed
latest: digest: sha256:a81840ebf5ac24b42c1c676cbda3b2cb144580ee347c07e1bc80e35e5ca76507 size: 1372

现在堆栈已准备好进行部署。