Установка Thumbor

Thumbor — проект с открытым исходным кодом, предназначенный для обработки изображений по запросу. Thumbor работает как HTTP-сервис и выполняет такие преобразования как обрезка изображений, масштабирование, наложение фильтров и многие другие.

Возможности Thumbor:

• Поддержка всех популярных форматов изображений.
• Умная обрезка и масштабирование.
• Ускорение обработки изображений за счет кэширования.
• Поддержка различных типов хранилищ (локальный диск, Yandex Object Storage и другие).
• Распознавание лиц и предметов (очки, особенности внешности) на базе технологии компьютерного зрения.
• Интеграция с различными языками программирования.

Перед началом работы

1. Создайте бакет с ограниченным доступом в Object Storage.

2. Загрузите изображения в бакет.

3. Создайте сервисный аккаунт, необходимый для работы Thumbor.

4. Создайте для него статический ключ и сохраните в файл sa-key.json:

   yc iam access-key create \
     --service-account-name <имя_сервисного_аккаунта_для_Thumbor> \
     --format json > sa-key.json
   

5. Задайте права доступа на чтение объектов бакета для сервисного аккаунта.

6. Убедитесь, что группы безопасности для кластера Managed Service for Kubernetes и его групп узлов настроены корректно. Если отсутствует какое-либо из правил — добавьте его.

   Важно

   От настройки групп безопасности зависит работоспособность и доступность кластера, а также запущенных в нем сервисов и приложений.

Установка с помощью Yandex Cloud Marketplace

1. Перейдите на страницу каталога и выберите сервис Managed Service for Kubernetes.

2. Нажмите на имя нужного кластера Kubernetes и выберите вкладку Marketplace.

3. В разделе Доступные для установки приложения выберите Thumbor и нажмите кнопку Перейти к установке.

4. Задайте настройки приложения:

   • Пространство имен — создайте новое пространство имен (например, thumbor-space). Если вы оставите пространство имен по умолчанию, Thumbor может работать некорректно.
   • Название приложения — укажите название приложения.
   • Имя бакета — укажите имя бакета, созданного ранее.
   • Статический ключ для доступа к Object Storage — вставьте содержимое файла sa-key.json.
   • (Опционально) Ключ безопасности — укажите ключ безопасности для подписывания URL.
   • Разрешить URL без подписи (unsafe) — выберите эту опцию, если вы не указывали ключ безопасности на предыдущем шаге.
   • Подкаталог в бакете — укажите имя каталога в бакете (без завершающего символа /), в котором находятся изображения.

5. Нажмите кнопку Установить.

   Для обеспечения работы Thumbor будет автоматически создан сервис Kubernetes типа LoadBalancer и соответствующий ему балансировщик Yandex Network Load Balancer.

6. Дождитесь перехода приложения в статус Deployed.

Установка с помощью Helm-чарта

1. Установите менеджер пакетов Helm версии не ниже 3.8.0.

2. Установите kubectl и настройте его на работу с созданным кластером.

3. Для установки Helm-чарта с Thumbor выполните команду, указав в ней параметры ресурсов, созданных ранее:

   URL без подписи разрешены

   URL без подписи запрещены

   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/thumbor/thumbor/chart/thumbor \
     --version 0.1.1-4 \
     --untar && \
   helm install \
     --namespace <пространство_имен_для_Thumbor> \
     --create-namespace \
     --set bucket_name='<имя_бакета>' \
     --set allow_unsafe_url='true' \
     --set root_path='<имя_подкаталога_в_бакете>' \
     --set-file saAccessKeyFile='sa-key.json' \
    thumbor ./thumbor
   

   Если вы укажете в параметре namespace пространство имен по умолчанию, Thumbor может работать некорректно. Рекомендуем указывать значение, отличное от всех существующих пространств имен (например, thumbor-space).

   Примечание

   Если вы используете версию Helm ниже 3.8.0, добавьте в начало команды строку export HELM_EXPERIMENTAL_OCI=1 && \, чтобы включить поддержку Open Container Initiative (OCI) в клиенте Helm.

   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/thumbor/thumbor/chart/thumbor \
     --version 0.1.1-4 \
     --untar && \
   helm install \
     --namespace <пространство_имен_для_Thumbor> \
     --create-namespace \
     --set bucket_name='<имя_бакета>' \
     --set allow_unsafe_url='false' \
     --set security_key='<ключ_безопасности_для_подписывания_URL>' \
     --set root_path='<имя_подкаталога_в_бакете>' \
     --set-file saAccessKeyFile='sa-key.json' \
    thumbor ./thumbor/
   

   Если вы укажете в параметре namespace пространство имен по умолчанию, Thumbor может работать некорректно. Рекомендуем указывать значение, отличное от всех существующих пространств имен (например, thumbor-space).

   Примечание

   Если вы используете версию Helm ниже 3.8.0, добавьте в начало команды строку export HELM_EXPERIMENTAL_OCI=1 && \, чтобы включить поддержку Open Container Initiative (OCI) в клиенте Helm.

   Для обеспечения работы Thumbor будет автоматически создан сервис Kubernetes типа LoadBalancer и соответствующий ему балансировщик Yandex Network Load Balancer.

Получение доступа к приложению

Подробнее о работе с изображениями см. в документации Thumbor.

Что дальше

Узнайте, как использовать приложение Thumbor для редактирования изображений на вашем сайте. Пример работы с Thumbor, рассмотренный в документации, включает в себя настройку сервиса Yandex Cloud CDN. Он позволяет снизить скорость загрузки изображений на сайте.

См. также

• Документация Thumbor.
• Документация Object Storage.
• Документация Network Load Balancer.