Skip to content

philip-gai/github-ado-chatops

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

Azure DevOps ChatOps - GitHub Action

CI Language Count Top Language GitHub Repo stars

Integrate GitHub with Azure DevOps via ChatOps! 🚀

Demo

ChatOp Commands

Command Aliases Description Options Context
/cb-ado /create-branch-ado Creates a branch in Azure DevOps using information from the issue.
Default: feature/{issueNumber}-{issueName}-{issueTitle}.
  • -username: The username to use in your branch name.
    Default: GitHub username
  • -branch: The branch to branch from.
    Default: The default branch set in ADO
  • -type: The type of branch to make (aka the first part of the branch name path).
    Valid values are user, users, bug, bugs, feature, features, release or releases.
    Default: feature
  • -name: The branch name if you want to override any auto naming conventions.
Issues

Getting Started

Prerequisites

  1. An Azure DevOps account and repository (Start one for free)

Usage

  1. Create a personal access token (PAT) for your ADO repository (Use personal access tokens)
    1. Scopes: Custom Defined - Code (Read & Write)
  2. Create an encrypted secret named ADO_PAT in your GitHub repository with the ADO PAT token value (Creating encrypted secrets for a repository).
  3. Create a workflow file in your GitHub repo with the path .github/workflows/ado-chatops.yml by following this example, updating the input parameters with your relevant ADO repo information.
  4. You can now use ADO ChatOps in your GitHub repo! 🎉🎉🎉
  5. Test it out! On any Issue, try the /cb-ado command and enjoy 😍

Configuration

You can view the inputs defined in action.yml

Add these to your workflow file under the with section.

Debugging

  1. Set a secret in your repo named ACTIONS_STEP_DEBUG to true to get debug logging (Reference)

Contributing

I would love to hear your feedback. Let me know if you've run into any bugs, or have any feature requests.

Feature Requests

  1. View enhancements and feature requests already in the backlog
  2. Create a feature request

Bugs

  1. View known issues
  2. Report a bug

Questions / Conversations

Do you have any questions? Want to just talk and ask me stuff?

  1. View Discussions
  2. Start a new discussion!

Contributing Guide

Check out the Contributing Guide.

License

MIT © 2021 Philip Gai philipmgai@gmail.com