Skip to main content

How do I assign permissions for a team-shared CI job?

Control who can do what with team-shared continuous integration jobs

Jacob Joshua avatar
Written by Jacob Joshua
Updated yesterday

Note: Team owners will always have "Admin" permission on all team-shared resources (e.g. org connections, CI jobs and Pipelines), which bestows the same level of access as the "Edit" permission, with the addition of being able to delete team-owned resources and update their permissions.

List of available CI job permissions

The below definitions of each of the available permissions for team-shared CI jobs will help you understand which permission to assign to which users on your Gearset team.

  • None - This setting means that users cannot run the CI job or edit the job settings.

  • Validate - This allows users to run PR validations against the pipeline environment (CI jobs) they have Validate access for.

    • Note: Users cannot merge validated PRs with this permission.

  • Run - This allows users to run the CI job. If the CI job is in a pipeline, this setting will allow users to promote the PR within the pipeline.

  • Edit - This allows users to edit the CI job settings, including amending metadata filter, as well as to run the job.

  • Admin - a team member becomes an owner of the CI job, effectively gaining "Edit" access rights for the job, and the ability to assign permissions for the job to other Gearset team members.

    • Note: Team members with an Admin permission cannot delete a team-shared CI job. Deletion can only be done by Team Owners.

Assigning permissions for team-shared CI jobs

This step by step guide will help you manage permissions assigned to users for your team-shared CI jobs.

Navigate to Pipelines & CI jobs page, and follow these steps:

  • Is the CI job part of the Pipeline or a standalone CI job?

  • Go to the respective option to assign the permissions.

  • For example - If it's under Team-shared Pipelines select the Pipeline that contains the CI job you want to assign permissions for.

  • Then scroll down to CI jobs section and select the down arrow next to the CI job you want to assign permission for.

  • Select Edit CI job users... button

  • Next, select the type of permission (e.g. None, Validate, Run, Edit or Admin) for the user(s) that you're looking to amend the permission for (see below screenshot).

  • And lastly, click on the blue button Save to make sure changes are applied.

Check out the below sample video for navigating to the Team shared CI job in a pipeline.

Did this answer your question?