Merge pull request 'fix(compose): устранена гонка сборки общих образов' (#178 ) from fix/compose-shared-image-build into main

Reviewed-on: #178
docs(compose): объяснение общей сборки сокращено
2026-08-28 13:05:17 +03:00 · 2026-08-28 13:03:47 +03:00 · 2026-08-28 12:53:33 +03:00
2 changed files with 13 additions and 4 deletions
@@ -48,10 +48,10 @@ x-kafka-target: &kafka-target

 x-world-starting-days: &world-starting-days "8"

+# Общие образы Airflow и Superset собирают службы инициализации. Причина
+# отдельного build: ADR 0001.
 x-airflow-common: &airflow-common
  image: clickstream-airflow:local
-  build:
-    context: ./infra/airflow
  environment:
    AIRFLOW__CORE__EXECUTOR: LocalExecutor
    AIRFLOW__CORE__PARALLELISM: "4"
@@ -105,8 +105,6 @@ x-generator-common: &generator-common

 x-superset-common: &superset-common
  image: clickstream-superset:local
-  build:
-    context: ./infra/superset
  environment:
    SUPERSET_CONFIG_PATH: /app/pythonpath/superset_config.py
    SUPERSET_SECRET_KEY: ${SUPERSET_SECRET_KEY:?Скопируйте .env.example в .env}
@@ -257,6 +255,8 @@ services:

  airflow-init:
    <<: *airflow-common
+    build:
+      context: ./infra/airflow
    user: "0:0"
    restart: "no"
    depends_on:
@@ -340,6 +340,8 @@ services:

  superset-init:
    <<: *superset-common
+    build:
+      context: ./infra/superset
    restart: "no"
    healthcheck:
      disable: true
@@ -16,6 +16,13 @@
 возвращает единицу — поведение проверено при исполнении #37. Зависимость
 включает результат подготовки в общий граф ожидания.

+У каждого общего локального образа один блок `build`. Он находится у службы
+инициализации. Остальные службы зависят от неё и используют тот же `image`.
+`docker compose up --build` завершает сборку до запуска контейнеров, поэтому
+одного блока достаточно. В Buildx 0.30.1 одинаковые блоки у нескольких служб
+запускают параллельный экспорт одного тега. Иногда сборка завершается ошибкой
+`image already exists`.
+
 Для входа выбран SimpleAuthManager. У него нет команды создания пользователя,
 поэтому `airflow-init` записывает пароль администратора из окружения в
 JSON-файл отдельного тома `airflow_auth`. Новый именованный том принадлежит