Установка и запуск в режиме 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