Запуск с помощью операций Git
В этом руководстве приведены примеры команд Git для запуска PAC pipeline через операции Git.
В этом руководстве показаны распространенные команды Git, используемые для запуска PAC pipeline через события Git provider.
PAC использует webhook'и от Git provider'ов (GitHub, GitLab, Bitbucket и т. д.) для обнаружения событий:
- Настройка webhook: Когда вы создаете Repository CR, PAC автоматически настраивает webhook в вашем Git provider
- Обнаружение событий: Когда происходят события (push, pull request, comments), Git provider отправляет webhook в PAC controller
- Сопоставление pipeline: PAC controller сопоставляет событие с аннотациями в ваших файлах PipelineRun
- Выполнение pipeline: Если совпадение найдено, PAC создает PipelineRun в вашем кластере
Подробнее о определениях pipeline и аннотациях событий см. Maintain Pipeline Code.
Содержание
Проверка триггеров pushБазовый pushPush в определенную веткуПустой commitПроверка триггеров Merge RequestСоздание Merge RequestОбновление Merge RequestForce push в Merge RequestИспользование команд в комментарияхТриггер через комментарийРаспространенные команды в комментарияхПроверка статуса pipelineПросмотр PipelineRun'овПросмотр логов PipelineRunПроверка последнего PipelineRunУстранение неполадок с операциями GitПроверка текущей веткиПроверка последнего commitПроверка удаленной веткиПросмотр Git remoteПринудительная синхронизация с remoteДальнейшие шагиПроверка триггеров push
Базовый push
Внесите изменение и выполните push, чтобы запустить pipeline:
Push в определенную ветку
Создайте feature-ветку и выполните push:
Пустой commit
Запустите pipeline без изменения кода:
Проверка триггеров Merge Request
Создание Merge Request
-
Создайте feature-ветку:
-
Создайте Pull/Merge Request с целевой веткой
mainчерез интерфейс вашего Git provider
Обновление Merge Request
Выполните push дополнительных commit'ов, чтобы снова запустить pipeline:
Force push в Merge Request
Перепишите историю и выполните force push:
Примечание: Используйте --force-with-lease вместо --force, чтобы предотвратить перезапись чужих изменений.
Использование команд в комментариях
Команды в комментариях работают только в Merge Request (Pull Request), а не в обычных commit'ах или событиях push.
Триггер через комментарий
-
Откройте ваш Pull/Merge Request в интерфейсе Git provider
-
Добавьте комментарий с командой:
или
- PAC обнаружит комментарий и запустит соответствующий pipeline
Распространенные команды в комментариях
Примечание: Точные команды зависят от конфигурации вашего pipeline. Вы определяете команды в аннотации on-comment в ваших файлах PipelineRun.
Проверка статуса pipeline
Просмотр PipelineRun'ов
Проверьте, был ли запущен pipeline:
Просмотр логов PipelineRun
Просмотрите логи конкретного PipelineRun:
Или отслеживайте логи в реальном времени:
Проверка последнего PipelineRun
Получите последний PipelineRun:
Устранение неполадок с операциями Git
Проверка текущей ветки
Убедитесь, что вы находитесь в правильной ветке:
Проверка последнего commit
Проверьте сведения о последнем commit:
Проверка удаленной ветки
Убедитесь, что ветка существует в remote:
Просмотр Git remote
Проверьте настроенный URL remote:
Принудительная синхронизация с remote
Сбросьте локальную ветку, чтобы она совпадала с remote:
Предупреждение: Это приведет к удалению локальных изменений.
Дальнейшие шаги
- Maintain Pipeline Code - Узнайте, как определять pipeline и настраивать триггеры событий
- Configure Repository - Руководство по настройке Repository
- Common Issues - Руководство по устранению неполадок