Skip to main content

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

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

Введение

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

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

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

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

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

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

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

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

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

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

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

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