Как передать переменные внутрь Docker-образа во время сборки

1️⃣ Как кратко ответить

Для передачи переменных внутрь Docker-образа во время сборки используйте директиву ARG в Dockerfile для определения переменных и флаг --build-arg с командой docker build для их передачи.

2️⃣ Подробное объяснение темы

При сборке Docker-образа иногда необходимо передать внутрь переменные, которые могут влиять на процесс сборки. Это может быть полезно для передачи конфигурационных параметров, секретов или других данных, которые не должны быть жестко закодированы в Dockerfile. Для этого используется механизм аргументов сборки.

Определение переменных в Dockerfile

В Dockerfile переменные, которые могут быть переданы во время сборки, определяются с помощью директивы ARG. Это позволяет указать имя переменной и, при необходимости, значение по умолчанию.

Пример Dockerfile:

# Определяем аргумент сборки с именем VERSION
ARG VERSION=latest
​
# Используем переменную VERSION для установки базового образа
FROM ubuntu:${VERSION}
​
# Устанавливаем пакеты
RUN apt-get update && apt-get install -y curl

• ARG VERSION=latest: Определяет аргумент сборки с именем VERSION и значением по умолчанию latest.
• FROM ubuntu:${VERSION}: Использует значение переменной VERSION для указания версии базового образа Ubuntu.

Передача переменных при сборке

Чтобы передать значение переменной во время сборки, используется флаг --build-arg с командой docker build.

Пример команды сборки:

docker build --build-arg VERSION=20.04 -t myimage:20.04 .

• --build-arg VERSION=20.04: Передает значение 20.04 для аргумента VERSION, определенного в Dockerfile.
• -t myimage:20.04: Указывает тег для создаваемого образа.

Зачем это нужно

Использование аргументов сборки позволяет:

• Гибкость: Легко изменять параметры сборки без изменения Dockerfile.
• Безопасность: Избегать жесткого кодирования чувствительных данных в Dockerfile.
• Универсальность: Создавать образы с различными конфигурациями из одного Dockerfile.

Пример использования

Предположим, у вас есть приложение, которое должно быть собрано с различными версиями зависимостей в зависимости от окружения. Вы можете использовать аргументы сборки для передачи нужных версий зависимостей.

Dockerfile:

# Определяем аргумент для версии Python
ARG PYTHON_VERSION=3.8
​
# Используем переменную PYTHON_VERSION для установки базового образа
FROM python:${PYTHON_VERSION}
​
# Устанавливаем зависимости
COPY requirements.txt /app/
RUN pip install -r /app/requirements.txt

Команда сборки:

docker build --build-arg PYTHON_VERSION=3.9 -t mypythonapp:3.9 .

• ARG PYTHON_VERSION=3.8: Определяет версию Python по умолчанию.
• FROM python:${PYTHON_VERSION}: Использует переменную для выбора версии Python.
• docker build --build-arg PYTHON_VERSION=3.9: Передает версию Python 3.9 для сборки образа.

Таким образом, аргументы сборки позволяют создавать более гибкие и настраиваемые Docker-образы, что особенно важно в DevOps-практиках для автоматизации и управления конфигурациями.