Перейти к содержанию

Установка и запуск в Docker контейнере

Запуск с использованием Docker Compose

  1. Установите плагин Docker Compose для Docker Engine

  2. Перейдите в веб интерфейс приложения GitFlic -> Панель администратора -> СI/CD

    GitFlic -> Панель администратора -> СI/CD

    http(s)://<Адрес веб интерфейса>/admin/runners

    Настройки компании -> Агенты CI/CD*

    https://gitflic.ru/company/<company_name>/setting/cicd/runners

  3. Скопируйте и сохраните URL и Token

    Получение токена

  4. Создайте файл docker-compose.yaml и заполните его необходимой информацией

    services:
    runner:
        container_name: <Имя контейнера>
        image: registry.gitflic.ru/company/gitflic/runner:<Версия агента>
        environment:
            DOCKER_REGISTRY_USERNAME: "" # Имя пользователя для доступа к Docker реестру
            DOCKER_REGISTRY_PASSWORD: "" # Пароль пользователя для доступа к Docker реестру
            DOCKER_REGISTRY_URL: "https://registry.gitflic.ru" # URL Docker реестра
            REG_URL: "" # URL, полученный в приложении GitFlic
            REG_TOKEN: "" # Токен, полученный в приложении GitFlic
            NAME: "" # Задает имя агента. Если отсутствует или пусто, то будет выбрано случайное
            TAGS: "" # Задает теги. Если отсутствует или пусто, то теги не будут установлены
            LOG_LEVEL: INFO # Задает уровень логирования
            IN_SESSION: true # Включает или выключает выполнение скриптов в одном контексте
            DIDENABLE: false # Включает или выключает Docker-in-Docker
            PRIVILEGED: false # Включает или выключает запуск контейнеров в привилегированном режиме
            CONCURRENCY_MODE: DEFAULT # Настройка мультизадачности агента. Возможные значения: DEFAULT, AUTO, CUSTOM
            LIMIT_OF_CONCURRENCY_TO_PROCESS_JOBS: 8 # Максимальное количество задач, которые агент может выполнять одновременно. Работает только при CONCURRENCY_MODE=CUSTOM
        volumes:
        - /var/run/docker.sock:/var/run/docker.sock # Монтирование сокета Docker Engine
        - runner-config:/gitflic-runner/config # Volume для хранения настроек агента
        - runner-log:/gitflic-runner/log # Volume для хранения логов агента
        network_mode: host # Режим работы Docker сети. Во избежании проблем с самоподписными сертификатами рекомендуется использовать host
        restart: unless-stopped # Политика перезапуска контейнера
volumes:
    runner-config:
        name: runner-config
    runner-log:
        name: runner-log

  5. Запустите агента

    docker compose -p gitflic-runner -f ./docker-compose.yaml up -d

Дополнительные параметры

При запуске агента через Docker Compose возможно указание дополнительных параметров с помощью добавления файла конфигурации в Volume runner-config. Файл конфигурации должен иметь расширение .properties.

Запуск без Docker Compose

Выполните команду на запуск:

docker run \
  --env "REG_URL=<URL полученный в приложении GitFlic>" \
  --env "REG_TOKEN=<Регистрационный токен агента, полученный в интерфейсе GitFlic>" \
  --volume runner-config:/gitflic-runner/config \
  --volume runner-log:/gitflic-runner/log \
  --volume //var/run/docker.sock://var/run/docker.sock \
  --detach \
  registry.gitflic.ru/company/gitflic/runner:latest

Выполните команду на запуск:

docker run \
  --env "REG_URL=<URL полученный в приложении GitFlic>" \
  --env "REG_TOKEN=<Регистрационный токен агента, полученный в интерфейсе GitFlic>" \
  --volume runner-config:/gitflic-runner/config \
  --volume runner-log:/gitflic-runner/log \
  --volume //var/run/docker.sock://var/run/docker.sock \
  --detach \
  registry.gitflic.ru/company/gitflic/runner:latest