Деплой на Docker Swarm

Thank you for reading this post, don't forget to subscribe!

deploy

Начиная с версии 3. docker-compose

Группа настроек, посвященная деплою и запуску сервисов. Указанные в данной группе настройки используются только при деплое на swarm используя docker stack deploy, и игнорируется при использовании команд docker-compose up и docker-compose run.

[codesyntax lang="php" blockstate="collapsed"]

version: '3'

services:
  redis:
    image: redis:alpine
    deploy:
      replicas: 6
      update_config:
        parallelism: 2
        delay: 10s
      restart_policy:
        condition: on-failure

version: '3'

services:

redis:

image: redis:alpine

deploy:

replicas: 6

update_config:

parallelism: 2

delay: 10s

restart_policy:

condition: on-failure

[/codesyntax]

Доступны следующие дополнительные опции:

endpoint_mode

Используемый метод обнаружения (“service discovery”) для внешних запросов от клиентов.

Начиная с версии 3.3. docker-compose

endpoint_mode: vip - Докер присваивает сервису виртуальный IP адрес (VIP), который выступает в роли “внешнего” для получения доступа к сервису. Докер сам занимается маршрутизацией запросов между клиентом и доступным воркером (на котором крутится сервис), при этом клиент ничего не знает ни о количестве нод, ни о их IP и портах (используется по умолчанию).
endpoint_mode: dnsrr - DNS “round-robin” (DNSRR) не использует одиночный виртуальный IP адрес. Докер устанавливает DNS записи для сервиса таким образом, что когда клиент его запрашивает - ему возвращается список из IP адресов, и клиент сам подключается к одному из них. DNS “round-robin” полезен в случаях использования своего собственного балансировщика нагрузки, или для гибридных Windows & Linux приложений.

[codesyntax lang="php" blockstate="collapsed"]

version: "3.3"

services:
  wordpress:
    image: wordpress
    ports:
      - "8080:80"
    networks:
      - overlay
    deploy:
      mode: replicated
      replicas: 2
      endpoint_mode: vip

  mysql:
    image: mysql
    volumes:
       - db-data:/var/lib/mysql/data
    networks:
       - overlay
    deploy:
      mode: replicated
      replicas: 2
      endpoint_mode: dnsrr

volumes:
  db-data:

networks:
  overlay:

version: "3.3"

services:

wordpress:

image: wordpress

ports:

- "8080:80"

networks:

- overlay

deploy:

mode: replicated

replicas: 2

endpoint_mode: vip

mysql:

image: mysql

volumes:

- db-data:/var/lib/mysql/data

networks:

- overlay

deploy:

mode: replicated

replicas: 2

endpoint_mode: dnsrr

volumes:

db-data:

networks:

overlay:

[/codesyntax]

endpoint_mode так же можно использовать как флаг запуска при использовании консоли docker service create.

Список всех swarm-команд доступен по этой ссылке.

Если вы хотите узнать больше о “service discovery” и сетях в swarm-режиме, перейдите в раздел настройки service discovery.

labels

Установка ярлыков (labels) сервиса. Эти ярлыки присваиваются только самому сервису, а некакому-либо контейнеру этого сервиса.

[codesyntax lang="php" blockstate="collapsed"]

version: "3"

services:
  web:
    image: web
    deploy:
      labels:
        com.example.description: "This label will appear on the web service"

version: "3"

services:

web:

image: web

deploy:

labels:

com.example.description: "This label will appear on the web service"

[/codesyntax]

Для установки ярлыков (labels) для контейнеров (а не сервиса), используйте ключ labels вне секции deploy:

[codesyntax lang="php" blockstate="collapsed"]

version: "3"

services:
  web:
    image: web
    labels:
      com.example.description: "This label will appear on all containers for the web service"

version: "3"

services:

web:

image: web

labels:

com.example.description: "This label will appear on all containers for the web service"

[/codesyntax]

mode

Может быть глобальным (global, строго один контейнер на swarm-ноде) или реплицированным(replicated, с указанием количества контейнеров). По умолчанию используется replicated. Подробнее можно прочитать в разделе Реплицированные и глобальные сервисы.

[codesyntax lang="php" blockstate="collapsed"]

version: '3'

services:
  worker:
    image: dockersamples/examplevotingapp_worker
    deploy:
      mode: global

version: '3'

services:

worker:

image: dockersamples/examplevotingapp_worker

deploy:

mode: global

[/codesyntax]

placement

Указание мест размещения контейнеров и их “предпочтений”. Наиболее полное описание допустимых опций вы сможете найти в разделах “constraints” и “preferences” соответственно.

[codesyntax lang="php" blockstate="collapsed"]

version: '3.3'

services:
  db:
    image: postgres
    deploy:
      placement:
        constraints:
          - node.role == manager
          - engine.labels.operatingsystem == ubuntu 14.04
        preferences:
          - spread: node.labels.zone

version: '3.3'

services:

db:

image: postgres

deploy:

placement:

constraints:

- node.role == manager

- engine.labels.operatingsystem == ubuntu 14.04

preferences:

- spread: node.labels.zone

[/codesyntax]

replicas

Если у сервиса выбран режим репликации (replicated, используется по умолчанию) - вы можете указать количество запускаемых контейнеров у данного сервиса.

[codesyntax lang="php" blockstate="collapsed"]

version: '3'

services:
  worker:
    image: dockersamples/examplevotingapp_worker
    networks:
      - frontend
      - backend
    deploy:
      mode: replicated
      replicas: 6

version: '3'

services:

worker:

image: dockersamples/examplevotingapp_worker

networks:

- frontend

- backend

deploy:

mode: replicated

replicas: 6

[/codesyntax]

resources

Настройка ограничений используемых ресурсов

Примечание: Указанные в данной секции опции перекрывают более старые ограничения и опции, что указаны в Compose-файле для не-swarm режима до версии 3 (cpu_shares, cpu_quota, cpuset, mem_limit, memswap_limit, mem_swappiness), как описано в разделе обновление с версии 2.x до 3.x.

Каждое значение, указанное в данной секции, является аналогом опций для docker service create.

В приведенном ниже примере сервис redis может использовать не более 50 Мб памяти и 0.50 (50%) доступного процессорного времени (CPU), а так же имеет зарезервированные 20 Мб памяти и 0.25CPU (всегда доступные для него).

[codesyntax lang="php" blockstate="collapsed"]

version: '3'

services:
  redis:
    image: redis:alpine
    deploy:
      resources:
        limits:
          cpus: '0.50'
          memory: 50M
        reservations:
          cpus: '0.25'
          memory: 20M

version: '3'

services:

redis:

image: redis:alpine

deploy:

resources:

limits:

cpus: '0.50'

memory: 50M

reservations:

cpus: '0.25'

memory: 20M

[/codesyntax]

Настройка ограничений ресурсов для не-swarm режима доступна в этом разделе. Если у вас возникнут дополнительные вопросы - обратите внимание на этот топик на github.com.

Исключения класса “Out Of Memory” (OOME)

Если ваши сервисы или контейнеры попытаются использовать объём памяти больше, чем доступен на используемой системе, вы рискуете “поймать” исключение класса “Out Of Memory Exception” (OOME) и контейнер, или сам докер-демон может быть прибит демоном ядра системы (“kernel OOM killer”). Во избежание этого убедитесь в наличии доступных ресурсов на целевой системе и ознакомтесь с разделом понимание рисков недостатка доступной памяти.

restart_policy

Указывает как и в каких случаях необходимо перезапускать контейнеры когда они останавливаются. Замена секции restart.

condition (условие): одно из возможных значений - none (никогда), on-failure (при ошибке) или any (всегда) (по умолчанию: any).
delay (задержка): Задержка между попытками перезапуска, указывается в формате “продолжительность” (по умолчанию: 0).
max_attempts: Количество предпринимаемых попыток перезапуска перед тем, как прекратить пытаться запустить контейнер (по умолчанию: количество попыток не ограничено). Если контейнер не запустился в пределах указанного “окна” (window), эта попытка не учитывается при расчете значения max_attempts. Например, если max_attempts установлен равным 2, и перезапуск завершился ошибкой при первой попытке, может быть предпринято более двух попыток перезапуска.
window: Задержка перед принятием решения о том, что перезапуск успешно завершился. Указывается в формате “продолжительность” (по умолчанию: задержка отсутствует).

Для лучшего понимания лучше прочитать первоисточник.

[codesyntax lang="php" blockstate="collapsed"]

version: '3'

services:
  redis:
    image: redis:alpine
    deploy:
      restart_policy:
        condition: on-failure
        delay: 5s
        max_attempts: 3
        window: 120s

version: '3'

services:

redis:

image: redis:alpine

deploy:

restart_policy:

condition: on-failure

delay: 5s

max_attempts: 3

window: 120s

[/codesyntax]

update_config

Настройка обновления сервисов.

parallelism: Количество одновременно обновляемых контейнеров. Если установить 0, то будет происходить одновременное обновление всех контейнеров.
delay: Задержка между обновлениями группы контейнеров (по умолчанию: 0s).
failure_action: Действие при ошибке обновления. Может принимать значения: continue, rollback, или pause (по умолчанию: pause).
monitor: Продолжительность мониторинга на сбой после каждого обновления (ns|us|ms|s|m|h)(по умолчанию: 0s).
max_failure_ratio: Допустимая частота сбоев при обновлении (по умолчанию: 0).
order: Порядок операций при обновлении. Может принимать значения: stop-first (старая задача останавливается перед тем, как запускать новую), или start-first (сначала запускается новая задача, а выполняемые задачи ненадолго “перекрываются”) (по умолчанию: stop-first).

Заметка: Порядок операций при обновлении доступен начиная с версии v3.4 и выше.

[codesyntax lang="php" blockstate="collapsed"]

version: '3.4'

services:
  vote:
    image: dockersamples/examplevotingapp_vote:before
    depends_on:
      - redis
    deploy:
      replicas: 2
      update_config:
        parallelism: 2
        delay: 10s
        order: stop-first

version: '3.4'

services:

vote:

image: dockersamples/examplevotingapp_vote:before

depends_on:

- redis

deploy:

replicas: 2

update_config:

parallelism: 2

delay: 10s

order: stop-first

[/codesyntax]

depends_on является не будет работать при использовании с docker stack deploy. Службы режима Swarm перезапускаются, когда они терпят неудачу, поэтому нет причин откладывать их запуск. Даже если они терпят неудачу несколько раз, они в конечном итоге выздоровят(возможно)

rollback_config

Версия 3.7 и выше

Настройка откатов сервисов в случае ошибки обновления.

parallelism: Количество одновременно откатываемых контейнеров. Если установить 0, то будет происходить одновременный откат всех контейнеров.
delay: Задержка между откатами группы контейнеров (по умолчанию: 0s).
failure_action: Действие при провале отката. Может принимать значения: continue или pause (по умолчанию: pause)
monitor: Продолжительность мониторинга на сбой после каждого обновления (ns|us|ms|s|m|h)(по умолчанию: 0s).
max_failure_ratio: Допустимая частота сбоев при откате (по умолчанию: 0).
order: Порядок операций при откате. Может принимать значения: stop-first (старая задача останавливается перед тем, как запускать новую), или start-first (сначала запускается новая задача, а выполняемые задачи ненадолго “перекрываются”) (по умолчанию: stop-first).

Не поддерживается в контексте `docker stack deploy`

Следующие настройки не поддерживаются командой docker stack deploy или настройками в группе deploy.

build
cgroup_parent
container_name
devices
tmpfs
external_links
links
network_mode
restart
security_opt
stop_signal
sysctls
userns_mode

Заметка: Смотри раздел как настраивать тома для сервисов, swarm-ов и docker-stack.yml файлов. Использование томов поддерживается, но они должны быть сконфигурированы как как именованные тома или связаны с сервисами, которые в свою очередь предоставляют доступ к необходимым томам.

Отправка логов во fluent

Допустим имеется сервис curator
[codesyntax lang="php" blockstate="collapsed"]

  curator:
    image: curator
    configs:
      - source: curator_action
        target: /etc/curator/action_file.yml
      - source: curator_config
        target: /etc/curator/config.yml
    environment:
      ELASTICSEARCH_HOST: elasticsearch
      ELASTICSEARCH_PORT: 9200
      SCHEDULE: "* * * * *"
      COMMAND: "curator --config /etc/curator/config.yml  /etc/curator/action_file.yml"
<strong>    logging:
       driver: "fluentd"
       options:
        tag: CURATOR</strong>
    networks:
      - efk
    deploy:
      mode: replicated
      replicas: 1

curator:

image: curator

configs:

- source: curator_action

target: /etc/curator/action_file.yml

- source: curator_config

target: /etc/curator/config.yml

environment:

ELASTICSEARCH_HOST: elasticsearch

ELASTICSEARCH_PORT: 9200

SCHEDULE: "* * * * *"

COMMAND: "curator --config /etc/curator/config.yml /etc/curator/action_file.yml"

<strong> logging:

driver: "fluentd"

options:

tag: CURATOR</strong>

networks:

- efk

deploy:

mode: replicated

replicas: 1

[/codesyntax]

описываем логирование следующим блоком:
logging:
driver: "fluentd"
options:
tag: CURATOR
driver говорит как называется принимающий логи драйвер, tag - добавляет название.

Пн	Вт	Ср	Чт	Пт	Сб	Вс
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28	29
30

Centos

Деплой на Docker Swarm

deploy

endpoint_mode

labels

mode

placement

replicas

resources

Исключения класса “Out Of Memory” (OOME)

restart_policy

update_config

rollback_config

Не поддерживается в контексте `docker stack deploy`

Отправка логов во fluent

https://github.com/midnight47/

deploy

endpoint_mode

labels

mode

placement

replicas

resources

Исключения класса “Out Of Memory” (OOME)

restart_policy

update_config

rollback_config

Не поддерживается в контексте docker stack deploy

Отправка логов во fluent

https://github.com/midnight47/

Не поддерживается в контексте `docker stack deploy`