Azure DevOps Automation

• Overview
• Features
• How To Use
• Configuration
• Console Guide
• Support

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

1. Add Azure DevOps Automation task to your pipeline
2. Select Azure DevOps endpoint (create if does not exist)
3. Specify path to project configuration file
4. Specify path to permission policies directory
5. 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.