Введение
В этом руководстве показано, как использовать alex-page/github-project-automation-plus
действие для автоматического перемещения проблемы в определенный столбец на project (классическая модель) при назначении проблемы. Например, при назначении проблемы его можно переместить в In Progress
столбец project (классическая модель).
В этом руководстве вы сначала создадите файл рабочего процесса, использующий действие alex-page/github-project-automation-plus
. Затем вы настроите рабочий процесс в соответствии с вашими потребностями.
Создание рабочего процесса
-
Выберите репозиторий, в котором вы хотите применить этот рабочий процесс управления проектами. Вы можете использовать существующий репозиторий, к которому у вас есть доступ для записи, или создать репозиторий. Дополнительные сведения о создании репозитория см. в разделе "Создание репозитория".
-
В репозитории выберите project (классическая модель). Вы можете использовать существующий проект или создать его. Дополнительные сведения о создании проекта см. в разделе "Создание компонента "project (classic)"".
-
В репозитории создайте файл с именем
.github/workflows/YOUR_WORKFLOW.yml
, гдеYOUR_WORKFLOW
— это любое имя на ваш выбор. Это файл рабочего процесса. Дополнительные сведения о создании новых файлов на сайте GitHub см. в разделе "Создание новых файлов". -
Скопируйте следующее содержимое YAML в файл рабочего процесса.
YAML # Этот рабочий процесс использует действия, которые не сертифицированы GitHub. # Они предоставляются сторонним поставщиком, и на них распространяются # отдельные условия обслуживания, политика конфиденциальности и поддержка # документации. # GitHub рекомендует закрепить действия в фиксации SHA. # Чтобы получить более новую версию, потребуется обновить SHA. # Вы также можете ссылаться на тег или ветвь, однако действие может измениться без предупреждения. name: Move assigned card on: issues: types: - assigned jobs: move-assigned-card: runs-on: ubuntu-latest steps: - uses: alex-page/github-project-automation-plus@7ffb872c64bd809d23563a130a0a97d01dfa8f43 with: project: Docs Work column: In Progress repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
# Этот рабочий процесс использует действия, которые не сертифицированы GitHub. # Они предоставляются сторонним поставщиком, и на них распространяются # отдельные условия обслуживания, политика конфиденциальности и поддержка # документации. # GitHub рекомендует закрепить действия в фиксации SHA. # Чтобы получить более новую версию, потребуется обновить SHA. # Вы также можете ссылаться на тег или ветвь, однако действие может измениться без предупреждения. name: Move assigned card on: issues: types: - assigned jobs: move-assigned-card: runs-on: ubuntu-latest steps: - uses: alex-page/github-project-automation-plus@7ffb872c64bd809d23563a130a0a97d01dfa8f43 with: project: Docs Work column: In Progress repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
-
Настройте параметры в файле рабочего процесса.
- Измените значение
project
на имя данных project (классическая модель). Если у вас несколько данных проекты (классическая модель) с одинаковым именем,alex-page/github-project-automation-plus
действие будет выполняться для всех проектов с указанным именем. - Измените значение для
column
на имя столбца, в котором необходимо переместить проблемы при их назначении. - Измените значение для
repo-token
:- Создайте personal access token (classic) с
repo
помощью область. Дополнительные сведения см. в разделе Управление личными маркерами доступа. - Сохраните эти данные personal access token в качестве секрета в репозитории. Дополнительные сведения о хранении секретов см. в разделе "Использование секретов в GitHub Actions".
- В файле рабочего процесса замените
PERSONAL_ACCESS_TOKEN
именем секрета.
- Создайте personal access token (classic) с
- Измените значение
-
Зафиксируйте файл рабочего процесса в ветви по умолчанию вашего репозитория. Дополнительные сведения см. в разделе Создание новых файлов.
Тестирование рабочего процесса
При назначении проблемы в репозитории проблема будет перемещена в указанный столбец project (классическая модель) . Если проблема еще не включена в project (классическая модель), она будет добавлена в project (классическая модель).
Если репозиторий принадлежит пользователю, действие alex-page/github-project-automation-plus
будет выполняться для всех проектов в репозитории или личной учетной записи с указанным столбцом и именем проекта. Аналогичным образом, если репозиторий принадлежит организации, действие будет выполняться для всех проектов в репозитории или организации с указанным столбцом и именем проекта.
Протестируйте рабочий процесс, назначив проблему в репозитории.
- Откройте проблему в репозитории. Дополнительные сведения см. в разделе Создание проблемы.
- Назначьте проблему. Дополнительные сведения см. в разделе Назначение проблем и запросов на вытягивание другим пользователям GitHub.
- Чтобы увидеть выполнение рабочего процесса, которое было активировано путем назначения метки для проблемы, просмотрите журнал выполнений рабочего процесса. Дополнительные сведения см. в разделе Просмотр журнала выполнения рабочего процесса.
- По завершении рабочего процесса необходимо добавить проблему в указанный столбец project (классическая модель).
Следующие шаги
- Дополнительные сведения о задачах, которые можно выполнить с помощью действия
alex-page/github-project-automation-plus
, например удаление или архивация карт проекта, см. в документации по действиюalex-page/github-project-automation-plus
.