107 lines
13 KiB
Markdown
107 lines
13 KiB
Markdown
# П23 · январь 2020 · локальная разработка в Docker — тройное ревью
|
||
|
||
Статус: **принят в publication registry 31 июля 2026 года**. В нём ровно три
|
||
revision для стабильных slug; registry сохраняет метаданные базового архива:
|
||
|
||
- <code>editorial-2020-01-practice-docker-local</code>;
|
||
- <code>editorial-2020-01-mechanism-docker-local</code>;
|
||
- <code>editorial-2020-01-field-docker-local</code>.
|
||
|
||
Модуль не содержит полей <code>date</code> и <code>author</code>;
|
||
<code>articles.json</code>, стандарт, очередь и package config не
|
||
перезаписывались.
|
||
|
||
## Проход 1. Факты и версионные границы — пройдено
|
||
|
||
| Утверждение | Первичный или официальный источник | Редакторская граница |
|
||
| --- | --- | --- |
|
||
| Январь 2020 зафиксирован веткой Docker Engine 19.03 | [Docker Engine 19.03 release notes](https://docs.docker.com/engine/release-notes/19.03/) | Тексты называют Engine 19.03 контекстом примеров, но не обещают идентичное поведение на всех Docker Desktop, ОС или удалённых daemon |
|
||
| Исторический пример использует <code>docker-compose</code> и верхнее <code>version: '3.7'</code> | [Docker Compose FAQ](https://docs.docker.com/compose/support-and-feedback/faq/), [legacy Compose file versions](https://docs.docker.com/reference/compose-file/legacy-versions/) | Не подставлены Compose v2, Dev Containers, Kubernetes или BuildKit как личная практика автора 2020 года |
|
||
| Bind mount связывает путь машины Docker daemon с путём контейнера и может скрыть прежнее содержимое целевого пути | [Docker bind mounts](https://docs.docker.com/engine/storage/bind-mounts/) | Статьи не называют mount копированием файлов в образ; путь <code>working_dir</code> проверяется отдельно от рабочей копии |
|
||
| Named volume хранится под управлением Docker и переживает пересоздание контейнера | [Docker volumes](https://docs.docker.com/engine/storage/volumes/) | Полевая статья отделяет чистую базу от пересборки образа и запрещает глобальную очистку вместо расследования |
|
||
| Сервисное имя работает во внутренней bridge-сети, а опубликованный порт нужен для доступа с хоста | [Docker bridge network driver](https://docs.docker.com/engine/network/drivers/bridge/) | <code>localhost</code> всегда привязан к наблюдателю: браузеру хоста или процессу внутри контейнера |
|
||
| Подстановка Compose YAML и переменная процесса контейнера — разные стадии | [Docker Compose environment variables](https://docs.docker.com/compose/how-tos/environment-variables/set-environment-variables/) | <code>docker-compose config</code> не выдан за доказательство того, что Node уже прочитал переменную |
|
||
| Порядок запуска зависимости не доказывает её готовность принимать соединение | [Docker Compose startup order](https://docs.docker.com/compose/how-tos/startup-order/) | <code>depends_on</code> описан как порядок; статьи требуют отдельный лог или контрольный запрос, а не обещают работающий healthcheck |
|
||
|
||
Проверены три Compose-фрагмента: у <code>web</code>/<code>api</code> рабочая
|
||
директория совпадает с целевым bind mount, адрес PostgreSQL — <code>db</code>,
|
||
а <code>postgres_data</code> назван отдельным volume. Фрагменты не являются
|
||
снятым конфигом реального репозитория: Docker daemon не запускался, Compose не
|
||
поднимал контейнеры, PostgreSQL не принимал соединение. Поэтому все команды в
|
||
статьях сформулированы как маршрут проверки, а не как уже наблюдённый
|
||
production-результат.
|
||
|
||
Вердикт: **пройдено**. Факт API и файл-конфигурация отделены от поведения,
|
||
которое зависит от конкретного daemon, Dockerfile, ОС, сети и состояния базы.
|
||
|
||
## Проход 2. Редактура и голос М3 / январь 2020 — пройдено
|
||
|
||
| Ревизия | Проблема и цена в первых двух абзацах | Главный вопрос | Артефакт и честная граница |
|
||
| --- | --- | --- | --- |
|
||
| Практика | «Работает у автора», но ломается у коллеги; цена — случайные команды, скрытая причина и потерянное время onboarding | Как записать локальный контракт из кода, томов, сети и переменных | Compose-фрагмент, карта слоёв и два разных запроса; нет утверждения о совместимости со всеми ОС |
|
||
| Механизм | Запущенный API не видит базу, переменная не попадает в процесс, файл найден только на хосте; цена — ложная вера в одинаковую среду | Где проходят границы хоста, контейнера, сети и process env | Путь одного запроса и таблица наблюдателей; нет заявления, что зависимость уже готова только из-за <code>depends_on</code> |
|
||
| Полевой разбор | После миграции старая база остаётся, а глобальная очистка уничтожает данные; цена — потерянное состояние и нерасследованный дефект | Как проверить чистый запуск без удаления всего Docker | Классификация образа, контейнера, bind mount и volume; нет реального удаления данных или Docker run |
|
||
|
||
- Все три текста проходят жёсткий диапазон основного тела 5 000–15 000
|
||
знаков и не набивают объём общими вступлениями. В каждом первом абзаце
|
||
названы симптом и цена; далее повторяется практический порядок «симптом →
|
||
причина → проверка → действие → ограничение».
|
||
- Голос соответствует М3: автор уже уверенно связывает frontend и delivery,
|
||
но ещё учится дисциплине среды. Он работает с Dockerfile, Compose, логами,
|
||
service name, томами и маршрутом запроса; не изображает опыт
|
||
оркестратора, платформенной инженерии или поздних инструментов.
|
||
- У каждой статьи есть шесть или больше смысловых разделов, таблица с
|
||
<code>caption</code> и <code>thead</code>, figure с осмысленными
|
||
<code>alt</code>/<code>figcaption</code>, Compose или кодовый фрагмент,
|
||
нумерованный маршрут и минимум две официальные ссылки.
|
||
- Сам модуль останавливает импорт, если собственный текст без таблиц, кода и
|
||
рисунка выходит за 5 000–15 000 знаков. Отдельный draft gate дополнительно
|
||
проверяет stable slug, JSON-only CLI, количество ревизий, доступность
|
||
assets, обязательные структурные элементы и отсутствие <code>date</code> /
|
||
<code>author</code>.
|
||
|
||
Вердикт: **пройдено**. После самостоятельной вычитки удалены
|
||
ретроспективные названия поздних инструментов из авторского текста; остались
|
||
только необходимые исторические границы и проверяемые действия.
|
||
|
||
## Проход 3. Визуал и выпуск — пройдено в пределах автономного пакета
|
||
|
||
- <code>docker-local-environment-2020.svg</code> показывает различие
|
||
рабочей копии, bind mount, контейнера <code>web</code>, named volume
|
||
зависимостей, сети и <code>postgres_data</code>.
|
||
- <code>docker-local-request-path-2020.svg</code> ведёт от браузера на
|
||
хосте через опубликованный порт и process env API к <code>db:5432</code> и
|
||
persistent state.
|
||
- <code>docker-local-clean-start-2020.svg</code> показывает безопасный
|
||
порядок: снимок до изменения, классификация слоя, ограниченное действие,
|
||
один контрольный маршрут.
|
||
- У каждого SVG есть <code>title</code>, <code>desc</code>,
|
||
<code>role="img"</code> и <code>aria-labelledby</code>. В них нет
|
||
JavaScript, внешних URL, <code>foreignObject</code> или raster data URI.
|
||
У каждого использования в статье есть самостоятельный alt-текст и подпись.
|
||
- Основной редактор отрисовал каждый SVG через Sharp в PNG шириной 375 px и
|
||
просмотрел результат. На трёх схемах не обнаружены обрезание, наложение
|
||
текста или горизонтальный выход; вторичные подписи намеренно набраны
|
||
короткими строками. Это статическая проверка SVG, а не browser-run.
|
||
- После подключения registry strict audit и production build пройдены.
|
||
Реальные Docker Compose, browser и production-прогоны не выполнялись и не
|
||
заявляются выполненными: сборка статического сайта не доказывает поведение
|
||
конкретного Compose-стека.
|
||
|
||
### Фактически выполненные проверки
|
||
|
||
| Проверка | Команда | Реальный результат |
|
||
| --- | --- | --- |
|
||
| Синтаксис модуля | <code>node --check scripts/upgrade-2020-01.mjs</code> из <code>web/</code> | PASS |
|
||
| Import-safe export и draft gate | <code>npm run audit:draft -- scripts/upgrade-2020-01.mjs</code> из <code>web/</code> | PASS: 9 834 / 8 999 / 8 879 знаков body |
|
||
| XML трёх схем | <code>xmllint --noout public/assets/editorial/2020/docker-local-environment-2020.svg public/assets/editorial/2020/docker-local-request-path-2020.svg public/assets/editorial/2020/docker-local-clean-start-2020.svg</code> из <code>web/</code> | PASS |
|
||
| Визуальный mobile preflight | Sharp render трёх SVG в PNG шириной 375 px и ручной просмотр | PASS: нет клиппинга, наложения или горизонтального overflow |
|
||
| Strict audit после подключения registry | <code>npm run audit:articles</code> по трём slug | PASS: 9 834 / 8 999 / 8 879 знаков; по одному figure, table и code example |
|
||
| Production build | <code>npm run build</code> из <code>web/</code> | PASS, code 0, 374 статические страницы |
|
||
| Scope/self-review | Проверка revision и выпуска | PASS: нет <code>date</code>/<code>author</code>, <code>articles.json</code> не перезаписан |
|
||
|
||
Выпусковой вердикт: **тройное ревью пройдено, пакет принят к публикации**.
|
||
Registry заменяет только редакционные поля по стабильному slug. Публикация не
|
||
подменяет проверку реального Docker daemon, browser или production-стека: эти
|
||
действия остаются отдельным сценарием конкретного проекта.
|