Docker Swarm на Ubuntu 24.04: пошаговая настройка кластера
Docker Swarm входит в Docker Engine и не требует отдельных пакетов. Кластер поднимается командой docker swarm init на первом сервере, остальные узлы подключаются по выданному токену. Первый сервис запускается одной командой docker service create.
01Проверьте, что Docker установлен
На сервере уже должен работать Docker Engine. Убедитесь, что демон отвечает и версия клиента совпадает с сервером. Если команда не найдена, установите Docker по отдельной инструкции.
docker version
02Инициализируйте менеджер Swarm
Первый узел становится менеджером и хранит состояние кластера. Укажите адрес, по которому другие узлы будут к нему подключаться: --advertise-addr с публичным или приватным IP сервера. Команда выведет строку подключения воркера и токен менеджера, сохраните их.
docker swarm init --advertise-addr 203.0.113.10
03Подключите рабочие узлы
На каждом дополнительном сервере выполните команду docker swarm join, которую вывел менеджер. Она содержит адрес менеджера и токен воркера. Если токен потерян, менеджер покажет его снова командой docker swarm join-token worker.
docker swarm join --token SWMTKN-1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxx 203.0.113.10:2377
04Проверьте состав кластера
На менеджере выведите список узлов. В колонке STATUS должно быть Ready, в AVAILABILITY значение Active. Колонка MANAGER STATUS пуста у воркеров и содержит Leader у менеджера.
docker node ls
05Запустите первый сервис
Сервис это единица работы в Swarm, а не отдельный контейнер. Команда docker service create создаёт задачу и распределяет её по узлам. Порт публикуется в режиме ingress, и Swarm сам балансирует запросы между репликами.
docker service create --name web --replicas 2 --publish published=80,target=80 nginx:1.24
06Масштабируйте сервис
Число реплик меняется без пересоздания сервиса. Swarm запустит новые задачи на свободных узлах. Уменьшение реплик останавливает лишние задачи.
docker service scale web=3
07Проверьте работу сервиса
Команда docker service ps показывает задачи сервиса и узел, на котором каждая работает. В колонке CURRENT STATE должно быть Running. Запрос к опубликованному порту возвращает страницу nginx.
docker service ps web
curl -I http://203.0.113.10/
Частые ошибки
-
Команда
docker swarm initзавершается ошибкойcould not choose an IP address to advertise since this system has multiple addresses. У сервера несколько сетевых интерфейсов, и Docker не может выбрать адрес сам.Укажите адрес явно:
docker swarm init --advertise-addr 203.0.113.10. -
Воркер не подключается к менеджеру, в выводе
docker swarm joinошибка таймаута. Порт 2377 закрыт файрволом или UFW.Откройте порты Swarm на менеджере:
sudo ufw allow 2377/tcp,sudo ufw allow 7946/tcp,sudo ufw allow 7946/udpиsudo ufw allow 4789/udp. -
После
docker swarm initкомандаdocker service createвозвращаетThis node is not a swarm manager. Команда выполнена на воркере, а не на менеджере.Выполняйте команды управления кластером на узле со статусом
Leaderиз выводаdocker node ls. -
Сервис с опубликованным портом 80 не запускается, в
docker service psзадача в состоянииRejected. Порт уже занят другим процессом на узле.Проверьте, кто держит порт:
sudo ss -ltnp. Остановите конфликтующий сервис или опубликуйте другой порт, напримерpublished=8080,target=80.
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Нужно ли устанавливать Docker Swarm отдельно?
Нет. Swarm входит в Docker Engine, команда docker swarm доступна сразу после установки Docker. Отдельных пакетов для Swarm нет.
Чем сервис Swarm отличается от контейнера?
Сервис описывает желаемое состояние: образ, число реплик и порты. Swarm сам создаёт задачи, следит за их работой и перезапускает упавшие контейнеры на доступных узлах.
Сколько менеджеров нужно для отказоустойчивости?
Для кворума нужно нечётное число менеджеров: три или пять. Один менеджер подходит для тестового кластера, при его остановке управление становится недоступно.
Как вывести узел из кластера?
На самом узле выполните docker swarm leave. Если узел менеджер, добавьте флаг --force. На менеджере удалите запись командой docker node rm <ID>.
Ещё по теме
- Руководство · Docker docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы