将堆栈部署到群集

目录

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

注意

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

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

要运行本教程，您需要：

  1. 一个在 Swarm模式下运行的Docker引擎。 如果你不熟悉Swarm模式，你可能需要阅读 Swarm模式关键概念 和 服务如何工作。

    注意

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

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

  2. 当前版本的 Docker Compose。

设置一个Docker注册表

因为一个集群由多个Docker引擎组成，所以需要一个注册表来将镜像分发到所有引擎。你可以使用Docker Hub或维护你自己的注册表。以下是如何创建一个可丢弃的注册表，之后你可以将其丢弃。

  1. 在你的集群上以服务形式启动注册表：

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

  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，它可能仍在拉取镜像。

  3. 检查它是否与curl一起工作：

    $ curl http://localhost:5000/v2/

{}

创建示例应用程序

本指南中使用的应用程序基于 Docker Compose 入门指南中的点击计数器应用程序。它由 一个Python应用程序组成，该应用程序在Redis实例中维护一个计数器，并在每次访问时增加 计数器。

  1. 为项目创建一个目录：

    $ mkdir stackdemo
$ cd stackdemo

  2. 在项目目录中创建一个名为 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)

  3. 创建一个名为 requirements.txt 的文件，并将以下两行粘贴进去：

    flask
redis

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

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

  5. 创建一个名为 compose.yml 的文件并粘贴以下内容：

      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测试应用程序

  1. 使用docker compose up启动应用程序。这将构建Web应用程序镜像，如果尚未拥有Redis镜像，则会拉取Redis镜像，并创建两个容器。

    您会看到一个关于引擎处于群集模式的警告。这是因为Compose没有利用群集模式，而是将所有内容部署到单个节点。您可以安全地忽略此警告。

    $ 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

  2. 检查应用程序是否正在运行，使用 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.

  3. 关闭应用程序：

    $ 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

堆栈现在已准备好部署。

将堆栈部署到集群

  1. 使用docker stack deploy创建堆栈：

    $ docker stack deploy --compose-file compose.yml stackdemo

Ignoring unsupported options: build

Creating network stackdemo_default
Creating service stackdemo_web
Creating service stackdemo_redis

    最后一个参数是堆栈的名称。每个网络、卷和服务名称都以堆栈名称为前缀。

  2. 使用docker stack services stackdemo检查它是否正在运行：

    $ docker stack services stackdemo

ID            NAME             MODE        REPLICAS  IMAGE
orvjk2263y1p  stackdemo_redis  replicated  1/1       redis:3.2-alpine@sha256:f1ed3708f538b537eb9c2a7dd50dc90a706f7debd7e1196c9264edeea521a86d
s1nf0xy8t1un  stackdemo_web    replicated  1/1       127.0.0.1:5000/stackdemo@sha256:adb070e0805d04ba2f92c724298370b7a4eb19860222120d43e0f6351ddbc26f

    一旦运行，你应该会在REPLICAS下看到两个服务的1/1。 如果你有一个多节点的集群，这可能需要一些时间，因为需要拉取镜像。

    和之前一样，你可以使用 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的内置路由网格，您可以在端口8000上访问群集中的任何节点，并被路由到应用程序：

    $ curl http://address-of-other-node:8000
Hello World! I have been seen 4 times.

  3. 使用docker stack rm将堆栈降下：

    $ docker stack rm stackdemo

Removing service stackdemo_web
Removing service stackdemo_redis
Removing network stackdemo_default

  4. 使用docker service rm关闭注册表：

    $ docker service rm registry

  5. 如果你只是在本地机器上测试一些东西，并想让你的Docker引擎退出Swarm模式，使用docker swarm leave：

    $ docker swarm leave --force

Node left the swarm.