Установка GitLab Agent

Приложение GitLab Agent используется для подключения кластера Managed Service for Kubernetes к GitLab. Вы можете развернуть приложение как в инстансе Yandex Managed Service for GitLab, так и в standalone-инстансе GitLab.

GitLab Agent позволяет:

• Работать с кластерами Kubernetes, находящимися за NAT.
• Получать доступ к API кластера Kubernetes в реальном времени.
• Получать информацию о событиях в кластере Kubernetes.
• Включить кеш объектов Kubernetes, которые обновляются с очень низкой задержкой.

Перед началом работы

1. Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

   По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

2. Установите kubectl и настройте его на работу с созданным кластером.

3. Создайте инстанс Managed Service for GitLab или standalone-инстанс.

4. Создайте файл конфигурации агента в репозитории:

   1. Откройте ваш инстанс GitLab и перейдите в ваш проект.
   2. В ветке main создайте новый каталог .gitlab/agents/<имя агента GitLab>.
   3. В каталоге <имя агента GitLab> создайте пустой файл config.yaml.

5. Зарегистрируйте агента в GitLab и получите токен доступа:

   1. Откройте ваш инстанс GitLab и перейдите в ваш проект.
   2. Нажмите кнопку Infrastructure и выберите пункт Kubernetes clusters.
   3. Нажмите кнопку Connect a cluster и выберите имя агента <имя агента GitLab>.
   4. Нажмите кнопку Register an agent.
   5. GitLab создаст токен, который потребуется для установки приложения. Сохраните токен в безопасном месте.

Установка с помощью Yandex Cloud Marketplace

1. Перейдите на страницу каталога и выберите сервис Managed Service for Kubernetes.
2. Нажмите на имя нужного кластера Kubernetes и выберите вкладку Marketplace.
3. В разделе Доступные для установки приложения выберите GitLab Agent и нажмите кнопку Использовать.
4. Задайте настройки приложения:
   • Пространство имен — выберите пространство имен или создайте новое.
   • Название приложения — укажите название приложения, например gitlab-agent.
   • Имя домена GitLab — укажите имя вашего домена GitLab, например gitlab-test.gitlab.yandexcloud.net.
   • Токен доступа агента — скопируйте в это поле токен доступа GitLab, полученный ранее.
5. Нажмите кнопку Установить.
6. Дождитесь, пока статус приложения изменится на Deployed.
7. Откройте ваш инстанс GitLab и перейдите на страницу Infrastucture → Kubernetes clusters. Убедитесь, что агент перешел в состояние Connected.

Установка с помощью Helm-чарта

1. Установите менеджер пакетов Helm версии не ниже 3.7.0.

2. Для установки Helm-чарта с GitLab Agent выполните команду:

   export HELM_EXPERIMENTAL_OCI=1 && \
   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/gitlab-org/gitlab-agent/chart/gitlab-agent \
     --version <версия Helm-чарта> \
     --untar && \
   helm upgrade --install \
     --namespace <пространство имен> \
     --create-namespace \
     --set config.kasAddress='wss://<имя вашего домена GitLab>/-/kubernetes-agent/' \
     --set config.token='<токен доступа GitLab>' \
     gitlab-agent ./gitlab-agent
   

   Актуальную версию Helm-чарта можно посмотреть на странице приложения.

   Эта команда также создаст новое пространство имен, необходимое для работы приложения.

3. Убедитесь, что под GitLab Agent перешел в состояние Running:

   kubectl get pods --namespace gitlab-agent
   

4. Откройте ваш инстанс GitLab и перейдите на страницу Infrastucture → Kubernetes clusters. Убедитесь, что агент перешел в состояние Connected.

См. также

• Документация Managed Service for GitLab.
• Документация GitLab Agent.