🐳 Как получить хэш коммита в запущенном контейнере Docker

1. Обзор

В этом руководстве мы рассмотрим, как получить хэш коммита из запущенного контейнера Docker.

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

2. Понимание важности хэша коммита

Хэш коммита однозначно идентифицирует конкретное состояние нашей кодовой базы в системе контроля версий. Наличие этой информации может быть очень важно для отслеживания изменений, отладки и обеспечения согласованности в различных средах.

Типичный хэш коммита выглядит так: ce85e2ebe299cf9a8237556c86dbcaaa2d571a3e.

3. Тег образов Docker с помощью хэша коммита

При сборке образов Docker принято помечать их хэшем коммита.

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

3.1. Создание и тег образа

Чтобы протегать наш образ Docker хэшем коммита в процессе сборки, мы можем использовать следующую команду:

$ docker build --build-arg GIT_COMMIT=$(git rev-parse HEAD) -t my_image:$(git rev-parse HEAD)

В этой команде -build-arg GIT_COMMIT=$(git rev-parse HEAD) передает текущий хэш коммита процессу сборки Docker, а -t my_image:$(git rev-parse HEAD) помечает собранный образ тем же хэшем коммита, создавая прямую связь между образом Docker и конкретным состоянием исходного кода.

3.2. Конфигурация Dockerfile

Мы также можем передать хэш фиксации в качестве аргумента сборки и установить его в качестве переменной окружения в Dockerfile:

FROM alpine
ARG GIT_COMMIT
ENV GIT_COMMIT=$GIT_COMMIT

4. Получение хэша коммита из запущенного контейнера

Когда контейнер запущен, мы можем получить хэш коммита с помощью различных методов.

Давайте рассмотрим некоторые из них.

4.1. Использование Docker Inspect

Команда docker inspect позволяет получить исчерпывающую информацию о контейнере, включая его переменные окружения.

Этот метод полезен, когда мы хотим получить хэш коммита, не заходя в сам контейнер.

Вот пример команды для достижения этой цели:

$ docker inspect --format='{{.Config.Env}}' <container_id>

Например, мы можем использовать команду:

$ docker inspect --format='{{.Config.Env}}' my_container

В результате будет получен результат:

[PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin GIT_COMMIT=ce85e2ebe299cf9a8237556c86dbcaaa2d571a3e]

4.2. Прямой доступ к переменным окружения

Если процесс сборки устанавливает хэш фиксации как переменную окружения в образе, мы можем получить к нему доступ непосредственно из запущенного контейнера.

Такой подход оказывается полезным, когда нам нужен хэш фиксации для скриптовых целей внутри контейнера.

Вот команда для получения переменной окружения:

$ docker exec <container_id> printenv GIT_COMMIT

Например, мы можем применить эту команду:

$ docker exec my_container printenv GIT_COMMIT

Результат выполнения этой команды следующий:

ce85e2ebe299cf9a8237556c86dbcaaa2d571a3e

5. Автоматизация процесса

Чтобы сделать процесс извлечения беспрепятственным, рассмотрите возможность автоматизации этих шагов в рамках нашего CI/CD-конвейера.

Интегрируйте хэш-теги коммита и извлечения в наш пайплайн CI/CD, чтобы обеспечить согласованность и автоматизировать шаги проверки:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout code
      uses: actions/checkout@v2
    - name: Build Docker image
      run: docker build --build-arg GIT_COMMIT=${{ github.sha }} -t my_image:${{ github.sha }} .

6. Работа с ошибками

Иногда получение информации из остановленного или несуществующего контейнера может привести к ошибкам.

Обеспечьте правильную обработку ошибок в скриптах, чтобы справляться с ними изящно.

Если мы попытаемся проверить неработающий контейнер, мы можем столкнуться со следующей ошибкой:

Error: No such object: <container_id>

Мы должны включить обработку ошибок в наши скрипты, чтобы справиться с такими случаями:

if ! docker inspect <container_id>; then
  echo "Container not found or not running"
fi

7. Заключение

В этой статье мы рассмотрели различные методы получения хэша коммита из запущенного Docker-контейнера.

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

Внедрение этих методов в наш конвейер CI/CD обеспечивает согласованность и оптимизирует рабочий процесс разработки.

см. также:

DevOps Docker