Provision
—— XP

Переменные, секреты и Container Registry

теория~6 минут+210 XP

Один из самых частых способов слить пароль от сервера — записать его прямо в .gitlab-ci.yml. Файл лежит в репозитории, репозиторий читают все, у кого есть доступ, а история Git помнит пароль даже после того, как строку удалили. Чтобы конвейер ходил на сервер без такого риска, в GitLab есть переменные CI/CD — значения, которые он подставляет в каждую задачу как переменные окружения из раздела 03.

Часть переменных GitLab даёт сам: имя ветки, хеш коммита, адрес реестра. Остальные — адреса серверов, пароли, ключи — заводишь ты в настройках проекта, и в репозитории их не будет вовсе. Это тот же .env из раздела 06, только лежит он в сейфе GitLab и выдаётся задаче на время её работы. Вместе со встроенным реестром образов переменные закрывают задачу сборки: конвейер собирает образ, помечает его хешем коммита и кладёт в Container Registry своего проекта — без единого пароля в файле.

Встроенные переменные

GitLab кладёт в каждую задачу десятки переменных с приставкой CI_. Тебе на первое время нужны пять:

Встроенные переменные на каждый день
CI_COMMIT_SHORT_SHA
Короткий хеш коммита, например a2f5d81b. Им помечают образы.
CI_COMMIT_BRANCH
Ветка, в которой идёт конвейер. Пусто для тегов и merge request.
CI_DEFAULT_BRANCH
Основная ветка проекта, у нас main.
CI_REGISTRY_IMAGE
Адрес образа проекта в реестре: 192.168.1.50:5050/devops/infra.
CI_REGISTRY_USER и CI_REGISTRY_PASSWORD
Временный вход в реестр, действует только пока идёт задача.

Полный список — на странице «Predefined CI/CD variables» в документации GitLab. Если сомневаешься, что лежит в переменной, напиши в задаче echo "$CI_COMMIT_BRANCH" и посмотри в журнал. Только не печатай так секреты — об этом ниже.

Встроенных переменных хватает для сборки. Для выката понадобятся свои.

Свои переменные и секреты

Свои переменные заводят в проекте: Settings → CI/CD → Variables → Add variable. У каждой есть ключ, значение и несколько настроек, от которых зависит безопасность.

Настройки переменной
Type
Variable — обычная строка. File — GitLab запишет значение во временный файл и положит в переменную путь к нему. Для SSH-ключей и сертификатов.
Visibility: Masked
Значение заменяется на [MASKED] в журнале задачи. Требует минимум 8 символов в одну строку.
Visibility: Masked and hidden
То же, плюс значение нельзя посмотреть в интерфейсе после сохранения.
Protect variable
Переменная попадает только в задачи защищённых веток и тегов.

Пароли и ключи для выката помечают сразу двумя флагами: masked, чтобы не утекли в журнал, и protected, чтобы их получала только main. Без защиты ветки флаг protected бессмыслен — поэтому в практике 05 ты закрыл прямой push.

Маскирование не абсолютно. GitLab вырезает из вывода точное совпадение со значением. Значение по частям, в base64 или внутри экранированного JSON маска не поймает. Классические утечки — отладочный set -x, который печатает команды с подставленными значениями, и команда env «посмотреть, что есть». Журнал задачи видят все участники проекта, и хранится он месяцами.

Переменные решают, чем конвейер входит на сервер. Но собранный образ тоже надо где-то держать, иначе серверу будет нечего скачивать.

Container Registry

Container Registry — встроенный в GitLab реестр образов, такой же, как локальный registry:3 из раздела 07, только у каждого проекта своя полка и вход по учётке GitLab. В Omnibus он включается одной строкой: registry_external_url с адресом и портом, у нас http://192.168.1.50:5050.

Путь образа строится от проекта: 192.168.1.50:5050/devops/infra/app:a2f5d81b. Слева адрес реестра, потом группа и проект, потом имя образа и тег. Все образы проекта видны в интерфейсе: Deploy → Container registry.

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

Конвейеру войти в реестр просто: GitLab сам даёт каждой задаче временные CI_REGISTRY_USER и CI_REGISTRY_PASSWORD, они живут, пока идёт задача. А вот серверу, на который выкатывают, тоже нужно скачивать образ, и делает он это без конвейера. Для этого в проекте заводят токен развёртывания (deploy token, Settings → Repository → Deploy tokens) с одним правом read_registry — только скачивать образы. Входить на сервере паролем root GitLab нельзя: пароль администратора осядет в файле ~/.docker/config.json, и с ним можно сделать в GitLab что угодно.

Наш реестр работает по HTTP, без TLS. Docker по умолчанию с таким не разговаривает и отвечает http: server gave HTTP response to HTTPS client. Для стенда адрес добавляют в список insecure-registries демона Docker; на рабочем сервере реестр закрывают сертификатом, как nginx в разделе 05.

Словарь урока

Переменная CI/CD
Значение, которое GitLab подставляет в задачу как переменную окружения.
Masked
Значение заменяется на [MASKED] в журнале. Защищает только от точного совпадения. ↩ к тексту
Protected
Переменная доступна только задачам защищённых веток и тегов. ↩ к тексту
Переменная типа File
GitLab пишет значение в файл, а в переменную кладёт путь. Для ключей и сертификатов.
Container Registry
Встроенный реестр образов GitLab: у каждого проекта своя полка. ↩ к тексту
Токен развёртывания
Deploy token: учётка проекта с узким правом, например read_registry — только скачивать образы. Им входит сервер. ↩ к тексту

Что спросят на собеседовании

  • Где хранить пароль для выката из конвейера?
    В переменной CI/CD проекта или группы с флагами masked и protected, а основную ветку защитить. В репозитории секретов быть не должно, включая историю.
  • Почему образы не помечают только тегом latest?
    latest перезаписывается каждой сборкой: по нему не понять, что внутри, и на него нельзя откатиться. Помечают хешем коммита или версией.

Что дальше

Дальше — включить реестр, собрать образ в конвейере и найти его в интерфейсе.

Проверь себя+210 XPдве попытки
1
Встроенные переменные
Что лежит в переменной CI_COMMIT_SHORT_SHA?
2
Секреты
Что делает флаг Protect variable?
3
Маскирование
Почему маскирование не даёт полной защиты?
4
Container Registry
Чем задача входит в Container Registry своего проекта?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.