Перейти до вмісту
Hokusai2.2.2
ivantokar.com

Docker

Hokusai 2 потребує libvips 8.16 або новішої. Ubuntu 24.04 LTS постачається з 8.15, а Debian 12 — із ще старішою, тож там apt install libvips-dev недостатньо: збірка завершується помилкою, бо старіші версії відхиляються під час компіляції. Debian 13 і Ubuntu 25.10 та новіші постачають 8.16 або новішу, але офіційних образів Swift для них не публікують, тож Dockerfile нижче збирає libvips із релізного архіву на етапі збірки й копіює її в мінімальний образ виконання. Це той самий підхід, яким власний CI Hokusai фіксує нативну базу.

examples/docker/Dockerfile
# Hokusai 2 needs libvips 8.16 or newer, which Ubuntu 24.04 does not ship (it has 8.15).
# This image builds libvips from a release tarball in the build stage and copies it to a slim runtime.
# ---- build ----------------------------------------------------------------
FROM swift:6.2-noble AS build
ARG VIPS_VERSION=8.16.1
RUN apt-get update && apt-get install -y --no-install-recommends \
build-essential meson ninja-build pkg-config curl xz-utils ca-certificates \
libglib2.0-dev libexpat1-dev libjpeg-turbo8-dev libpng-dev libwebp-dev libtiff-dev \
libheif-dev libcairo2-dev libpango1.0-dev libfontconfig1-dev \
&& rm -rf /var/lib/apt/lists/*
RUN curl -fsSL "https://github.com/libvips/libvips/releases/download/v${VIPS_VERSION}/vips-${VIPS_VERSION}.tar.xz" | tar -xJ -C /tmp \
&& cd "/tmp/vips-${VIPS_VERSION}" \
&& meson setup build --prefix=/opt/vips --libdir=lib --buildtype=release \
-Dintrospection=disabled -Dmodules=disabled -Dexamples=false \
&& meson install -C build \
&& rm -rf /tmp/vips-*
ENV PKG_CONFIG_PATH=/opt/vips/lib/pkgconfig
WORKDIR /src
COPY app/ .
RUN swift build -c release --product Resizer
# ---- runtime --------------------------------------------------------------
FROM ubuntu:noble
RUN apt-get update && apt-get install -y --no-install-recommends \
libglib2.0-0t64 libexpat1 libjpeg-turbo8 libpng16-16t64 libwebp7 libwebpmux3 libwebpdemux2 libtiff6 \
libheif1 libcairo2 libpango-1.0-0 libpangocairo-1.0-0 libpangoft2-1.0-0 libfontconfig1 \
fonts-dejavu-core ca-certificates \
&& rm -rf /var/lib/apt/lists/*
COPY --from=build /opt/vips /opt/vips
COPY --from=build /usr/lib/swift/linux/*.so* /usr/lib/swift/linux/
COPY --from=build /src/.build/release/Resizer /usr/local/bin/resizer
ENV LD_LIBRARY_PATH=/opt/vips/lib:/usr/lib/swift/linux
RUN useradd --system --create-home app
USER app
ENTRYPOINT ["resizer"]

Його зібрано й запущено для цієї сторінки (образ приблизно 323 МБ):

$ docker build -t hokusai-docs-check examples/docker
$ docker run --rm hokusai-docs-check
libvips 8.16.1, Cairo 1.18.0
can write: jpeg, pdf, png, tiff, webp
resized to 32 × 32, 516 bytes (webp)

Застосунок у examples/docker/app — кілька рядків: він друкує Hokusai.capabilities(), змінює розмір згенерованого зображення й кодує WebP.

  • Багатоетапний. Образ swift має інструментарій і компілятори; середовище виконання — звичайний ubuntu:noble лише з тими спільними бібліотеками, що потрібні libvips. Бібліотеки виконання Swift (/usr/lib/swift/linux/*.so) копіюються з етапу збірки, так контейнер працює без інструментарію; альтернатива — --static-swift-stdlib.
  • VIPS_VERSION. Зафіксуйте його як аргумент збірки й підвищуйте свідомо. hokusai info показує, що має контейнер.
  • Бібліотеки — це те, що ви встановите. Збірка вище не мала в образі бібліотек палітри, AVIF, кодувальника HEIF чи GIF, і capabilities() програми про це сказала: can write: jpeg, pdf, png, tiff, webp. Збірка libvips підтримує лише те, що її залежності надають під час збірки, тож додайте відповідні пакети -dev (і їхні пакети виконання на фінальному етапі) для кожного потрібного формату, а потім знову перевірте capabilities(). Не вважайте кодек наявним: запитайте середовище (можливості).
  • Шрифти. Відтворення тексту потребує шрифтів в образі виконання (вище fonts-dejavu-core) і libvips із Pango; TextStyle(fontFile:) завантажує файл, який ви поставляєте.
  • Користувач без прав root запускає процес.

Для сервісу Vapor чи Hummingbird замініть продукт Resizer власним, відкрийте порт і задайте RuntimeConfiguration під час запуску. У контейнері задавайте maxConcurrentEvaluations і maxQueuedEvaluations за обмеженнями ЦП і пам’яті, які ви йому дали: пам’ять — це приблизно кількість одночасних обчислень, помножена на декодований розмір зображень, які вони тримають (продуктивність). Задайте blockUntrustedOperations для сервісів, що декодують завантаження недовірених користувачів.