Docker Registry

Skitflow обеспечивает бесшовную интеграцию с репозиториями Docker Registry, позволяя развёртывать приложения непосредственно из контейнерных образов. Эта функция доступна для отдельных приложений и поддерживает как публичные, так и приватные реестры.

Обзор конфигурации

Для подключения Docker Registry к вашему приложению:

1. Перейдите на вкладку General вашего приложения
2. Выберите Docker в качестве источника
3. Настройте следующие параметры:

Интеграция с Docker Hub

Docker Hub является реестром по умолчанию и поддерживает аутентификацию как по имени пользователя/паролю, так и по токену.

Способ 1: Имя пользователя и пароль

1. Username: Введите ваше имя пользователя Docker Hub
2. Password: Введите ваш пароль Docker Hub

Способ 2: Токен доступа (рекомендуется)

Использование токенов доступа более безопасно и позволяет настроить детализированные разрешения:

1. Создание токена доступа:

   • Перейдите в Docker Hub Settings → Personal Access Tokens
   • Нажмите Generate New Token
   • Задайте описание: Skitflow-Docker-Hub-Token
   • Выберите разрешения Read-only
   • Нажмите Generate

2. Настройка в Skitflow:

   • Username: Ваше имя пользователя Docker Hub
   • Password: Вставьте сгенерированный токен доступа
   • Registry URL: Оставьте пустым (по умолчанию Docker Hub)

3. Развёртывание: Нажмите Save, затем Deploy на вкладке General

GitHub Container Registry (GHCR)

GHCR позволяет хранить контейнерные образы рядом с вашими репозиториями GitHub.

Предварительные требования

• Ваш Docker-образ должен быть уже опубликован в GHCR
• Вам нужен GitHub Personal Access Token с соответствующими разрешениями

Процесс настройки

1. Создание GitHub Personal Access Token:

   • Перейдите в GitHub Settings → Personal Access Tokens
   • Нажмите Generate new token (classic)
   • Задайте имя токена: Skitflow-GHCR-Token
   • Выберите следующие области доступа:
     • repo — доступ к репозиториям
     • workflow — доступ к GitHub Actions
     • write:packages — загрузка пакетов
     • delete:packages — удаление пакетов
   • Нажмите Generate token

2. Настройка в Skitflow:

   • Docker Image: ghcr.io/username/repository:tag
   • Registry URL: ghcr.io
   • Username: Ваше имя пользователя GitHub
   • Password: Вставьте сгенерированный Personal Access Token

3. Развёртывание: Нажмите Save, затем Deploy на вкладке General

Публичные образы

Для публичных образов из любого реестра:

• Docker Image: Полный путь к образу (например, quay.io/prometheus/prometheus:latest)
• Registry URL: Домен реестра (если не Docker Hub)
• Username: Оставьте пустым
• Password: Оставьте пустым

Лучшие практики

Устранение неполадок

Распространённые проблемы и решения:

• Authentication Failed: Проверьте учётные данные и разрешения токена
• Image Not Found: Проверьте правильность имени образа и тега
• Pull Rate Limits: Рассмотрите использование аутентифицированных запросов или приватных реестров
• Registry Timeout: Убедитесь, что URL реестра доступен с вашего инстанса Skitflow