Provision
—— XP

Практика: сборка образа в Container Registry

практика~40 минут+525 XP

Конвейер умеет проверять. Теперь он будет ещё и собирать: брать Dockerfile приложения из ~/infra/app, собирать образ и класть его в реестр твоего GitLab. Тегом станет хеш коммита — так у каждой версии будет своё имя, и на любую можно вернуться.

Сначала два подготовительных шага на стенде: включить реестр и объяснить Docker, что ему можно доверять.

Шаг 1. Включить реестр

Реестр включается одной строкой в настройках GitLab. Открой ~/gitlab/compose.yaml и допиши строку в конец GITLAB_OMNIBUS_CONFIG, с тем же отступом, что у остальных.

дописать в GITLAB_OMNIBUS_CONFIG
        registry_external_url 'http://192.168.1.50:5050'

И опубликуй порт реестра — добавь строку в список ports сервиса gitlab:

дописать в ports сервиса gitlab
      - "5050:5050"   # Container Registry

Шаг 2. Пересоздать GitLab

Настройки окружения читаются только при создании контейнера, поэтому up -d пересоздаст его. Данные в томах не пострадают.

ubuntu@stand:~$
cd ~/gitlab
docker compose up -d gitlab
ubuntu@stand:~$
[+] Running 1/1
 ✔ Container gitlab  Recreated

Recreated — контейнер пересоздан с новыми настройками. Подожди 3–5 минут, пока docker compose ps не покажет (healthy).

Шаг 3. Доверить реестру без TLS

Наш реестр работает по HTTP, а Docker по умолчанию требует HTTPS. Разрешим ему один адрес. Настройки демона Docker живут в /etc/docker/daemon.json.

sudo nano /etc/docker/daemon.json
{
  "insecure-registries": ["192.168.1.50:5050"]
}

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

Шаг 4. Перезапустить Docker

Демон перечитывает daemon.json только при старте.

ubuntu@stand:~$
sudo systemctl restart docker

Перезапуск остановит все контейнеры, а те, у кого restart: unless-stopped, поднимутся сами — включая GitLab и раннер. GitLab снова будет просыпаться несколько минут. Проверим, что настройка применилась:

ubuntu@stand:~$
docker info | grep -A2 Insecure
ubuntu@stand:~$
 Insecure Registries:
  192.168.1.50:5050
  ::1/128

Флаг -A2 у grep печатает две строки после найденной. Наш адрес в списке — Docker будет ходить в реестр по HTTP.

Шаг 5. Стадия сборки

Теперь конвейер. Новая ветка — и вторая стадия в начале .gitlab-ci.yml.

ubuntu@stand:~$
cd ~/infra
git switch -c ci/build
в начале .gitlab-ci.yml
stages:
  - check
  - build

Шаг 6. Задача сборки: только build

Допиши в конец файла новую задачу. Образ docker:29-cli содержит программу docker. Начнём с одной команды — собрать образ.

дописать в .gitlab-ci.yml
build-image:
  stage: build
  image: docker:29-cli
  variables:
    IMAGE: $CI_REGISTRY_IMAGE/app:$CI_COMMIT_SHORT_SHA
  script:
    - docker build -t "$IMAGE" app/

variables задаёт переменную самой задачи: IMAGE — полное имя образа, собранное из встроенных переменных. Для коммита a2f5d81b оно станет 192.168.1.50:5050/devops/infra/app:a2f5d81b. Флаг -t у docker build — имя будущего образа, как в разделе 07. Закоммить и отправь ветку: git add .gitlab-ci.yml, git commit -m "ci: сборка образа", git push -u gitlab ci/build. Задача упадёт:

конец журнала build-image
ERROR: failed to connect to the docker API at tcp://docker:2375: lookup docker on 127.0.0.53:53: server misbehaving
ERROR: Job failed: exit code 1

В контейнере задачи есть программа docker, но нет самого Docker — демона, который собирает образы. Не найдя его сокет, образ docker:29-cli ищет демон по сети, по имени docker, и такого имени нет.

Шаг 7. Дать задачам Docker

Пробросим задачам сокет Docker стенда. Открой настройки раннера и замени одну строку.

sudo nano ~/gitlab/runner/config.toml
    volumes = ["/var/run/docker.sock:/var/run/docker.sock", "/cache"]

Перезапускать ничего не надо: раннер сам замечает правку config.toml и перечитывает его. В GitLab нажми у упавшей задачи Retry — теперь она соберёт образ. Помни цену из урока про раннеры: задачи этого раннера теперь управляют всем Docker стенда, а доступ к сокету Docker равен правам root.

Шаг 8. Войти и отправить

Образ собран, но лежит только на стенде. Отправим его в реестр GitLab. Допиши в script две команды — вход перед сборкой и отправку после:

script задачи build-image целиком
  script:
    - echo "$CI_REGISTRY_PASSWORD" | docker login -u "$CI_REGISTRY_USER" --password-stdin "$CI_REGISTRY"
    - docker build -t "$IMAGE" app/
    - docker push "$IMAGE"

Конвейеру пароль не нужен: GitLab сам выдаёт задаче временный вход во встроенных переменных. Пароль передаётся через | на вход, флаг --password-stdin — «читай пароль со входа», так он не попадёт в список процессов. Без docker login отправка упадёт с unauthorized: реестр закрытого проекта чужих не пускает.

Шаг 9. Только в main и после проверки

Сейчас образ собирается на каждый push любой ветки. В merge request достаточно проверок, а образ нужен тому, что поедет на стенд, — только из основной ветки. И собирать его стоит только после того, как прошла проверка Compose. Допиши в задачу:

дописать в задачу build-image
  needs: [compose-config]
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

needs — сборка ждёт только проверку Compose, а не всю стадию. rules — правило запуска: только когда ветка коммита — основная.

Шаг 10. Через merge request в main

Путь тот же, что в практике 09: коммит, ветка, MR.

ubuntu@stand:~$
git add .gitlab-ci.yml
git commit -m "ci: сборка образа в реестр"
git push -u gitlab ci/build

Флаг -m — сообщение коммита, -u — связать ветку с сервером.

В конвейере merge request задачи build-image нет — правило её не пустило, и это правильно. Когда проверки зелёные, нажми Merge. Теперь открой Build → Pipelines: сверху конвейер по main с двумя колонками, check и build.

Шаг 11. Журнал сборки

Открой задачу build-image, когда она закончится. Главное — в последних строках.

фрагмент журнала
Login Succeeded
docker build -t "$IMAGE" app/
 => naming to 192.168.1.50:5050/devops/infra/app:a2f5d81b
docker push "$IMAGE"
a2f5d81b: digest: sha256:4c1e9f... size: 1783
Job succeeded

naming to … — образ собран с нужным именем. Строка с digest — реестр принял образ и сообщил его отпечаток. Пароля в журнале нет: GitLab замаскировал бы его, но мы его и не печатали.

Шаг 12. Образ в интерфейсе и на стенде

Открой Deploy → Container registry → app. В списке тег из восьми символов — это хеш коммита слияния, его же видно на странице конвейера.

Сборка шла через Docker стенда, поэтому образ уже лежит у тебя локально. Проверим:

ubuntu@stand:~$
docker image ls | grep 5050/devops
ubuntu@stand:~$
192.168.1.50:5050/devops/infra/app:a2f5d81b   9b3e1c4d7a20   142MB   48.2MB

Колонки — имя с тегом через двоеточие, идентификатор образа, место на диске и размер содержимого. Так таблицу печатает Docker 29; в старых версиях имя и тег стояли в разных колонках, а в статьях ты ещё встретишь шапку REPOSITORY TAG. Заберём себе свежую main:

ubuntu@stand:~$
git switch main
git pull

Шаг 13. Сдать

Выполни команду сдачи: она проверит настройки реестра, доверие Docker и наличие собранного образа.

Практика 05+525 XP

Собрать образ приложения в конвейере и положить его во встроенный реестр GitLab с тегом по хешу коммита — без единого пароля в репозитории.

  • Реестр включён в GitLab
  • Docker стенда доверяет реестру
  • Вход через встроенные переменные
  • Образ собран с тегом коммита
Команда сдачи — выполни на своей машине
команда
grep registry_external_url ~/gitlab/compose.yaml; docker info 2>/dev/null | grep -A2 Insecure; docker image ls | grep ':5050/devops/infra/app'; cd ~/infra; git show gitlab/main:.gitlab-ci.yml | grep -E 'CI_REGISTRY|docker push'

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