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 фіксує нативну базу.
Dockerfile
Section titled “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 buildARG 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/pkgconfigWORKDIR /srcCOPY app/ .RUN swift build -c release --product Resizer
# ---- runtime --------------------------------------------------------------FROM ubuntu:nobleRUN 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/vipsCOPY --from=build /usr/lib/swift/linux/*.so* /usr/lib/swift/linux/COPY --from=build /src/.build/release/Resizer /usr/local/bin/resizerENV LD_LIBRARY_PATH=/opt/vips/lib:/usr/lib/swift/linuxRUN useradd --system --create-home appUSER appENTRYPOINT ["resizer"]Його зібрано й запущено для цієї сторінки (образ приблизно 323 МБ):
$ docker build -t hokusai-docs-check examples/docker$ docker run --rm hokusai-docs-checklibvips 8.16.1, Cairo 1.18.0can write: jpeg, pdf, png, tiff, webpresized to 32 × 32, 516 bytes (webp)Застосунок у examples/docker/app — кілька рядків: він друкує Hokusai.capabilities(), змінює розмір згенерованого зображення й кодує WebP.
Вибір у Dockerfile
Section titled “Вибір у Dockerfile”- Багатоетапний. Образ
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 запускає процес.
Запуск сервера
Section titled “Запуск сервера”Для сервісу Vapor чи Hummingbird замініть продукт Resizer власним, відкрийте порт і задайте RuntimeConfiguration під час запуску. У контейнері задавайте maxConcurrentEvaluations і maxQueuedEvaluations за обмеженнями ЦП і пам’яті, які ви йому дали: пам’ять — це приблизно кількість одночасних обчислень, помножена на декодований розмір зображень, які вони тримають (продуктивність). Задайте blockUntrustedOperations для сервісів, що декодують завантаження недовірених користувачів.