estruyf / github-project-labeling

GitHub project labeling with Azure Functions

GitHub Project Labeling Webhook

Manage your issues with GitHub project labels. When you add an issue to a project, this webhook will automatically add the project's status to the issue. Same thing when you move an project card to another status, the webhook will update the issue's label.

Read more on the implementation at Using GitHub Project webhooks to manage labeling issues

Prerequisites

GitHub App

Steps to create the GitHub App:

1. Create a new GitHub App at Register new GitHub App
2. Activate the webhook
3. Set the webhook URL to the URL of your Azure Function
4. Create a webhook secret
5. Set the permissions
   • Repository permissions:
     • Issues: Read & write
     • Metadata: Read-only
   • Organization permissions:
     • Projects: Read-only
6. Subscribe to events
   • Project v2 item
7. Create a private key

Things we need for the Azure Functions:

• GitHub App ID
• GitHub App Private Key
• Webhook Secret

Install the app to the organization and personal account.

Azure Functions

On Azure, start by creating a new Azure Function (Linux) with Node.js.

Once the app is created, go to the Configuration tab and add the following environment variables:

• WEBHOOK_SECRET
• GITHUB_APP_ID
• GITHUB_APP_PRIVATE_KEY

Download the publish profile, and add it as a secret to the GitHub repository with the AZURE_FUNCTIONAPP_PUBLISH_PROFILE name.