将栈部署到 Swarm

目录

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

注意

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

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

要完成本教程，您需要：

  1. 在Swarm模式下运行的Docker Engine。如果您不熟悉Swarm模式，您可能需要阅读Swarm模式关键概念和服务的工作原理。

    注意

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

    如果您已经运行多节点Swarm，请记住所有docker stack和docker service命令都必须从管理器节点运行。

  2. 当前版本的Docker Compose。

设置Docker注册表

由于Swarm由多个Docker Engine组成，因此需要注册表才能将镜像分发给所有Engine。您可以使用Docker Hub或维护您自己的注册表。以下是如何创建一个临时注册表，您可以稍后将其丢弃。

  1. 在您的Swarm上作为服务启动注册表

    $ 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镜像则会拉取它，并创建两个容器。

    您会看到关于引擎处于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

  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

堆栈现在已准备好部署。

将堆栈部署到Swarm

  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。如果您拥有多节点Swarm，这可能需要一些时间，因为需要拉取镜像。

    和之前一样，您可以使用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内置的路由网格，您可以访问Swarm中任何节点的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.