Перемещение назначенных проблем на досках проектов

Введение

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

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

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

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

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

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

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@7ffb872c64bd809d23563a130a0a97d01dfa8f43
           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. Зафиксируйте файл рабочего процесса в ветви по умолчанию вашего репозитория. Дополнительные сведения см. в разделе Создание новых файлов.

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

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

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

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

1. Откройте проблему в репозитории. Дополнительные сведения см. в разделе Создание проблемы.
2. Назначьте проблему. Дополнительные сведения см. в разделе Назначение проблем и запросов на вытягивание другим пользователям GitHub.
3. Чтобы увидеть выполнение рабочего процесса, которое было активировано путем назначения метки для проблемы, просмотрите журнал выполнений рабочего процесса. Дополнительные сведения см. в разделе Просмотр истории выполнения рабочего процесса.
4. Когда рабочий процесс завершится, проблема, которую вы назначили, должна появиться в указанном столбце доски проекта.

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

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