Actions - GitHub Actions for Azure

This repository provides a framework, guidelines and processes to author new and contribute to existing GitHub Actions deploying to Azure.

Table of contents

• Introduction to GitHub Actions for Azure and Starter Action Workflows
• Contributing to Azure Actions
  • Health Dashboard for Azure Action repos

Introduction to GitHub Actions for Azure and Starter Action Workflows

GitHub Actions gives you the flexibility to build an automated software development lifecycle workflow.

With GitHub Actions for Azure you can create workflows that you can set up in your repository to build, test, package, release and deploy to Azure. Learn more about all other integrations with Azure.

Get started today with a free Azure account!

To easily create GitHub CI/CD workflows targeting Azure, use our Azure starter templates to deploy your apps created with popular languages and frameworks such as .NET, Node.js, Java, PHP, Ruby or Python, in containers or running on any operating system. Also the individual Action repos have a sample workflow included in their Readme file to help you quickly get started.

Please try out the GitHub Actions for Azure and share your feedback via Twitter on @Azure. If you encounter a problem, please open an issue on the GitHub repository for the specific action.

Contributing to Azure Actions

Following are the guideliens to author new Azure Actions and also to contribute to the existing ones.

Authoring and making changes

• Create a new GitHub Action for Azure or Microsoft
• Contributing to the existing actions
• Building GitHub Actions from Azure Pipeline Tasks

Actions Repository Permissions

• Guidelines for repository permissions

Testing

• Testing GitHub Actions
• Automated test workflows
• Automates tests for updated runner images
• Automatic Validation of recommended practices for an Actions repository

Release

• Action Versioning
• Releasing a new version
• Publish to Marketplace
• Communication guidelines

Monitoring

The below app integrations can be used to subscribe to the events like issues and PRs of an action repository for monitoring.

• Slack integration
• MS-Teams integration

Azure Actions toolkit

Azure Actions toolkit hosting node modules to help write your azure actions

Health Dashboard for Azure Action repos

This health dashboard provides information on open issues and PRs for all the Azure Action repos. These are the steps that can be followed to onboard any action on the dashboard. We are also planning add a feature to highlight any dip in the action specific usage telemetry in the dashboard.

Contributing License Agreement

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.