Noteworthy Puppy Movies

    probot-azure-pipelines
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.1 • Public • Published

    Probot for Azure Pipelines (probot-azure-pipelines)

    Build Status

    A GitHub App for Azure Pipelines built with Probot.

    If you have GitHub repositories that store your code, and Azure Pipelines build that perform continuous integration (CI) builds for validating pull requests, then this app enables project contributors to requeue pull requests builds just by typing /rebuild as a pull request comment.

    Example of GitHub pull request discussion

    This is useful if you have occasionally flaky tests or infrastructure, and it allows project contributors to requeue a build right from GitHub. This lets you provide access to requeue a build without necessarily providing people broader access to the build definition in Azure Pipelines.

    Note that /rebuild is limited to project contributors on GitHub (people listed in the contributors group, or who are part of a team for this repository).

    Installation

    Since this application will need access to queue builds on your behalf in Azure Pipelines, you will need to set up your own instance of this application. There's no publicly available GitHub App instance that you can just install.

    Create a GitHub App

    You'll need to Create a new GitHub App for your installation. Most of the settings are straightforward, but there are three important considerations:

    • Webhook URL: This is the URL of your deployed application. If you're deploying to Azure, for example, this will be my-azure-pipelines-build-app.azurewebsites.net.
    • Webhook secret: Create a secret key of random data that will be used to authenticate to your application.
    • Private key: Generate a new private key and save it to disk.

    Make sure that this application is private since it will have access to your Azure Pipelines account, and the ability to queue builds on your behalf.

    Create an Azure DevOps Personal Access Token

    A Personal Access Token (PAT) allows you to provide this app the ability to queue builds on your behalf. In the Azure DevOps portal, select your settings in the upper right and select Security.

    In the Personal Access Token section, click "Add" to create a new PAT. Give it a description that is memorable, like "probot-azure-pipelines".

    In "Authorized Scopes", change the option to selected scopes, then select "Build (read and execute)". Limiting the scope of an access token is always good security posture.

    Finally, save your new PAT in your password manager of choice. You'll need it again for deployment.

    Deploying to Azure using Azure Pipelines

    It's easy to deploy this to an Azure app service running node.js on Linux. (Make sure you're using node.js 8.9 or newer.)

    1. Fork this repository on GitHub.

    2. Set up a new Azure Pipelines build definition:

      1. Location: GitHub
      2. Repository: Select your fork of probot-azure-pipelines
      3. Template: Use the suggested Node.js-based build
      4. Run: Queue a build
    3. Set up a new Azure Pipelines release definition:

      1. Create an Azure App Service Deployment
      2. Add an artifact: select the build artifact produced by your build pipeline
      3. Select your stage, and select the stage tasks. You'll be prompted to enter your Azure subscription and app service name. Change the App type to "Linux App" and select your app service name.
    4. In the Azure portal, set up the configuration for your application. In application settings, set:

      • APP_ID: the ID of your GitHub App

      • WEBHOOK_SECRET: the secret key for your GitHub App

      • PRIVATE_KEY: the private key file you downloaded when creating your GitHub App.

        Note that the private key is in PEM format, so it spans multiple lines. This environment variable needs to be on a single line. Remove the line breaks and replace them with a backslash (\) followed by an n. Probot will find a literal \n and replace it with newlines. You can achieve this with Perl:

        perl -pe 's/\n/\\n/' < pemfile

      • AZURE_DEVOPS_URL: the URL of the Azure DevOps account that contains the builds that are queued for your GitHub repository.

      • AZURE_DEVOPS_PAT: your Personal Access Token

    Deploy Manually

    If you don't want to set up a Azure Pipelines build and release definition into Azure, you can also build and run this application manually.

    To download and build the latest release of this application:

    git clone --branch latest https://github.com/ethomson/probot-azure-pipelines
    cd probot-azure-pipelines
    npm build
    

    Refer to the Probot Deployment Guide for setting up your deployment. This is a standard Probot app, but does require two custom environment variables:

    • AZURE_DEVOPS_URL: the URL of the Azure DevOps account that contains the builds that are queued for your GitHub repository.
    • AZURE_DEVOPS_PAT: your Personal Access Token

    Install for Your Repositories

    In the GitHub settings page for your account (or the organization that you created the GitHub App in), navigate to the GitHub App settings. Then just click install on the app. Authorize it for all your repositories, or each repository individually.

    Now when you type /rebuild on a pull request, it should queue a rebuild.

    License

    Copyright (c) Edward Thomson. All rights reserved. Available under the MIT license.

    Install

    npm i probot-azure-pipelines

    DownloadsWeekly Downloads

    3

    Version

    1.0.1

    License

    MIT

    Unpacked Size

    61.6 kB

    Total Files

    19

    Last publish

    Collaborators

    • ethomson