Введение
В этом учебнике показано, как использовать действие alex-page/github-project-automation-plus
для автоматического перемещения проблемы в определенный столбец на доске проекта при назначении проблемы. Например, если проблема назначена, ее можно переместить в столбец In Progress
доски проекта.
В этом руководстве вы сначала создадите файл рабочего процесса, использующий действие alex-page/github-project-automation-plus
. Затем вы настроите рабочий процесс в соответствии с вашими потребностями.
Создание рабочего процесса
-
Выберите репозиторий, в котором вы хотите применить этот рабочий процесс управления проектами. Вы можете использовать существующий репозиторий, к которому у вас есть доступ для записи, или создать репозиторий. Дополнительные сведения о создании репозитория см. в разделе "Создание репозитория".
-
В репозитории выберите доску проекта. Вы можете использовать существующий проект или создать его. Дополнительные сведения о создании проекта см. в разделе "Создание компонента "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
на имя доски проекта. При наличии нескольких досок проектов с одинаковым именем действиеalex-page/github-project-automation-plus
будет выполняться для всех проектов с указанным именем. - Измените значение для
column
на имя столбца, в котором необходимо переместить проблемы при их назначении. - Измените значение для
repo-token
:- Создайте personal access token (classic) с
repo
помощью область. Дополнительные сведения см. в разделе «AUTOTITLE». - Сохраните эти данные personal access token в качестве секрета в репозитории. Дополнительные сведения о хранении секретов см. в разделе "Использование секретов в GitHub Actions".
- В файле рабочего процесса замените
PERSONAL_ACCESS_TOKEN
именем секрета.
- Создайте personal access token (classic) с
- Измените значение для
-
Зафиксируйте файл рабочего процесса в ветви по умолчанию вашего репозитория. Дополнительные сведения см. в разделе «AUTOTITLE».
Тестирование рабочего процесса
При каждом назначении проблемы в репозитории она перемещается в указанный столбец доски проекта. Если проблема еще не находится на доске проекта, она туда добавится.
Если репозиторий принадлежит пользователю, действие alex-page/github-project-automation-plus
будет выполняться для всех проектов в репозитории или личной учетной записи с указанным столбцом и именем проекта. Аналогичным образом, если репозиторий принадлежит организации, действие будет выполняться для всех проектов в репозитории или организации с указанным столбцом и именем проекта.
Протестируйте рабочий процесс, назначив проблему в репозитории.
- Откройте проблему в репозитории. Дополнительные сведения см. в разделе «AUTOTITLE».
- Назначьте проблему. Дополнительные сведения см. в разделе «AUTOTITLE».
- Чтобы увидеть выполнение рабочего процесса, которое было активировано путем назначения метки для проблемы, просмотрите журнал выполнений рабочего процесса. Дополнительные сведения см. в разделе «AUTOTITLE».
- Когда рабочий процесс завершится, проблема, которую вы назначили, должна появиться в указанном столбце доски проекта.
Следующие шаги
- Дополнительные сведения о задачах, которые можно выполнить с помощью действия
alex-page/github-project-automation-plus
, например удаление или архивация карт проекта, см. в документации по действиюalex-page/github-project-automation-plus
.