Установка GitLab Agent

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

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

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

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

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

   По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

2. Убедитесь, что группы безопасности для кластера Managed Service for Kubernetes и его групп узлов настроены корректно. Если отсутствует какое-либо из правил — добавьте его.

   Важно

   От настройки групп безопасности зависит работоспособность и доступность кластера, а также запущенных в нем сервисов и приложений.

3. Подготовьтесь к установке GitLab Agent:

   1. Создайте инстанс Managed Service for GitLab или standalone-инстанс.
   2. Создайте файл конфигурации агента в репозитории:
      1. Откройте ваш инстанс GitLab и перейдите в ваш проект.
      2. В ветке main создайте новый каталог .gitlab/agents/<имя_агента_GitLab>.
      3. В каталоге <имя_агента_GitLab> создайте пустой файл config.yaml.
   3. Зарегистрируйте агента в GitLab и получите токен доступа:
      1. Откройте ваш инстанс GitLab и перейдите в ваш проект.
      2. На панели слева выберите пункт Operate и в выпадающем меню выберите пункт Kubernetes clusters.
      3. Нажмите кнопку Connect a cluster и выберите имя агента <имя_агента_GitLab>.
      4. Нажмите кнопку Register.
      5. GitLab создаст токен, который потребуется для установки приложения. Сохраните токен в безопасном месте.

   Примечание

   Подробнее о настройке и регистрации агента см. в документации GitLab.

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

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

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

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

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

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

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

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

   Если вы укажете в параметре namespace пространство имен по умолчанию, GitLab Agent может работать некорректно. Рекомендуем указывать значение, отличное от всех существующих пространств имен (например, gitlab-agent-space).

   Примечание

   Если вы используете версию Helm ниже 3.8.0, добавьте в начало команды строку export HELM_EXPERIMENTAL_OCI=1 && \, чтобы включить поддержку Open Container Initiative (OCI) в клиенте Helm.

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

   kubectl get pods --namespace=<пространство_имен>
   

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

Примеры использованияПримеры использования

• Непрерывное развертывание контейнеризованных приложений с помощью GitLab.

См. такжеСм. также

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