Moving assigned issues on project boards

Введение

В этом учебнике показано, как использовать действие alex-page/github-project-automation-plus для автоматического перемещения проблемы в определенный столбец на доске проекта при назначении проблемы. Например, если проблема назначена, ее можно переместить в столбец In Progress доски проекта.

В этом руководстве вы сначала создадите файл рабочего процесса, использующий действие alex-page/github-project-automation-plus. Затем вы настроите рабочий процесс в соответствии с вашими потребностями.

Создание рабочего процесса

1. Выберите репозиторий, в котором вы хотите применить этот рабочий процесс управления проектами. Вы можете использовать существующий репозиторий, к которому у вас есть доступ для записи, или создать репозиторий. Дополнительные сведения о создании репозитория см. в разделе Creating a new repository.

2. В репозитории выберите доску проекта. Вы можете использовать существующий проект или создать его. Дополнительные сведения о создании проекта см. в разделе Creating a project (classic).

3. В репозитории создайте файл с именем .github/workflows/YOUR_WORKFLOW.yml, где YOUR_WORKFLOW — это любое имя на ваш выбор. Это файл рабочего процесса. Дополнительные сведения о создании новых файлов на GitHub см. в разделе Creating new files.

4. Скопируйте следующее содержимое 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@5bcba1c1c091a222584d10913e5c060d32c44044
           with:
             project: Docs Work
             column: In Progress
             repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}

5. Настройте параметры в файле рабочего процесса.

   • Измените значение для project на имя доски проекта. При наличии нескольких досок проектов с одинаковым именем действие alex-page/github-project-automation-plus будет выполняться для всех проектов с указанным именем.
   • Измените значение для column на имя столбца, в котором необходимо переместить проблемы при их назначении.
   • Измените значение для repo-token:
     1. Создайте personal access token (classic) с областью repo действия. Дополнительные сведения см. в разделе Создание личного маркера доступа.
     2. Сохраните этот personal access token в качестве секрета в репозитории. Дополнительные сведения о хранении секретов см. в разделе Зашифрованные секреты.
     3. В файле рабочего процесса замените PERSONAL_ACCESS_TOKEN именем секрета.

6. Зафиксируйте файл рабочего процесса в ветви по умолчанию вашего репозитория. Дополнительные сведения см. в разделе Creating new files.

Тестирование рабочего процесса

При каждом назначении проблемы в репозитории она перемещается в указанный столбец доски проекта. Если проблема еще не находится на доске проекта, она туда добавится.

Если репозиторий принадлежит пользователю, действие alex-page/github-project-automation-plus будет выполняться для всех проектов в репозитории или личной учетной записи с указанным столбцом и именем проекта. Аналогичным образом, если репозиторий принадлежит организации, действие будет выполняться для всех проектов в репозитории или организации с указанным столбцом и именем проекта.

Протестируйте рабочий процесс, назначив проблему в репозитории.

1. Откройте проблему в репозитории. Дополнительные сведения см. в разделе Creating an issue.
2. Назначьте проблему. Дополнительные сведения см. в разделе Assigning issues and pull requests to other GitHub users.
3. Чтобы увидеть выполнение рабочего процесса, которое было активировано путем назначения метки для проблемы, просмотрите журнал выполнений рабочего процесса. Дополнительные сведения см. в разделе Просмотр истории выполнения рабочего процесса.
4. Когда рабочий процесс завершится, проблема, которую вы назначили, должна появиться в указанном столбце доски проекта.

Дальнейшие действия

• Дополнительные сведения о задачах, которые можно выполнить с помощью действия alex-page/github-project-automation-plus, например удаление или архивация карт проекта, см. в документации по действию alex-page/github-project-automation-plus.