6.6 KiB
title, type, created, status, baseline_commit, review_loop_iteration, context
| title | type | created | status | baseline_commit | review_loop_iteration | context |
|---|---|---|---|---|---|---|
| Исправить runtime Docker build при недоступном Debian HTTP mirror | bugfix | 2026-08-29 | done | 55209a9bbc |
0 |
Intent
Problem: Release build успешно компилирует Rust binaries, но runtime-слой debian:bookworm-slim обращается к deb.debian.org по HTTP/80. В CI этот порт недоступен, поэтому apt-get update оставляет пустые indexes и установка ca-certificates curl завершается ошибкой.
Approach: Перевести Debian repositories обоих Rust runtime images на HTTPS, предварительно bootstrap-ить доверенный CA bundle из уже используемого Rust builder image, и добавить ограниченные apt retries для кратковременных сетевых сбоев.
Boundaries & Constraints
Always: Одинаково исправить admin-api и mcp-server; TLS verification остаётся включённой; runtime сохраняет ca-certificates для исходящих HTTPS-запросов и curl для существующих Compose healthchecks; Docker build остаётся воспроизводимым в текущем multi-stage layout.
Ask First: Смена runtime base image, удаление curl/healthchecks, добавление нового healthcheck binary или изменение release workflow.
Never: Acquire::https::Verify-Peer=false, trusted/unsigned repositories, fallback на HTTP, бесконечные retry loops или игнорирование ненулевого exit code apt-get.
I/O & Edge-Case Matrix
| Scenario | Input / State | Expected Output / Behavior | Error Handling |
|---|---|---|---|
| HTTP/80 недоступен | Registry доступен, Debian mirror доступен только по HTTPS/443 | Оба runtime images собираются через HTTPS repositories | Build падает, если HTTPS или signature verification реально не проходят |
| Чистый slim runtime | В runtime layer ещё нет ca-certificates package |
CA bundle из builder позволяет проверить TLS первого apt-get update |
Нельзя отключать TLS verification для bootstrap |
| Кратковременный mirror failure | HTTPS request временно не проходит | APT выполняет конечное число повторов | После исчерпания retries build завершается ошибкой |
| Runtime contract | Image успешно собран | CA bundle непустой, curl установлен, application entrypoint/CMD сохранены |
Contract check не запускает сервис и не меняет production state |
Code Map
apps/admin-api/Dockerfile:17-23— runtime stage устанавливает CA/curl; builder уже содержит/etc/ssl/certs/ca-certificates.crt.apps/mcp-server/Dockerfile:54-60— тот же runtime bootstrap и источник текущего CI failure на строке 56.docker-compose.yml:130,193— healthchecks зависят отcurlвнутри images.deploy/community/docker-compose.yml:144,205иdeploy/community/docker-compose.images.yml:141,202— packaged community healthchecks подтверждают, чтоcurlнельзя удалить локальным workaround..gitea/workflows/ci.yml:267-268,371-375и.gitea/workflows/release.yml:197-202— оба Dockerfile собираются в CI/release; workflow менять не требуется.
Tasks & Acceptance
Execution:
apps/admin-api/Dockerfile— скопировать CA bundle из builder до первого HTTPS request, переключить Debian sources на HTTPS и включить bounded retries.apps/mcp-server/Dockerfile— применить идентичный runtime bootstrap, не меняя binary build/CMD.- Docker verification — собрать оба images и проверить наличие CA bundle/curl внутри runtime layers.
Acceptance Criteria:
- Given исходный CI network profile с недоступным HTTP/80 и доступным HTTPS/443, when собираются
admin-apiиmcp-server, then оба builds завершаются успешно без ослабления TLS или repository signature verification. - Given собранные images, when проверяется runtime contract, then
curlдоступен, CA bundle непустой, а исходные ENTRYPOINT/CMD остаются неизменными.
Spec Change Log
Design Notes
CA bootstrap берётся из rust:1.96.1-bookworm, уже являющегося доверенной build stage на той же Debian-family базе. После HTTPS apt-get update пакет ca-certificates устанавливается штатно и становится владельцем актуального runtime trust store.
Verification
Commands:
docker build --progress=plain -f apps/admin-api/Dockerfile -t crank/admin-api:ci-fix .— passed; runtime APT получил подписанные indexes через HTTPS и установилca-certificates/curl.docker build --progress=plain -f apps/mcp-server/Dockerfile -t crank/mcp-server:ci-fix .— passed.docker run --rm --entrypoint sh crank/admin-api:ci-fix -c 'test -s /etc/ssl/certs/ca-certificates.crt && curl --version >/dev/null'— passed.docker run --rm --entrypoint sh crank/mcp-server:ci-fix -c 'test -s /etc/ssl/certs/ca-certificates.crt && curl --version >/dev/null'— passed.docker image inspect ...— passed; admin image сохранилENTRYPOINT [\"/usr/local/bin/crank-admin-entrypoint\"]иCMD [\"admin-api\"], MCP image сохранилCMD [\"mcp-server\"].git diff --check— passed.
Suggested Review Order
-
Основной runtime bootstrap: доверенный CA, HTTPS-only sources и ограниченные повторы APT.
admin-api/Dockerfile:19 -
Тот же защищённый bootstrap применён к MCP runtime без изменения команды запуска.
mcp-server/Dockerfile:56