Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(azure): Improve permissions text #25071

Merged
merged 9 commits into from
Oct 11, 2023
26 changes: 24 additions & 2 deletions lib/modules/platform/azure/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ steps:
TOKEN: $(System.AccessToken)
```

## Create a .npmrc file
### Create a .npmrc file

Create a `.npmrc` file in your repository:

Expand All @@ -66,7 +66,7 @@ always-auth=true

For the `registry` key, replace `YOUR-ORG` with your Azure DevOps organization and `YOUR-FEED` with your Azure Artifacts feed.

## Create a config.js file
### Create a config.js file

Create a `config.js` file in your repository:

Expand Down Expand Up @@ -138,3 +138,25 @@ Make sure that the "Project Collection Build Service (YOUR-PROJECT)" user has th
- Contribute
- Contribute to pull requests
- Create branch
- Read

Make sure that the the user has has the following permission at Project-level:
ebisso marked this conversation as resolved.
Show resolved Hide resolved

- View project-level information

### Linking a work item to the Pull Requests

If you want Renovate to automatically link an existing work item to the Pull Requests, you can set the `azureWorkItemId` configuration. Make sure the user has the following permissions on the work item's *area path*:
ebisso marked this conversation as resolved.
Show resolved Hide resolved

- Edit work items in this node
- View work items in this node

If the user do not have the permissions, pull request creation will succeed but without a link to the work item.
ebisso marked this conversation as resolved.
Show resolved Hide resolved

### Adding tags to Pull Requests

Tags can be added to Pull Requests using the `addLabels` configuration. If the tag does not exist in the DevOps project, it will be created automatically during creation of the Pull Request as long as the user has the permissions at Project-level:
ebisso marked this conversation as resolved.
Show resolved Hide resolved

- Create tag definition

Otherwise, when a tag does not exist and the user do not have permission to create it, Renovate will output an error during creation of the Pull Request.
ebisso marked this conversation as resolved.
Show resolved Hide resolved