docker service create
docker service create
Эта команда работает с Swarm. Создаёт новую службу.
docker service create [OPTIONS] IMAGE [COMMAND] [ARG...]
| Имя, сокращенно | По умолчанию | Описание |
|---|---|---|
--cap-add |
API 1.41+. Добавляет возможности Linux | |
--cap-drop |
API 1.41+. Отбросьте возможности Linux | |
--config |
API 1.41+. Указывает конфигурации для предоставления службе | |
--constraint |
Ограничения по размещению | |
--container-label |
Этикетки контейнеров | |
--credential-spec |
Спецификация учетных данных для управляемой учетной записи службы (только для Windows) | |
--detach, -d |
Немедленно выйти, не дожидаясь сходимости службы | |
--dns |
Устанавливает пользовательские DNS-серверы | |
--dns-option |
Устанавливает параметры DNS | |
--dns-search |
Устанавливает пользовательские домены поиска DNS | |
--endpoint-mode |
vip |
Режим конечной точки (vip или dnsrr) |
--entrypoint |
Перезаписать ENTRYPOINT образа по умолчанию | |
--env, -e |
Устанавливает переменные среды | |
--env-file |
Чтение в файле переменных окружения | |
--generic-resource |
Пользовательские ресурсы | |
--group |
Устанавливает одну или несколько дополнительных групп пользователей для контейнера | |
--health-cmd |
Команда запуска для проверки здоровья | |
--health-interval |
Время между запусками проверки (мс|с|м|ч) | |
--health-retries |
Последовательные сбои необходимо сообщать о нездоровой | |
--health-start-period |
Начальный период для инициализации контейнера до подсчета попыток перехода к нестабильной работе (мс|с|м|ч) | |
--health-timeout |
Максимальное время выполнения одной проверки (мс|с|м|ч) | |
--host |
Устанавливает одно или несколько настраиваемых сопоставлений хоста и IP (хост: ip) | |
--hostname |
Имя узла контейнера | |
--init |
Используйте init внутри каждого сервисного контейнера для пересылки сигналов и получения процессов | |
--isolation |
Режим изоляции сервисного контейнера | |
--label, -l |
Сервисные этикетки | |
--limit-cpu |
Ограничьте процессоры | |
--limit-memory |
Ограничить память | |
--limit-pids |
API 1.41+. Данный параметр работает для оркестратора Swarm. Ограничьте максимальное количество процессов (по умолчанию 0 = неограниченно) | |
--log-driver |
Регистрация драйвера для службы | |
--log-opt |
Запись параметров драйвера | |
--max-concurrent |
API 1.41+. Количество задач задания для одновременного запуска (по умолчанию равно --replicas) | |
--mode |
replicated |
Режим обслуживания (реплицированный, глобальный, реплицированный-задание или глобальный-задание) |
--mount |
Прикрепите монтирование файловой системы к службе | |
--name |
Наименование услуги | |
--network |
Сетевые вложения | |
--no-healthcheck |
Отключает все указанные контейнером HEALTHCHECK | |
--no-resolve-image |
Не запрашивайте реестр для разрешения дайджеста образа и поддерживаемых платформ | |
--placement-pref |
Добавляет предпочтительный опция размещения | |
--publish, -p |
Опубликуйте порт как порт узла | |
--quiet, -q |
Подавить вывод прогресса | |
--read-only |
Смонтируйте корневую файловую систему контейнера только для чтения | |
--replicas |
Количество задач | |
--replicas-max-per-node |
API 1.40+. Максимальное количество задач на узел (по умолчанию 0 = неограниченно) | |
--reserve-cpu |
Резервные процессоры | |
--reserve-memory |
Резервная память | |
--restart-condition |
Перезапуск при выполнении условия («нет»|»при сбое»|»любой») (по умолчанию «любой») | |
--restart-delay |
Задержка между попытками перезапуска (ns|us|ms|s|m|h) (по умолчанию 5 с) | |
--restart-max-attempts |
Максимальное количество перезапусков перед отказом | |
--restart-window |
Окно, используемое для вычисления политики перезапуска (ns|us|ms|s|m|h) | |
--rollback-delay |
Задержка между откатами задач (ns|us|ms|s|m|h) (по умолчанию 0 с) | |
--rollback-failure-action |
Действие при неудачном откате («пауза»|»продолжить») (по умолчанию «пауза») | |
--rollback-max-failure-ratio |
Допустимая частота отказов во время отката (по умолчанию 0) | |
--rollback-monitor |
Продолжительность после каждого отката задачи для отслеживания сбоя (ns|us|ms|s|m|h) (по умолчанию 5 с) | |
--rollback-order |
Порядок отката («старт-первый»|»сначала остановлен») (по умолчанию «сначала остановлен»). | |
--rollback-parallelism |
1 |
Максимальное количество задач, откатываемых одновременно (0, чтобы откатить все сразу) |
--secret |
Указывает секреты, которые необходимо предоставить службе | |
--stop-grace-period |
Время ожидания перед принудительным уничтожением контейнера (ns|us|ms|s|m|h) (по умолчанию 10 с) | |
--stop-signal |
Сигнал на остановку контейнера | |
--sysctl |
API 1.40+. Системные параметры | |
--tty, -t |
API 1.40+. Назначает псевдо-TTY | |
--ulimit |
API 1.41+. Улимит варианты | |
--update-delay |
Задержка между обновлениями (нс|нас|мс|с|м|ч) (по умолчанию 0 с) | |
--update-failure-action |
Действие при сбое обновления («пауза»|»продолжить»|»откат») (по умолчанию «пауза») | |
--update-max-failure-ratio |
Частота отказов во время обновления (по умолчанию 0) | |
--update-monitor |
Длительность после каждого обновления задачи для отслеживания сбоев (ns|us|ms|s|m|h) (по умолчанию 5 с) | |
--update-order |
Порядок обновления («начало-сначала»|»сначала с остановкой») (по умолчанию «сначала с остановкой») | |
--update-parallelism |
1 |
Максимальное количество одновременно обновляемых задач (0, чтобы обновить все сразу) |
--user, -u |
Имя пользователя или UID (формат: <name|uid>:<group|gid>) | |
--with-registry-auth |
Отправить данные проверки подлинности реестра агентам swarm | |
--workdir, -w |
Рабочий каталог внутри контейнера | |
Примеры
создаем службу
vagrant@server1:~$ docker service create --name redis redis:latest
vagrant@server1:~$ docker service ps redis
ID NAME IMAGE NODE DESIRED STATE CURRENT STATE ERROR PORTS
fow99mp8tmr9 redis.1 redis:latest server2 Running Running 50 seconds ago
смотрим логи
vagrant@server1:~$ docker service logs redis
redis.1.fow99mp8tmr9@server2 | 1:C 10 Dec 2023 15:45:44.045 # WARNING Memory overcommit must be enabled! Without it, a background save or replication may fail under low memory condition. Being disabled, it can also cause failures without low memory condition, see https://github.com/jemalloc/jemalloc/issues/1328. To fix this issue add 'vm.overcommit_memory = 1' to /etc/sysctl.conf and then reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take effect.
redis.1.fow99mp8tmr9@server2 | 1:C 10 Dec 2023 15:45:44.045 * oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
redis.1.fow99mp8tmr9@server2 | 1:C 10 Dec 2023 15:45:44.045 * Redis version=7.2.3, bits=64, commit=00000000, modified=0, pid=1, just started
redis.1.fow99mp8tmr9@server2 | 1:C 10 Dec 2023 15:45:44.045 # Warning: no config file specified, using the default config. In order to specify a config file use redis-server /path/to/redis.conf
redis.1.fow99mp8tmr9@server2 | 1:M 10 Dec 2023 15:45:44.046 * monotonic clock: POSIX clock_gettime
redis.1.fow99mp8tmr9@server2 | 1:M 10 Dec 2023 15:45:44.046 * Running mode=standalone, port=6379.
redis.1.fow99mp8tmr9@server2 | 1:M 10 Dec 2023 15:45:44.048 * Server initialized
redis.1.fow99mp8tmr9@server2 | 1:M 10 Dec 2023 15:45:44.048 * Ready to accept connections tcp
Удалить службу
vagrant@server1:~$ docker service rm redis
redis
vagrant@server1:~$ docker service ls
ID NAME MODE REPLICAS IMAGE PORTS
Масштабировать службу на другие ноды
vagrant@server1:~$ docker service create --name redis redis
qjkv7nbmsk5ed6zs43vlw1b19
overall progress: 1 out of 1 tasks
1/1: running [==================================================>]
verify: Service converged
vagrant@server1:~$ docker service ls
ID NAME MODE REPLICAS IMAGE PORTS
qjkv7nbmsk5e redis replicated 1/1 redis:latest
vagrant@server1:~$ docker service scale redis=2
redis scaled to 2
overall progress: 2 out of 2 tasks
1/2: running [==================================================>]
2/2: running [==================================================>]
verify: Service converged
vagrant@server1:~$ docker service ls
ID NAME MODE REPLICAS IMAGE PORTS
qjkv7nbmsk5e redis replicated 2/2 redis:latest
можно сразу при создании сервиса
docker service create --name redis --replicas=3 redis