Create overlay network 'socket_proxy' on swarm before deploying docker_socket_proxy stack #6

Open
opened 2026-08-26 22:16:35 +02:00 by hermes · 0 comments
Contributor

Context

В admin/ansible:master и в PR #4 (feat/docker-socket-proxy-readonly) network socket_proxy объявлена в hermes_squid/stack-compose.yml:

networks:
  socket_proxy:
    external: true
    name: socket_proxy

Gitea/swarm не создают эту overlay-сеть автоматически при деплое стека, потому что external: true. Если сеть не существует к моменту docker stack deploy, деплой падает или sidecar'ы остаются без маршрутизации между overlay'ами.

Что нужно сделать

На odroid (manager node) до первого деплоя docker_socket_proxy стека (или сразу после первого деплоя, если сеть ещё не создана):

docker network create --driver overlay socket_proxy

Когда

  • Перед docker stack deploy -c docker_socket_proxy/stack-compose.yml docker_socket_proxy — обязательно, иначе стек не встанет.
  • Если docker_socket_proxy уже задеплоен — docker network ls | grep socket_proxy покажет, существует ли. Если нет — создать, swarm пересоздаст сервисы с корректной привязкой к overlay (или достаточно docker service update --force).

Зачем

Без overlay-сети socket_proxy:

  • sidecar docker_socket_proxy не сможет publish'ить интерфейс на этом overlay
  • downstream-консьюмеры (diun, portainer, watchtower — любые стеки, которым нужен read-only Docker API) не смогут networks: [socket_proxy] в своих docker-compose.yml
  • кросс-стековая маршрутизация через Hermes-инфру не будет работать

Связанные тикеты

  • #5 — re-deploy hermes_squid с новой веткой (зависит от этого, если делать в правильном порядке)
## Context В `admin/ansible:master` и в PR #4 (feat/docker-socket-proxy-readonly) network `socket_proxy` объявлена в `hermes_squid/stack-compose.yml`: ```yaml networks: socket_proxy: external: true name: socket_proxy ``` Gitea/swarm не создают эту overlay-сеть автоматически при деплое стека, потому что `external: true`. Если сеть не существует к моменту `docker stack deploy`, деплой падает или sidecar'ы остаются без маршрутизации между overlay'ами. ## Что нужно сделать На odroid (manager node) **до** первого деплоя `docker_socket_proxy` стека (или сразу после первого деплоя, если сеть ещё не создана): ``` docker network create --driver overlay socket_proxy ``` ## Когда - Перед `docker stack deploy -c docker_socket_proxy/stack-compose.yml docker_socket_proxy` — обязательно, иначе стек не встанет. - Если `docker_socket_proxy` уже задеплоен — `docker network ls | grep socket_proxy` покажет, существует ли. Если нет — создать, swarm пересоздаст сервисы с корректной привязкой к overlay (или достаточно `docker service update --force`). ## Зачем Без overlay-сети `socket_proxy`: - sidecar `docker_socket_proxy` не сможет publish'ить интерфейс на этом overlay - downstream-консьюмеры (diun, portainer, watchtower — любые стеки, которым нужен read-only Docker API) не смогут `networks: [socket_proxy]` в своих `docker-compose.yml` - кросс-стековая маршрутизация через Hermes-инфру не будет работать ## Связанные тикеты - #5 — re-deploy `hermes_squid` с новой веткой (зависит от этого, если делать в правильном порядке)
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: admin/ansible#6