Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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
[](https://github.com/philip-gai/github-ado-chatops/actions/workflows/ci.yml)


Integrate GitHub with Azure DevOps via ChatOps! 🚀

## 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.
## 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