Установка и запуск в режиме Docker-in-Docker


*Для тестового запуска, вам потребуется установить плагин Docker Compose. ,для Docker Engine
*Все команды описанные ниже, выполняются из директории с установочными файлами агента!

1. Перейдите в веб интерфейс приложения GitFlic -> Панель администратора -> СI/CD

http(s)://<Адрес веб интерфейса>/admin/runners

* Для регистрации агента в сервисе GitFlic.ru перейдите в Настройки компании -> Агенты CI/CD

https://gitflic.ru/company/<company_name>/setting/cicd/runners

2. Скопируйте и сохраните URL и Token

Получение токена

3. Откройте и отредактируйте файл docker-compose.yaml, изменив следующие параметры:

Параметр Тип Значение
DOCKER_REGISTRY_USERNAME string Имя пользователя для доступа к registry
DOCKER_REGISTRY_PASSWORD string Пароль пользователя для доступа к registry
DOCKER_REGISTRY_URL string URL для входа в registry
REG_URL string url полученный в веб интерфейсе приложения GitFlic в п.2
REG_TOKEN string Токен полученный в веб интерфейсе приложения GitFlic в п.2
DIDENABLE boolean Включает доступ к хостовому докер сокету внутри контейнера

* DIDENABLE параметр, включает доступ к хостовому docker.sock и позволяет управлять всей системой docker из контейнера с агентом GitFlic Runner. В контейнере, где исполняется задача, должен быть установлен docker engine. Не включайте данный параметр без необходимости и в публичных агентах.

! В связи с недоступностью Docker Hub, для корректной работы агента необходимо использование другого реестра docker образов.

Чтобы подключить к агенту GitFlic Docker Registry, необходимо изменить необходимые параметры в файле docker-compose.yaml по следующей схеме:

DOCKER_REGISTRY_USERNAME: #username пользователя на gitflic.ru
DOCKER_REGISTRY_PASSWORD: #транспортный токен пользователя на gitflic.ru
DOCKER_REGISTRY_URL: registry.gitflic.ru

*** При использовании старой версии агента (< 3.1.1), могут возникать ошибки при пулле образа gitflic-runner-helper, обусловленные недоступностью Docker Hub. Для их исправления требуется добавить в файл config/application.properties агента следующие параметры:

runner.helperImage=registry.gitflic.ru/company/gitflic/gitflic-runner-helper:{используемая версия агента}

4. Выполните команду на сборку и запуск контейнера

docker compose up --build