К содержимому

Docker Swarm на Ubuntu 24.04: пошаговая настройка кластера

Docker Swarm входит в Docker Engine и не требует отдельных пакетов. Кластер поднимается командой docker swarm init на первом сервере, остальные узлы подключаются по выданному токену. Первый сервис запускается одной командой docker service create.

Руководство Docker 2 мин чтения

01Проверьте, что Docker установлен

На сервере уже должен работать Docker Engine. Убедитесь, что демон отвечает и версия клиента совпадает с сервером. Если команда не найдена, установите Docker по отдельной инструкции.

bash
docker version

02Инициализируйте менеджер Swarm

Первый узел становится менеджером и хранит состояние кластера. Укажите адрес, по которому другие узлы будут к нему подключаться: --advertise-addr с публичным или приватным IP сервера. Команда выведет строку подключения воркера и токен менеджера, сохраните их.

bash
docker swarm init --advertise-addr 203.0.113.10

03Подключите рабочие узлы

На каждом дополнительном сервере выполните команду docker swarm join, которую вывел менеджер. Она содержит адрес менеджера и токен воркера. Если токен потерян, менеджер покажет его снова командой docker swarm join-token worker.

bash
docker swarm join --token SWMTKN-1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxx 203.0.113.10:2377

04Проверьте состав кластера

На менеджере выведите список узлов. В колонке STATUS должно быть Ready, в AVAILABILITY значение Active. Колонка MANAGER STATUS пуста у воркеров и содержит Leader у менеджера.

bash
docker node ls

05Запустите первый сервис

Сервис это единица работы в Swarm, а не отдельный контейнер. Команда docker service create создаёт задачу и распределяет её по узлам. Порт публикуется в режиме ingress, и Swarm сам балансирует запросы между репликами.

bash
docker service create --name web --replicas 2 --publish published=80,target=80 nginx:1.24

06Масштабируйте сервис

Число реплик меняется без пересоздания сервиса. Swarm запустит новые задачи на свободных узлах. Уменьшение реплик останавливает лишние задачи.

bash
docker service scale web=3

07Проверьте работу сервиса

Команда docker service ps показывает задачи сервиса и узел, на котором каждая работает. В колонке CURRENT STATE должно быть Running. Запрос к опубликованному порту возвращает страницу nginx.

bash
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 Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.