Migrate repo from docker to podman

- git mv docker-compose*.yml -> compose*.yml, Dockerfile -> Containerfile
  (podman-compose picks compose.yml; buildah finds Containerfile first)
- compose/compose.dev: x-podman.name_separator_compat (dash container
  names), explicit app/web healthchecks (OCI export drops image
  HEALTHCHECK, depends_on service_healthy would hang forever), fixed
  subnet 10.113.0.0/24 gw 10.113.0.1 for the aardvark-dns resolver
- gateway/nginx.conf: resolver + proxy_pass via variables (static
  proxy_pass resolves once at start; podman-restart.service brings
  gateway up before app -> dead upstream, 502 until manual restart)
- Containerfiles: pin base images to docker.io/library/* (no
  unqualified-search-registries on hosts), truthful buildah proxy comments
- comments/docs: Docker HEALTHCHECK -> container HEALTHCHECK; READMEs,
  AGENTS.md updated for podman/podman-compose

Verified on dev (podman 5.7.0, podman-compose 1.5.0): stack up with
dash names, app/web healthy, conversion through gateway returns PDF,
gateway survives app container restart without restart (resolver).
This commit is contained in:
Pjandro
2026-10-19 00:13:52 +00:00
parent ab1b25c352
commit 65746db9d2
15 changed files with 172 additions and 99 deletions
+1 -1
View File
@@ -41,7 +41,7 @@
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
</dependency>
<!-- /actuator/health — open-эндпоинт для Docker HEALTHCHECK -->
<!-- /actuator/health — open-эндпоинт для HEALTHCHECK контейнера -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
@@ -15,7 +15,7 @@ import java.security.MessageDigest;
/**
* Единственная граница доступа: заголовок {@value #HEADER} обязан совпадать с
* {@code wordpdf.api-key}. Пустое свойство = фильтрация выключена (dev/тесты).
* Наружу без ключа открыты {@code /actuator/**} (им дышит Docker HEALTHCHECK)
* Наружу без ключа открыты {@code /actuator/**} (им дышит HEALTHCHECK контейнера)
* и документация springdoc ({@code /swagger-ui*}, {@code /v3/api-docs*}) —
* браузер не может положить ключ в заголовок при загрузке UI; ключ обязателен
* для всего остального (фактически {@code /api/**}). Ответ 401 пишется здесь же,
@@ -30,7 +30,7 @@ final class ApiKeyFilter extends OncePerRequestFilter {
static final String HEADER = "X-API-Key";
/** Открытые пути без ключа: actuator (Docker HEALTHCHECK) и springdoc-документация. */
/** Открытые пути без ключа: actuator (HEALTHCHECK контейнера) и springdoc-документация. */
private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"};
/** null — аутентификация выключена. */
@@ -66,7 +66,7 @@ final class ApiKeyFilter extends OncePerRequestFilter {
* Путь приложения без forwarded-префикса: при
* server.forward-headers-strategy=framework заголовок X-Forwarded-Prefix
* становится contextPath, и getRequestURI() возвращает URI уже с ним —
* матч по сырому URI теряет /actuator/ (Docker HEALTHCHECK получил бы 401).
* матч по сырому URI теряет /actuator/ (HEALTHCHECK контейнера получил бы 401).
*/
private static String path(HttpServletRequest request) {
return request.getRequestURI().substring(request.getContextPath().length());
@@ -15,7 +15,7 @@ spring.servlet.multipart.file-size-threshold=100MB
wordpdf.convert-timeout=2m
# Ключ доступа (заголовок X-API-Key). Пусто = аутентификация выключена
# (dev: java -jar / тесты). В docker-compose задан ${WORDPDF_API_KEY:?} — fail-closed.
# (dev: java -jar / тесты). В compose.yml задан ${WORDPDF_API_KEY:?} — fail-closed.
wordpdf.api-key=
# Работа за префикс-срезающим прокси (прод: наружный nginx срезает
@@ -81,7 +81,7 @@ class ApiKeyFilterTest {
@Test
void healthOpenWithoutKey() throws Exception {
// Docker HEALTHCHECK дышит /actuator/** без ключа — иначе контейнер
// HEALTHCHECK контейнера дышит /actuator/** без ключа — иначе контейнер
// никогда не станет healthy
mockMvc.perform(get("/actuator/health"))
.andExpect(status().isOk());