Azure DevOps Automation
Overview
This extension adds Azure DevOps Automation task to Azure DevOps pipelines that enables access control automation of projects, pipelines and repositories configuration in Azure DevOps Services.
Extension |
Package |
Build |
Code |
|
|
|
|
Features
- Create projects and update configuration
- Manage project security permissions
- Manage build pipelines permissions
- Manage release pipelines permissions
- Manage repositories permissions
- Manage work items permissions
How To Use
- Add
Azure DevOps Automation
task to your pipeline
- Select
Azure DevOps endpoint
(create if does not exist)
- Specify path to project configuration file
- Specify path to permission policies directory
- Enable or disable required feature toggles
- task: azdevautomation@1
displayName: Run Azure DevOps Automation
inputs:
endpointName: My-Endpoint # Required
configPath: path/to/projects.json # Required
policiesPath: path/to/policies # Required
projectSetup: true
accessPermissions: true
Configuration
Projects configuration contains target projects definition and policy mappings.
{
"name": "My Project",
"description": "This is My Project",
"permissions": {
"project": "My Project Policy",
"build": "My Build Policy",
"release": "My Release Policy",
"repository": "My Repository Policy",
"work": "My Work Items Policy"
}
}
Please refer to examples for reference.
Policies
Permission policies contain set of rule for different project fetures.
Project Permissions
- permissions policies defining security access to project
Build Permissions
- permissions policies defining level of access to build pipelines
Release Permissions
- permissions policies defining level of access to release pipelines
Repository Permissions
- permissions policies defining level of access to project repositories
Work Items Permissions
- permissions policies defining level of access to work items
Service Connections
- service connections definitions (to be implemented)
Please refer to examples and policy schemas for reference.
Support
For aditional information and support please refer to project repository. To enable debug mode to help troubleshooting issues, please configure DEBUG=azdev-automation:*
custom release variable.
For help with Azure DevOps please refer to official documentation.