Переменные среды для сборки 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 revision

  • org.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