Files
reg/reg.conf.example
2026-11-05 06:40:24 +03:00

136 lines
6.3 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ============================================================================
# reg — Docker Registry Client
# Configuration file template
# ============================================================================
#
# Usage:
# cp reg.conf.example ~/.reg/reg.conf
# $EDITOR ~/.reg/reg.conf
#
# The ~/.reg directory is created automatically by reg on any startup if
# it does not exist.
#
# Format: key=value, one per line.
# Empty lines and lines starting with '#' are ignored.
# Inline comments ('#' at the start of the value or after whitespace)
# are stripped: "registry=https://host # main" -> "https://host".
#
# CLI flags take precedence over values in this file (see README).
#
# Path: ~/.reg/reg.conf (in the user's home directory). In CI/CD, the path
# can be given explicitly via -config <path>.
# If the file does not exist, all values must be passed via CLI flags.
# ============================================================================
#
# Использование:
# cp reg.conf.example ~/.reg/reg.conf
# $EDITOR ~/.reg/reg.conf
#
# Каталог ~/.reg создаётся автоматически при любом запуске reg, если
# отсутствует.
#
# Формат: key=value, по одному параметру на строку.
# Пустые строки и строки, начинающиеся с '#', игнорируются.
# Inline-комментарии ('#' в начале значения или после пробела)
# отбрасываются: "registry=https://host # main" -> "https://host".
#
# Флаги командной строки приоритетнее значений в этом файле (см. README).
#
# Путь: ~/.reg/reg.conf (в домашнем каталоге пользователя). В CI/CD путь
# можно указать явно через -config <path>.
# Если файла нет — все значения должны быть переданы флагами CLI.
# ============================================================================
# ----------------------------------------------------------------------------
# Default registry (required unless -r is given).
# The https:// scheme is added automatically if not specified.
#
# Реестр по умолчанию (обязателен, если не задан флагом -r).
# Схема https:// подставляется автоматически, если не указана.
# ----------------------------------------------------------------------------
# registry=https://registry.tld
registry=https://registry.tld
# ----------------------------------------------------------------------------
# Credentials vault.
# docker — use ~/.docker/config.json (and credential helpers if configured).
# local — use vault_file (Docker-compatible format).
# Default (if vault is absent): docker.
#
# Хранилище учётных данных.
# docker — использовать ~/.docker/config.json (и credential helpers).
# local — использовать vault_file (формат, совместимый с Docker).
# По умолчанию (если vault отсутствует): docker.
# ----------------------------------------------------------------------------
# vault=docker
# vault=local
# ----------------------------------------------------------------------------
# Local vault file (used only when vault=local).
# Path rules:
# vault_file=cred.json -> ~/.reg/cred.json
# vault_file=~/.config/credentials.json -> ~/.config/credentials.json
# vault_file=/var/run/vault.json -> full path
# vault_file=./ci/cred.json -> relative to cwd
# Default (if omitted): ~/.reg/credentials.json
# If vault_file is set but vault is not 'local', startup fails.
#
# Локальный файл vault (только при vault=local).
# Правила пути:
# vault_file=cred.json -> ~/.reg/cred.json
# vault_file=~/.config/credentials.json -> ~/.config/credentials.json
# vault_file=/var/run/vault.json -> полный путь
# vault_file=./ci/cred.json -> относительно cwd
# По умолчанию (если не задан): ~/.reg/credentials.json
# Если vault_file задан, а vault != 'local' — ошибка на старте.
# ----------------------------------------------------------------------------
# vault_file=~/.reg/credentials.json
# ----------------------------------------------------------------------------
# Credentials for the auth service (used for auto-challenge).
# If not set, the client tries the configured vault, then anonymous.
#
# Учётные данные для auth-сервиса (используются для авто-challenge).
# Если не заданы — клиент пробует настроенный vault, затем анонимно.
# ----------------------------------------------------------------------------
# username=myuser
# password=mypass
# ----------------------------------------------------------------------------
# Preset Bearer token.
# Priority: -token (CLI) > token (this file) > auto-obtained.
#
# Предустановленный Bearer-токен.
# Приоритет: -token (CLI) > token (этот файл) > авто-получение.
# ----------------------------------------------------------------------------
# token=eyJhbGciOiJSUzI1NiIs...
# ----------------------------------------------------------------------------
# Language for messages and help.
# Allowed values: en | ru.
#
# Язык сообщений об ошибках и справки.
# Допустимые значения: en | ru.
# ----------------------------------------------------------------------------
# lang=en
# lang=ru
# ----------------------------------------------------------------------------
# Skip TLS certificate verification (self-signed, local registries).
# Allowed values: 1 | 0 | true | false | yes | no | on | off.
# Default: 0.
#
# Пропуск проверки TLS-сертификата (self-signed, локальные реестры).
# Допустимые значения: 1 | 0 | true | false | yes | no | on | off.
# По умолчанию: 0.
# ----------------------------------------------------------------------------
# insecure=0
# insecure=1