Запуск агента в 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:{используемая версия агента}