Запуск агента в Kubernetes
* Данный раздел находиться в разработке!
Для запуска агента в kubernetes вам потребуется установить kubectl.
Для начала вам необходимо скопировать свой Kubeconfig файл для аутентификации в папку build-runner/config-files
, и переименовать в kubernetes-config
.
Далее вам потребуется собрать образ приложения из Dockerfile, для этого откройте окно терминала, перейдите в папку build-runner
, и введите команду:
docker build -t gitflic-runner:latest .
После этого на локальной машине создастся образ агента, на основе которого будет запущен под.
Далее необходимо применить конфигурационный файл runner-config.yaml
. Для этого вам необходимо открыть файл, и настроить его согласно вашим настройкам. Далее необходимо в окне терминала перейти в папку build-runner
, и выполнить команду:
kubectl apply -f kuber-config/runner-config.yaml
Далее необходимо применить конфигурационный файл deployment.yaml
. Для этого вам необходимо настроить поля, помеченные в файле согласно вашим настройкам. Далее необходимо в окне терминала перейти в папку build-runner
, и выполнить команду:
kubectl apply -f kuber-config/deployment.yaml
! В связи с недоступностью Docker Hub, для корректной работы агента необходимо использование другого реестра docker образов. Чтобы подключить к агенту GitFlic Docker Registry, необходимо изменить необходимые параметры в файле runner-config.yaml по следующей схеме:
docker.registry-username= #username пользователя на gitflic.ru
docker.registry-password= #транспортный токен пользователя на gitflic.ru
docker.registry-url=https\://registry.gitflic.ru
*** При использовании старой версии агента (< 3.1.1), могут возникать ошибки при пулле образа gitflic-runner-helper, обусловленные недоступностью Docker Hub. Для их исправления требуется добавить в runner-config.yaml следующие параметры:
runner.helperImage=registry.gitflic.ru/company/gitflic/gitflic-runner-helper:{используемая версия агента}
docker.registry-username= #username пользователя на gitflic.ru
docker.registry-password= #транспортный токен пользователя на gitflic.ru
docker.registry-url=https\://registry.gitflic.ru
Таким образом агент будет использовать GitFlic Docker Registry и корректный образ gitflic-runner-helper. Если необходимо при работе с агентом использовать другой реестр докер контейнеров, gitflic-runner-helper образ можно спуллить на машину, где запущен агент, используя параметры подключения к GitFlic Docker Registry, описанные выше. При этом в runner-config.yaml должно быть указано лишь:
runner.helperImage=registry.gitflic.ru/company/gitflic/gitflic-runner-helper:{используемая версия агента}