Первое изображение

Перед запуском

Понадобятся Docker с Compose, доступ к выданному образу zorkaImgTune, ключ активации и каталог исходных изображений. Образ и ключ выдаются для вашей поставки: примеры ниже не создают лицензию и не открывают доступ к registry.

Скачайте compose.yaml и config.yaml. Сохраните конфигурацию в deploy/config.yaml рядом с Compose, а ключ — в secrets/license.key.

1. Укажите пути и образ

Создайте .env рядом с compose.yaml:

# Замените на выданный вам образ и закреплённый тег или digest.
ZORKA_IMAGE=registry.example.com/team/zorka:RELEASE
ZORKA_CONFIG=./deploy/config.yaml
ZORKA_LICENSE_KEY_FILE=./secrets/license.key
UPLOAD_DIR=/srv/website/upload
ZORKA_PORT=8088
ZORKA_ADMIN_PORT=9090

Пользователь контейнера 10001 должен читать конфигурацию, файл ключа и исходные изображения. Каталог изображений монтируется только для чтения. Не добавляйте реальные ключи и .env в Git.

2. Запустите сервис

docker compose up -d
curl --fail http://127.0.0.1:8088/ready

/ready проверяет готовность обслуживать запросы. Для защищённой поставки требуется действующая лицензия и соединение с сервером лицензий, указанным в поставке.

3. Получите изображение

Положите photo.jpg в каталог UPLOAD_DIR, затем выполните:

curl --fail -D /tmp/zorka-headers.txt   -H 'Accept: image/webp'   http://127.0.0.1:8088/upload/photo.jpg   -o /tmp/zorka-test.webp

Проверьте Content-Type, размер файла и визуальное качество. Повторите запрос: заголовок X-Image-Cache покажет, откуда получен ответ. Размеры исходного изображения сохраняются.

4. Подключите тестовую страницу

Направьте запросы изображений через свой reverse proxy. Начните с небольшой группы изображений, сравните результат и только затем расширяйте подключение. TLS завершайте на внешнем прокси; admin-порт оставьте на loopback.

Дальше: интеграции, конфигурация и диагностика.