n1ro°
RU

Ошибки и коды · Инструкция

Docker build context слишком большой и долго отправляется: как уменьшить

Перед сборкой клиент передаёт build context builder-у. Если в context попали гигабайты зависимостей или репозиторий цели

Редакция N1RO · Проверено

Короткий ответ

Уменьшите build context и добавьте `.dockerignore` для `node_modules`, `.git`, артефактов сборки, логов и других ненужных каталогов. В Dockerfile можно COPY только то, что реально требуется слою.

Что делать

  1. Посмотрите размер context: Запустите build с подробным выводом и отметьте этап передачи context.
  2. Создайте `.dockerignore`: Исключите `.git`, локальные caches, `node_modules`, build outputs и секреты.
  3. Сузьте директорию: Запускайте `docker build` из минимального каталога, который содержит нужные файлы.
  4. Оптимизируйте COPY: Копируйте lock/manifests отдельно от исходников, если это соответствует модели сборки.
  5. Повторите: Сравните размер/время передачи context после изменений.

Важно

Не исключите из context файл, который реально нужен COPY/RUN: build тогда станет невоспроизводимым.

Что учитывать

Не исключите из context файл, который реально нужен COPY/RUN: build тогда станет невоспроизводимым.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. docker image build). Пример и формулировки — редакция N1RO на 2026-09-17.