Один из самых частых способов слить пароль от сервера — записать его прямо в .gitlab-ci.yml. Файл лежит в репозитории, репозиторий читают все, у кого есть доступ, а история Git помнит пароль даже после того, как строку удалили. Чтобы конвейер ходил на сервер без такого риска, в GitLab есть переменные CI/CD — значения, которые он подставляет в каждую задачу как переменные окружения из раздела 03.
Часть переменных GitLab даёт сам: имя ветки, хеш коммита, адрес реестра. Остальные — адреса серверов, пароли, ключи — заводишь ты в настройках проекта, и в репозитории их не будет вовсе. Это тот же .env из раздела 06, только лежит он в сейфе GitLab и выдаётся задаче на время её работы. Вместе со встроенным реестром образов переменные закрывают задачу сборки: конвейер собирает образ, помечает его хешем коммита и кладёт в Container Registry своего проекта — без единого пароля в файле.
Встроенные переменные
GitLab кладёт в каждую задачу десятки переменных с приставкой CI_. Тебе на первое время нужны пять:
Полный список — на странице «Predefined CI/CD variables» в документации GitLab. Если сомневаешься, что лежит в переменной, напиши в задаче echo "$CI_COMMIT_BRANCH" и посмотри в журнал. Только не печатай так секреты — об этом ниже.
Встроенных переменных хватает для сборки. Для выката понадобятся свои.
Свои переменные и секреты
Свои переменные заводят в проекте: Settings → CI/CD → Variables → Add 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 проекта или группы с флагами masked и protected, а основную ветку защитить. В репозитории секретов быть не должно, включая историю.
- Почему образы не помечают только тегом latest?latest перезаписывается каждой сборкой: по нему не понять, что внутри, и на него нельзя откатиться. Помечают хешем коммита или версией.
Что дальше
Дальше — включить реестр, собрать образ в конвейере и найти его в интерфейсе.