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

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

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

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

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

Что такое аргументы сборки?

Аргументы сборки — это переменные, которые можно передать на этапе сборки Docker-образа. Они определяются в Dockerfile с помощью директивы ARG и могут быть заданы при выполнении команды docker build с флагом --build-arg.

Как это работает?

1. Определение аргумента в Dockerfile:

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

   ARG NODE_VERSION
   

   Это определяет переменную NODE_VERSION, которую можно использовать в Dockerfile.

2. Использование аргумента в Dockerfile:

   После определения аргумента его можно использовать в Dockerfile, например, в команде RUN или ENV:

   FROM node:${NODE_VERSION}
   

   Здесь NODE_VERSION используется для указания версии Node.js, которая будет установлена в образе.

3. Передача значения аргумента при сборке:

   При выполнении команды docker build значение аргумента передается с помощью флага --build-arg:

   docker build --build-arg NODE_VERSION=14 -t my-node-app .
   

   В этом примере значение 14 передается в качестве версии Node.js.

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

Рассмотрим полный пример Dockerfile, который использует аргументы сборки для установки определенной версии Node.js:

# Определяем аргумент сборки для версии Node.js
ARG NODE_VERSION
​
# Используем базовый образ Node.js с указанной версией
FROM node:${NODE_VERSION}
​
# Устанавливаем рабочую директорию
WORKDIR /app
​
# Копируем package.json и package-lock.json
COPY package*.json ./
​
# Устанавливаем зависимости
RUN npm install
​
# Копируем исходный код приложения
COPY . .
​
# Определяем команду для запуска приложения
CMD ["node", "app.js"]

Комментарии к коду:

• ARG NODE_VERSION: Определяет аргумент сборки NODE_VERSION, который будет использоваться для указания версии Node.js.
• FROM node:${NODE_VERSION}: Использует значение NODE_VERSION для выбора базового образа Node.js.
• WORKDIR /app: Устанавливает рабочую директорию внутри контейнера.
• COPY package*.json ./: Копирует файлы package.json и package-lock.json в рабочую директорию.
• RUN npm install: Устанавливает зависимости, указанные в package.json.
• COPY . .: Копирует все файлы из текущей директории в рабочую директорию контейнера.
• CMD ["node", "app.js"]: Определяет команду, которая будет выполнена при запуске контейнера.

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

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