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

В этой статье

Вы можете использовать GitHub Actions, чтобы автоматически переместить проблемы в конкретный столбец на доске проекта при назначении проблемы.

Введение

В этом учебнике показано, как использовать действие 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 помощью область. Дополнительные сведения см. в разделе «AUTOTITLE».
      2. Сохраните эти данные personal access token в качестве секрета в репозитории. Дополнительные сведения о хранении секретов см. в разделе "Использование секретов в GitHub Actions".
      3. В файле рабочего процесса замените PERSONAL_ACCESS_TOKEN именем секрета.

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

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

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

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

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

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

Следующие шаги