Конфигурационные параметры Docker Registry

Для настройки сервиса используйте следующие параметры, доступные в ADCM.

ПРИМЕЧАНИЕ

Чтобы применить измененный параметр в ADCM, выполните одно из следующих действий:

  • Перезапустите сервис Docker Registry с помощью сервисного действия Restart.

  • Переустановите кластер ADET с помощью кластерного действия Reinstall.

Repositories
Параметр Описание Значение по умолчанию

Working directory

Абсолютный путь на хосте, по которому Docker Registry хранит образы контейнеров и установочные артефакты.

Эта директория необходима как для первичного развертывания, так и для последующей работы кластера. Не удаляйте файлы распакованных бандлов из этой директории — это приведет к сбоям в работе системных пакетных менеджеров (apt/dnf/yum) и аварийному завершению действий (action) в ADCM UI

/opt/arenadata/etools/registry

HTTPS listener
Параметр Описание Значение по умолчанию

Host

IP-адрес, по которому репозиторий Docker Registry доступен хостам, где разворачиваются продукты Arenadata

 — 

HTTPS port

Порт, по которому доступен репозиторий Docker Registry

443

Server certificate

TLS/HTTPS-сертификат репозитория Docker Registry в формате PEM (Privacy-Enhanced Mail). По умолчанию поле содержит самоподписанный сертификат, сгенерированный при установке продуктов Arenadata

 — 

Server private key

Криптографический приватный ключ, соответствующий сертификату сервера. Используется для защиты TLS/HTTPS-соединений с репозиторием Docker Registry. Рекомендуется алгоритм RSA.

ADCM не проверяет соответствие приватного ключа сертификату сервера. Перед сохранением конфигурации убедитесь, что пара ключей корректна

 — 

TLS Min Version

Минимальная разрешенная версия протокола TLS. Возможные значения:

  • tls1.0

  • tls1.1

  • tls1.2

  • tls1.3

tls1.2

Enable Auth
Параметр Описание Значение по умолчанию

Auth Type

Метод аутентификации для доступа к репозиторию Docker Registry. Если параметр Enable Auth включен, это поле обязательно для заполнения. Возможные значения: token, htpasswd.

Используйте htpasswd, чтобы аутентифицировать пользователей по имени пользователя и паролю, которыми управляет Arenadata Enterprise Tools.

Используйте token, чтобы делегировать аутентификацию внешнему сервису токенов, совместимому с token-аутентификацией Docker Registry.

Более подробную информацию можно получить в документации по аутентификации Docker Registry

 — 

List of users

Список пользователей, которым разрешен доступ к репозиторию Docker Registry при использовании аутентификации htpasswd. В этот список можно добавлять свойства в формате <username>:<password>. Arenadata Enterprise Tools использует этот список для создания и управления файлом .htpasswd, который Docker Registry использует для проверки учетных данных пользователей

 — 

htpasswd Authentication realm

Область аутентификации, которая отображается Docker-клиентам при запросе аутентификации htpasswd. Область идентифицирует защищенную зону доступа, для которой клиент должен предоставить учетные данные. Пример: Registry Realm

Registry Realm

htpasswd file path (managed by ET)

Путь (только для чтения) к файлу .htpasswd, которым управляет ADET. Docker Registry использует этот файл для аутентификации htpasswd

/opt/arenadata/etools/registry/config/.htpasswd

Token auth realm URL

URL внешнего эндпоинта, который используется для token-аутентификации. Когда Docker-клиент запрашивает доступ к registry, Docker Registry перенаправляет клиент на этот URL для получения access token. Пример: http://10.1.1.1:8080/realms/registry/protocol/docker-v2/auth. Более подробную информацию можно получить в документации по аутентификации Docker Registry

 — 

Token issuer

Издатель токенов, используемых для token-аутентификации. Docker Registry проверяет это значение, чтобы убедиться, что access token был выпущен доверенным сервисом токенов.

Значение должно точно совпадать со значением issuer, которое сервис токенов добавляет в токены, причем значение чувствительно к регистру. Например, если используется Keycloak, и realm, настроенный для аутентификации Docker Registry, называется registry, то издатель токена может выглядеть так: http://<keycloak-address>:8080/realms/registry

 — 

Token service name

Имя сервиса, для которого должны выпускаться токены. Docker Registry использует это значение, чтобы убедиться, что access token предназначен для данного Docker Registry.

Значение должно совпадать с именем сервиса, который использует сервис токенов. Например, при использовании Keycloak это значение может совпадать с client ID, настроенным для аутентификации Docker Registry. Поддерживается только одно имя сервиса. Значение не должно содержать пробелов и специальных символов, таких как &, ?, # и /. Пример: registry-client

 — 

CA bundle for token validation

CA-бандл (Certificate Authority bundle), который Docker Registry использует для проверки токенов, полученных от внешнего сервиса токенов. Значение должно содержать один сертификат или бандл сертификатов в формате PEM. Если указано несколько сертификатов, разместите их друг за другом в одном значении, при этом каждый сертификат должен начинаться с -----BEGIN CERTIFICATE----- и заканчиваться -----END CERTIFICATE-----

 — 

Other
Параметр Описание Значение по умолчанию

Enable image deletion

Разрешает удалять образы из репозитория Docker Registry. Если параметр включен, клиенты могут удалять манифесты и теги образов через Docker Registry API. Удаленные данные могут фактически удаляться с диска не сразу

false

Storage directory

Директория, в которой Docker Registry хранит свои внутренние данные

/var/lib/registry

Registry listen address

Адрес и порт, на которых Docker Registry принимает входящие подключения. Этот адрес может отличаться от внешнего HTTPS-порта, который клиенты используют для доступа к Docker Registry.

Значение по умолчанию 0.0.0.0:8443 означает, что Docker Registry слушает порт 8443 на всех доступных сетевых интерфейсах

0.0.0.0:8443

Log verbosity

Уровень логирования Docker Registry. Возможные значения в порядке от самого подробного к самому краткому: debug, info, warn, error

info

Log formatter

Формат логов Docker Registry. Возможные значения: text, json, logstash

text

Container restart policy

Политика перезапуска, применяемая к контейнеру Docker Registry. Возможные значения: no, always, on-failure, unless-stopped.

Значение по умолчанию always помогает поддерживать доступность Docker Registry, перезапуская контейнер после сбоев или перезапуска хоста. Более подробную информацию можно получить в документации Docker Engine

always

Custom Configuration Overrides

Пользовательские параметры, которые переопределяют конфигурацию Docker Registry по умолчанию. Пользовательские параметры конфигурации имеют приоритет над отдельными полями конфигурации. Используйте этот параметр для расширенных настроек, недоступных в виде отдельных полей конфигурации. Вложенные ключи указываются через точку, например storage.delete.enabled

 — 

Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней