Переменные среды для сборки Docker Build
Вы можете установить следующие переменные среды, чтобы включить, отключить или изменяет поведение функций, связанных с построением:
Переменная |
Тип |
Описание |
---|---|---|
BUILDKIT_COLORS |
Строка |
Настройка цвета текста для вывода терминала. |
BUILDKIT_HOST |
Строка |
Указывает хост, который будет использоваться для удаленных строителей. |
BUILDKIT_PROGRESS |
Строка |
Настройка типа вывода прогресса. |
BUILDX_BUILDER |
Строка |
Указывает экземпляр строителя, который будет использоваться. |
BUILDX_CONFIG |
Строка |
Указывает местоположение для конфигурации, состояния и журналов. |
BUILDX_EXPERIMENTAL |
Булево |
Включает экспериментальные функции. |
BUILDX_GIT_CHECK_DIR TY |
Булево |
Включает обнаружение грязных Git-чекаутов. |
BUILDX_GIT_INFO |
Булево |
Удаляет информацию о Git в свидетельствах о происхождении. |
BUILDX_GIT_LABELS |
Строка | Булево |
Добавляйте к образам метки происхождения Git. |
ИСПЫТАНИЯ BUILDX_NO_DEFAULT_AT |
Булево |
Отключает проверку происхождения по умолчанию. |
BUILDX_NO_DEFAULT_LO AD |
Булево |
Отключает загрузку образов в хранилище образов по умолчанию. |
См. также Арги встроенной сборки BuildKit.
Вы можете выражать логические значения для переменных среды различными способами. Например, true
, 1
и T
вычисляются как true. Вычисление выполняется с помощью функции strconv.ParseBool
в стандартной библиотеке Go. Подробнее см. справочная документация.
BUILDKIT_COLORS
Изменяет цвета вывода терминала. Устанавливает BUILDKIT_COLORS
в строку CSV в следующем формате:
$ export BUILDKIT_COLORS="run=123,20,245:error=yellow:cancel=blue:warning=white"
Значения цвета могут быть любым допустимым шестнадцатеричным кодом RGB или одним из Предопределенные цвета BuildKit.
Установка для NO_COLOR
любого значения отключает раскрашенный вывод, как это рекомендовано no-color.org.
BUILDKIT_HOST
Введено в Buildx v0.9.0
Вы используете BUILDKIT_HOST
, чтобы указывает адрес демона BuildKit для использования в качестве удаленного сборщика. Это то же самое, что указывает адрес в качестве позиционного аргумента в docker buildx create
.
Использование:
$ export BUILDKIT_HOST=tcp://localhost:1234
$ docker buildx create --name=remote --driver=remote
Если вы указываете и переменную окружения BUILDKIT_HOST
, и позиционный аргумент, аргумент имеет приоритет.
BUILDKIT_PROGRESS
Устанавливает тип вывода прогресса BuildKit. Допустимыми значениями являются:
auto
(по умолчанию)plain
tty
Использование:
$ export BUILDKIT_PROGRESS=plain
BUILDX_BUILDER
Переопределяет настроенный экземпляр строителя. Аналогично флагу docker buildx --builder
CLI.
Использование:
$ export BUILDX_BUILDER=my-builder
BUILDX_CONFIG
Вы можете использовать BUILDX_CONFIG
для указания каталога, который будет использоваться для конфигурации сборки, состояния и журналов. Порядок поиска этого каталога следующий:
$BUILDX_CONFIG
$DOCKER_CONFIG/buildx
~/.docker/buildx
(по умолчанию)
Использование:
$ export BUILDX_CONFIG=/usr/local/etc
BUILDX_EXPERIMENTAL
Включает функции экспериментальной сборки.
Использование:
$ export BUILDX_EXPERIMENTAL=1
BUILDX_GIT_CHECK_DIRTY
Введено в Buildx v0.10.4
Если установлено значение true, проверяет наличие грязного состояния в информации системы управления версиями для свидетельства о происхождении.
Использование:
$ export BUILDX_GIT_CHECK_DIRTY=1
BUILDX_GIT_INFO
Введено в Buildx v0.10.0
Если установлено значение false, информация об управлении версиями удаляется из свидетельства о происхождении.
Использование:
$ export BUILDX_GIT_INFO=0
BUILDX_GIT_LABELS
Введено в Buildx v0.10.0
Добавляет метки происхождения, основанные на информации Git, к образам, которые вы создаёте. Данные метки следующие:
com.docker.image.source.entrypoint
: Расположение Dockerfile относительно корня проектаorg.opencontainers.image.revision
: Git commit revisionorg.opencontainers.image.source
: SSH или HTTPS-адрес хранилища
Пример:
"Labels": {
"com.docker.image.source.entrypoint": "Dockerfile",
"org.opencontainers.image.revision": "5734329c6af43c2ae295010778cd308866b95d9b",
"org.opencontainers.image.source": "[email protected]:foo/bar.git"
}
Использование:
Устанавливает
BUILDX_GIT_LABELS=1
, чтобы включить меткиentrypoint
иrevision
.Устанавливает
BUILDX_GIT_LABELS=full
, чтобы включить все этикетки.
Если хранилище находится в грязном состоянии, то revision
получает суффикс -dirty
.
BUILDX_NO_DEFAULT_ATTESTATIONS
Введено в Buildx v0.10.4
По умолчанию BuildKit v0.11 и более поздние версии добавляют свидетельства о происхождении к создаваемым вами образам. Устанавливает BUILDX_NO_DEFAULT_ATTESTATIONS=1
, чтобы отключить аттестацию происхождения по умолчанию.
Использование:
$ export BUILDX_NO_DEFAULT_ATTESTATIONS=1
BUILDX_NO_DEFAULT_LOAD
При сборке образа с помощью драйвера docker
образ автоматически загружается в хранилище образов по завершении сборки. Устанавливает BUILDX_NO_DEFAULT_LOAD
, чтобы отключить автоматическую загрузку образов в локальное хранилище контейнеров.
Использование:
$ export BUILDX_NO_DEFAULT_LOAD=1