该文为《深入浅出Docker》的学习笔记，感谢查看，如有错误，欢迎指正

一、简介

Docker Stack 是为了解决大规模场景下的多服务部署和管理，提供了期望状态，滚动升级，简单易用，扩缩容，健康检查等特性，并且都封装在一个声明式模型当中。

  • Docker Stack 部署应用的生命周期：初始化部署 > 健康检查 > 扩容 > 更新 > 回滚。
  • 使用单一声明式文件即可完成部署，即只需要docker-stack.yml文件，使用docker stack deploy命令即可完成部署。
  • stack 文件其实就是 Docker compose 文件，唯一的要求就是 version 需要为 3.0 或者更高的值。
  • Stack 完全集成到了 Docker 中，不像 compose 还需要单独安装。

Docker 适用于开发和测试，而 Docker Stack 则适用于大规模场景和生产环境

二、docker-stack.yml文件详解

从 GitHub 中拉取示例代码，分析其中的 docker-stack.yml 文件

[root@huanzi-001 daemon]# git clone https://github.com/dockersamples/atsea-sample-shop-app.git

可以看到有 5 个服务，3 个网络，4 个秘钥，3 组端口映射；

services:

  reverse_proxy:

  database:

  appserver:

  visualizer:

  payment_gateway:


networks:

  front-tier:

  back-tier:

  payment:


secrets:

  postgres_password:

  staging_token:

  revprox_key:

  revprox_cert:
2.1 网络

Docker 根据 stack 文件部署的时候，第一步会检查并创建 networks：关键字对应的网络。默认会创建覆盖网络（overlay），并且控制层会加密，如果需要对数据层加密，可以在 stack 文件的 driver_opts 之下指定 encrypted:'yes'，数据层加密会导致额外开销，但是一般不会超过10%。

networks:

  front-tier:

  back-tier:

  payment:

    driver: overlay

    driver_opts:

      encrypted: 'yes'

3 个网络都会先于秘钥和服务被创建

2.2 秘钥

当前 Stack 文件中定义了 4 个秘钥，并且都是external，这表示在 Stack 部署前，这些秘钥必须已存在

secrets:

  postgres_password:

    external: true

  staging_token:

    external: true

  revprox_key:

    external: true

  revprox_cert:

    external: true
2.3 服务

总共有 5 个服务，我们依次进行分析

2.3.1 reverse_proxy 服务

reverse_proxy:

    image: dockersamples/atseasampleshopapp_reverse_proxy

    ports:

      - "80:80"

      - "443:443"

    secrets:

      - source: revprox_cert

        target: revprox_cert

      - source: revprox_key

        target: revprox_key

    networks:

      - front-tier
  • image：必填项，指定了用于构建服务副本的 Docker 镜像
  • ports：Swarm 节点的 80 端口映射到副本的 80 端口，443 端口映射到副本的 443 端口
  • secrets：2 个秘钥以普通文件形式挂载至服务副本中，文件名称就是 target 属性的值，路径为/run/secrets
  • networks：所有副本都会连接到 front-tier 网络，如果定义的网络不存在，Docker 会以 Overlay 的网络方式新建一个

2.3.2 database 服务

database:

    image: dockersamples/atsea_db

    environment:

      POSTGRES_USER: gordonuser

      POSTGRES_DB_PASSWORD_FILE: /run/secrets/postgres_password

      POSTGRES_DB: atsea

    networks:

      - back-tier

    secrets:

      - postgres_password

    deploy:

      placement:

        constraints:

          - 'node.role == worker'

多了以下几项：

  • environment：环境变量，定义了数据库用户，密码位置，数据库名称
  • deploy：部署约束，服务只运行在 Swarm 集群的 Worker 节点上

Swarm 目前允许以下几种部署约束方式：

  • 节点 ID ：node.id == 85v90bioyy4s2fst4fa5vrlvf
  • 节点名称：node.hostname == huanzi-002
  • 节点角色：node.role != manager
  • 节点引擎标签：engine.labels.operatingsystem == Centos 7.5
  • 节点自定义标签：node.labels.zone == test01

支持==和!=操作。

2.3.3 appserver 服务

appserver:

    image: dockersamples/atsea_app

    networks:

      - front-tier

      - back-tier

      - payment

    deploy:

      replicas: 2

      update_config:

        parallelism: 2

        failure_action: rollback

      placement:

        constraints:

          - 'node.role == worker'

      restart_policy:

        condition: on-failure

        delay: 5s

        max_attempts: 3

        window: 120s

    secrets:

      - postgres_password
  • deploy-replicas：部署的服务副本数量
  • deploy-update_config：滚动升级时的操作，每次更新 2 个副本（parallelism：2），升级失败以后回滚（failure_action: rollback）
  • failure_action默认为 pause ，即服务升级失败后阻止其它副本的升级，还支持 continue
  • restart_policy：容器异常退出的重启策略，当前策略为：如果某个副本以非 0 返回值退出（condition: on-failure），会立即重启当前副本，重启最多重试 3 次，每次最多等待 120s，每次重启间隔是 5s。

2.3.4 visualizer 服务

visualizer:

    image: dockersamples/visualizer:stable

    ports:

      - "8001:8080"

    stop_grace_period: 1m30s

    volumes:

      - "/var/run/docker.sock:/var/run/docker.sock"

    deploy:

      update_config:

        failure_action: rollback

      placement:

        constraints:

          - 'node.role == manager'
  • stop_grace_period：设置容器优雅停止时长（Docker 停止某个容器时，会给容器内 PID 为 1 的进程发送一个 SIGTERM 信号，容器内 PID 为 1 的进程有 10s 的优雅停止时长来执行清理操作）
  • volumes：挂载提前创建的卷或者主机目录至某个服务副本中，本例中/var/run/docker.sock为Docker 的 IPC 套接字，Docker daemon 通过该套接字对其它进程暴露 API 终端，如果某个容器有该文件的访问权限，即允许该容器访问所有的 API 终端，并且可以查询及管理 Docker daemon。生产环境严禁使用该操作

2.3.5 payment_gateway 服务

payment_gateway:

    image: dockersamples/atseasampleshopapp_payment_gateway

    secrets:

      - source: staging_token

        target: payment_token

    networks:

      - payment

    deploy:

      update_config:

        failure_action: rollback

      placement:

        constraints:

          - 'node.role == worker'

          - 'node.labels.pcidss == yes'

node.labels：自定义节点标签，可以通过docker node update自定义，并添加至 Swarm 集群的指定节点。这说明，node.labels 配置只适用于 Swarm 集群中指定的节点。

三、部署docker stack
3.1 准备工作
  • 自定义标签（payment_gateway 服务需要用到）
  • 密钥（提前创建 4 个）

给工作节点 huanzi-002 新建一个自定义标签，在管理节点上操作

[root@huanzi-001 atsea-sample-shop-app]# docker node ls

ID                            HOSTNAME            STATUS              AVAILABILITY        MANAGER STATUS      ENGINE VERSION

8bet9fg0tnoqlfp0ebrrqdapn *   huanzi-001          Ready               Active              Leader              19.03.5

85v90bioyy4s2fst4fa5vrlvf     huanzi-002          Ready               Active                                  19.03.5

8hxs2p5iblj19xg9uqpu8ar8g     huanzi-003          Ready               Active                                  19.03.5

[root@huanzi-001 atsea-sample-shop-app]# docker node update --label-add pcidss=yes huanzi-002

huanzi-002

[root@huanzi-001 atsea-sample-shop-app]# docker node inspect huanzi-002

[

    {

        "ID": "85v90bioyy4s2fst4fa5vrlvf",

        "Version": {

            "Index": 726

        },

        "CreatedAt": "2020-02-02T08:11:34.982719258Z",

        "UpdatedAt": "2020-02-06T10:22:25.44331302Z",

        "Spec": {

            "Labels": {

                "pcidss": "yes"

        <...>

可以看到自定义标签已经成功创建。

接下来创建密钥，先创建加密 key

[root@huanzi-001 daemon]# openssl req -newkey rsa:4096 -nodes -sha256 -keyout damain.key -x509 -days 365 -out domain.crt

Generating a 4096 bit RSA private key

....................................++

...........................................++

writing new private key to 'damain.key'

-----

<...>

Country Name (2 letter code) [XX]:

State or Province Name (full name) []:

Locality Name (eg, city) [Default City]:

Organization Name (eg, company) [Default Company Ltd]:

Organizational Unit Name (eg, section) []:

Common Name (eg, your name or your server's hostname) []:

Email Address []:

[root@huanzi-001 daemon]# ls

atsea-sample-shop-app  damain.key  domain.crt

[root@huanzi-001 daemon]#

创建需要加密 key 的revprox_cert，revprox_key，postgres_password这 3 个密钥

[root@huanzi-001 daemon]# docker secret create revprox_cert domain.crt

lue5qk6ophxrr6aspyhnkhvsv

[root@huanzi-001 daemon]# docker secret create revprox_key damain.key

glvfk78kn6665lmkci7tslrw6

[root@huanzi-001 daemon]# docker secret create postgres_password damain.key

pxdfs28hb2897xuu7f3bub7ex

[root@huanzi-001 daemon]#

创建不需要加密 key 的staging_token密钥

[root@huanzi-001 daemon]# echo staging | docker secret create staging_token -

cyqfn9jocvnxd2vr57gn5pioj

[root@huanzi-001 daemon]# docker secret ls

ID                          NAME                DRIVER              CREATED              UPDATED

pxdfs28hb2897xuu7f3bub7ex   postgres_password                       15 minutes ago       15 minutes ago

lue5qk6ophxrr6aspyhnkhvsv   revprox_cert                            16 minutes ago       16 minutes ago

glvfk78kn6665lmkci7tslrw6   revprox_key                             16 minutes ago       16 minutes ago

cyqfn9jocvnxd2vr57gn5pioj   staging_token                           About a minute ago   About a minute ago

[root@huanzi-001 daemon]#

现在自定义标签，及密钥全部创建完毕。

3.2 开始部署

命令：docker stack deploy -c <docker-stack.yml> <stack name>

[root@huanzi-001 atsea-sample-shop-app]# docker stack deploy -c docker-stack.yml huanzi-stack

Creating network huanzi-stack_front-tier

Creating network huanzi-stack_back-tier

Creating network huanzi-stack_default

Creating network huanzi-stack_payment

Creating service huanzi-stack_payment_gateway

Creating service huanzi-stack_reverse_proxy

Creating service huanzi-stack_database

Creating service huanzi-stack_appserver

Creating service huanzi-stack_visualizer

[root@huanzi-001 atsea-sample-shop-app]#

可以看出，先创建了 4 个网络，再创建的服务，我们验证一下网络是否创建了

[root@huanzi-001 atsea-sample-shop-app]# docker network ls

NETWORK ID          NAME                      DRIVER              SCOPE

34306420befb        bridge                    bridge              local

ac57c15024c7        docker_gwbridge           bridge              local

e863472805b3        host                      host                local

ojt9cxg2qsxe        huanzi-net                overlay             swarm

o74roe621idx        huanzi-stack_back-tier    overlay             swarm

k55m237m11ct        huanzi-stack_default      overlay             swarm

idpvc5xg2g2t        huanzi-stack_front-tier   overlay             swarm

uvphcut0a825        huanzi-stack_payment      overlay             swarm

7d6iv5ilwbcn        ingress                   overlay             swarm

d302c895b455        lovehuanzi                bridge              local

eefd134326c4        none                      null                local

[root@huanzi-001 atsea-sample-shop-app]#

看到了 4 个 huanzi-stack 前缀的网络。为什么多了一个huanzi-stack-default,因为visualizer 服务没有指定网络，因此 Docker 创建了一个 defalut 的网络给它用。

再验证下服务

root@huanzi-001 atsea-sample-shop-app]# docker stack ls

NAME                SERVICES            ORCHESTRATOR

huanzi-stack        5                   Swarm

[root@huanzi-001 atsea-sample-shop-app]#


[root@huanzi-001 atsea-sample-shop-app]# docker stack ps huanzi-stack

ID                  NAME                             IMAGE                                                     NODE                DESIRED STATE       CURRENT STATE             ERROR               PORTS

ex55yaz21mra        huanzi-stack_appserver.1         dockersamples/atsea_app:latest                            huanzi-003          Running             Preparing 2 minutes ago

jshmzquzxi8p        huanzi-stack_database.1          dockersamples/atsea_db:latest                             huanzi-002          Running             Preparing 2 minutes ago

k7mi1419ahwd        huanzi-stack_reverse_proxy.1     dockersamples/atseasampleshopapp_reverse_proxy:latest     huanzi-003          Running             Preparing 2 minutes ago

09ocoutjfc70        huanzi-stack_payment_gateway.1   dockersamples/atseasampleshopapp_payment_gateway:latest   huanzi-002          Running             Preparing 2 minutes ago

y6lftn8g95b8        huanzi-stack_visualizer.1        dockersamples/visualizer:stable                           huanzi-001          Running             Preparing 2 minutes ago

5twm1k4uj5ps        huanzi-stack_appserver.2         dockersamples/atsea_app:latest                            huanzi-002          Running             Preparing 2 minutes ago

[root@huanzi-001 atsea-sample-shop-app]#

可以看到满足 stack 文件的要求：

  • reverse_proxy：副本数量 1
  • database：副本数量 1，位于worker
  • appserver：副本数量 2，位于worker
  • visualizer：副本数量 1，位于manager
  • payment_gateway：副本数量 1，位于worker，自定义标签pcidss == yes（即 huanzi-002 ）
3.3 管理 Stack

3.3.1 扩容

将appserver的副本数从 2 扩至 10，有 2 种方式：

  • 通过docker service scale appserver=10
  • 直接修改docker-stack.yml文件，再通过docker stack deploy重新部署

所有的变更都应该通过 Stack 文件进行声明，然后通过 docker stack deploy 进行部署



修改docker-stack.yml文件

appserver:

    image: dockersamples/atsea_app

    networks:

      - front-tier

      - back-tier

      - payment

    deploy:

      replicas: 10

重新部署

[root@huanzi-001 atsea-sample-shop-app]# docker stack deploy -c docker-stack.yml huanzi-stack

Updating service huanzi-stack_reverse_proxy (id: i2yn8l50ofnmbx0a55mum1dw0)

Updating service huanzi-stack_database (id: ubrtixblmj685pnc97wql42cm)

Updating service huanzi-stack_appserver (id: yy447jdp1eiwb03ljdsqtyg1g)

Updating service huanzi-stack_visualizer (id: rhzzxov0jh1y38rxcj6bwe89y)

Updating service huanzi-stack_payment_gateway (id: niobpxv5vr1njoo37vnje8zic)

[root@huanzi-001 atsea-sample-shop-app]#


[root@huanzi-001 atsea-sample-shop-app]# docker stack ps huanzi-stack

ID                  NAME                             IMAGE                                                     NODE                DESIRED STATE       CURRENT STATE              ERROR                              PORTS

wrser9r5bbrz        huanzi-stack_visualizer.1        dockersamples/visualizer:stable                           huanzi-001          Running             Preparing 3 minutes ago

ex55yaz21mra        huanzi-stack_appserver.1         dockersamples/atsea_app:latest                            huanzi-003          Running             Preparing 20 minutes ago

jshmzquzxi8p        huanzi-stack_database.1          dockersamples/atsea_db:latest                             huanzi-002          Running             Preparing 20 minutes ago

k7mi1419ahwd        huanzi-stack_reverse_proxy.1     dockersamples/atseasampleshopapp_reverse_proxy:latest     huanzi-003          Running             Preparing 20 minutes ago

09ocoutjfc70        huanzi-stack_payment_gateway.1   dockersamples/atseasampleshopapp_payment_gateway:latest   huanzi-002          Running             Preparing 20 minutes ago

5twm1k4uj5ps        huanzi-stack_appserver.2         dockersamples/atsea_app:latest                            huanzi-002          Running             Preparing 20 minutes ago

aydzla0zzv3p        huanzi-stack_appserver.3         dockersamples/atsea_app:latest                            huanzi-003          Running             Preparing 2 minutes ago

n3312auusvxi        huanzi-stack_appserver.4         dockersamples/atsea_app:latest                            huanzi-002          Running             Preparing 2 minutes ago

kg8jy3ei0beo        huanzi-stack_appserver.5         dockersamples/atsea_app:latest                            huanzi-003          Running             Preparing 2 minutes ago

tgai33mhlxyv        huanzi-stack_appserver.6         dockersamples/atsea_app:latest                            huanzi-002          Running             Preparing 2 minutes ago

n69nunaur3lz        huanzi-stack_appserver.7         dockersamples/atsea_app:latest                            huanzi-003          Running             Preparing 2 minutes ago

mqubx8hoddn8        huanzi-stack_appserver.8         dockersamples/atsea_app:latest                            huanzi-002          Running             Preparing 2 minutes ago

p3mo3k8a5jvs        huanzi-stack_appserver.9         dockersamples/atsea_app:latest                            huanzi-003          Running             Preparing 2 minutes ago

xw8tvi5bwh53        huanzi-stack_appserver.10        dockersamples/atsea_app:latest                            huanzi-002          Running             Preparing 2 minutes ago

[root@huanzi-001 atsea-sample-shop-app]#

扩容完成。

3.3.2 删除

命令：docker stack rm <stack name>

[root@huanzi-001 atsea-sample-shop-app]# docker stack rm huanzi-stack

Removing service huanzi-stack_appserver

Removing service huanzi-stack_database

Removing service huanzi-stack_payment_gateway

Removing service huanzi-stack_reverse_proxy

Removing service huanzi-stack_visualizer

Removing network huanzi-stack_front-tier

Removing network huanzi-stack_default

Removing network huanzi-stack_back-tier

Removing network huanzi-stack_payment

可以看出，rm会删除服务及网络，但是密钥和卷不会删除

root@huanzi-001 atsea-sample-shop-app]# docker secret ls

ID                          NAME                DRIVER              CREATED             UPDATED

pxdfs28hb2897xuu7f3bub7ex   postgres_password                       53 minutes ago      53 minutes ago

lue5qk6ophxrr6aspyhnkhvsv   revprox_cert                            55 minutes ago      55 minutes ago

glvfk78kn6665lmkci7tslrw6   revprox_key                             54 minutes ago      54 minutes ago

cyqfn9jocvnxd2vr57gn5pioj   staging_token                           40 minutes ago      40 minutes ago

[root@huanzi-001 atsea-sample-shop-app]#

一般一个环境需要一个stack文件。比如dev，test，prod。

感谢阅读，有兴趣的小伙伴可以关注我的微信公众号DevOps探索之旅，大家一起学习进步

Docker Stack 学习笔记的更多相关文章

  1. Docker&K8S学习笔记（一）—— Docker安装

    最近一年在工作上经常使用Docker与K8S,除了利用其打镜像,部署服务外,还基于Docker与K8S开发了一套CICD流水线平台,为了加深相关知识点的理解,所以从今天开始会定期更新学习笔记,本套学习 ...

  2. Docker的学习笔记(一)基础知识

    概述 本人最近在学习docker相关的知识,既是工作本身的需要也是自己对技术的追求的必要,以后我也会推出容器相关的随笔,既可以增长自己的知识,也可以和读者广泛交流,岂不乐乎?话不多说.第一篇先介绍do ...

  3. docker容器学习笔记

    docker是通过内核虚拟化技术来提供容器的资源隔离与安全保障. docker组成: docker client.docker server.docker组件(镜像(image).容器(contain ...

  4. Docker的学习笔记（开发的技术分享转发）

    我的Docker学习记录一.安装dockeryum install -y docker-io二.使用docker1.下载镜像docker pull <image>2.查询镜像docker ...

  5. Docker(Linux)学习笔记以及Redis/MariaDB的容器使用后台全自动启动

    1:Docker安装,由于Docker后续pull镜像的服务器默认是在国外的,速度实在是太慢,这里使用阿里云的镜像 阿里云的Docker CE 镜像源站进行安装 docker ===========U ...

  6. docker（学习笔记）

    # 1. Docker介绍## 1.1 什么是容器?## 1.2 容器的前世今生FreeBASE jail ------> Linux vserverchroot ----> 完整的根文件 ...

  7. 字节跳动内部微服务架构-Docker实战学习笔记分享 真香

    前言 基于 Spring Cloud 的微服务设计和开发,已经越来越多地得到了更多企业的推广和应用,而 Spring Cloud 社区也在不断的迅速发展壮大之中,近几年时间,Spring Cloud ...

  8. docker入门-学习笔记

    docker可以类比成window下的VMware或者virtualbox软件.docker有两个基本的概念:容器(container)和镜像(image),分别对应为VMware中的系统镜像和系统镜 ...

  9. Docker compose学习笔记

    一.compose compose 作用 你的应用可能需要很多个服务,比如web服务,数据库服务,缓存服务等等.我们可以把这些服务放到单独的容器里面,如果手工去配置这些服务会有些麻烦,docker c ...

随机推荐

  1. 百度API之路线规划

    近期参加一个课题,聊到路线规划问题,需要搜索两地点的最短线路距离以及最短用时等情况,然后就想着用借用百度API,做个参考 环境: python 3.6 主要问题: 1. 分析百度官方路线规划API了解 ...

  2. Kafka系列1：Kafka概况

    Kafka系列1:Kafka概况 Kafka是当前分布式系统中最流行的消息中间件之一,凭借着其高吞吐量的设计,在日志收集系统和消息系统的应用场景中深得开发者喜爱.本篇就聊聊Kafka相关的一些知识点. ...

  3. Zabbix3.4搭建过程

    一.安装之前把firewall 和 selinux关闭. 二.具体的搭建过程可以看zabbix官网的文档,www.zabbix.com(有中文的文档)注意如果复制官网的命令直接使用的话,不会安装mys ...

  4. Oracle监听器

    Oracle 监听器 Listener 是一个重要的数据库服务器组件,在整个 Oracle 体系结构中,扮演着重要的作用.它负责管理 Oracle 数据库和客户端之间的通讯,它在一个特定的网卡端口(默 ...

  5. SQL 两个时间段 不能重复语句

    DECLARE @BeginDate datetime; DECLARE @EndDate datetime; set @BeginDate='2015-03-2' set @EndDate='201 ...

  6. 第一篇：Vue基础

    Vue基础 渐进式JavaScript框架 通过对框架的了解与运用程度,来决定其在整个项目中的应用范围,最终可以独立以框架方式完成整个web前端项目 走进Vue 什么是Vue 渐进式JavaScrip ...

  7. android实例 listview与sqlite数据绑定

    ListView与Sqlite数据库绑定步骤: 1.将Sqlite数据库的内容查询出来并放入数组列表中,形成ListView的数据源: 2.适配器绑定数据源,显示在ListView item中. 本文 ...

  8. JAVA&&JAVA WEB开发包U盘封装版

    难以忍受机房的开发环境,就简单实现了将所有的开发文件封装进了U盘. 基于wmic的强大功能,实现了机房变态环境下的设置环境变量OS不用重新启动OS! install.bat @echo off mod ...

  9. Codeforces_462_B

    http://codeforces.com/problemset/problem/462/B 简单的贪心,排序即可看出来. #include<cstdio> #include<ios ...

  10. python之reload用法

    一.python2和python3的区别 python2中可以直接使用reload().python3中需要从库中导入,有两种方法: >>> from imp import relo ...