Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/philip-gai/github-ado-chatops

Integrates GitHub with Azure DevOps via ChatOps. Create a branch in an Azure Repo directly from a GitHub Issue.
https://github.com/philip-gai/github-ado-chatops

actions azure azure-devops chatbot chatops devops github github-actions slash-commands

Last synced: 3 months ago
JSON representation

Integrates GitHub with Azure DevOps via ChatOps. Create a branch in an Azure Repo directly from a GitHub Issue.

Host: GitHub
URL: https://github.com/philip-gai/github-ado-chatops
Owner: philip-gai
License: mit
Created: 2021-08-31T04:02:59.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2022-04-05T19:04:50.000Z (almost 3 years ago)
Last Synced: 2024-10-27T13:28:37.667Z (4 months ago)
Topics: actions, azure, azure-devops, chatbot, chatops, devops, github, github-actions, slash-commands
Language: TypeScript
Homepage:
Size: 10 MB
Stars: 5
Watchers: 2
Forks: 1
Open Issues: 15
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS

Awesome Lists containing this project

README

        # Azure DevOps ChatOps - GitHub Action

[![CI](https://github.com/philip-gai/github-ado-chatops/actions/workflows/ci.yml/badge.svg)](https://github.com/philip-gai/github-ado-chatops/actions/workflows/ci.yml)

![Language Count](https://img.shields.io/github/languages/count/philip-gai/github-ado-chatops?label=Languages)

![Top Language](https://img.shields.io/github/languages/top/philip-gai/github-ado-chatops)

![GitHub Repo stars](https://img.shields.io/github/stars/philip-gai/github-ado-chatops?style=social)

Integrate GitHub with Azure DevOps via ChatOps! 🚀

![Demo](docs/assets/github-ado-chatops-demo.gif)

## 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](https://azure.microsoft.com/en-us/services/devops/))

### Usage

1. Create a personal access token (PAT) for your ADO repository ([Use personal access tokens](https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?toc=%2Fazure%2Fdevops%2Forganizations%2Ftoc.json&bc=%2Fazure%2Fdevops%2Forganizations%2Fbreadcrumb%2Ftoc.json&view=azure-devops&tabs=preview-page))

    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](https://docs.github.com/en/actions/reference/encrypted-secrets#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](.github/workflows/ado-chatops.yml), 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](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](https://docs.github.com/en/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging))

## 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](https://github.com/philip-gai/github-ado-chatops/issues?q=is%3Aopen+is%3Aissue+label%3A%22feature+request%22%2Cenhancement)

2. [Create a feature request](https://github.com/philip-gai/github-ado-chatops/issues/new?assignees=&labels=feature+request&template=feature_request.md&title=)

### Bugs

1. [View known issues](https://github.com/philip-gai/github-ado-chatops/issues?q=is%3Aopen+is%3Aissue+label%3Abug)

2. [Report a bug](https://github.com/philip-gai/github-ado-chatops/issues/new?assignees=&labels=bug&template=bug_report.md&title=)

### Questions / Conversations

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

1. [View Discussions](https://github.com/philip-gai/github-ado-chatops/discussions)

2. [Start a new discussion!](https://github.com/philip-gai/github-ado-chatops/discussions/new)

### Contributing Guide

Check out the [Contributing Guide](CONTRIBUTING.md).

## License

[MIT](LICENSE) © 2021 Philip Gai