This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.


A Plan permission is the ability to perform a particular operation in relation to a Plan and its Jobs. For each Plan, different permissions can be granted to particular groups and/or users.

次のプラン権限を利用可能です。

権限の計画

説明

付与対象

'View'

次を実行できます。

  • view this plan's build results
  • add comments or labels to this plan's build results¹

    People who don't have the 'View' permission will not know that the plan exists.

- a particular user
- a particular group
- all logged-in users
- anonymous users²

'Edit'

Permission to view and edit this plan's configuration, except for the plan's permissions.

- a particular user
- a particular group
- all logged-in users
- anonymous users²

'Build'

次を実行できます。

  • manually start/stop a build for this plan.
  • enable/disable this plan from submitting builds to the queue.

- a particular user
- a particular group
- all logged-in users
- anonymous users²

'Clone'

Permission to copy this plan when creating a new plan.
(Note: only users with the 'Create Plan' global permission can create new plans.)

- a particular user
- a particular group

'Admin'

次を実行できます。

  • edit this plan's permissions.
  • delete this plan's build results and working files.

- a particular user
- a particular group 

¹ Only logged-in users (not anonymous users) can label or comment on a build result.
² Anonymous users cannot access Bamboo at all unless they have been granted the 'Access' global permission. See Allowing Anonymous Users to access Bamboo.

Anyone with the 'Admin' global permission automatically has all plan permissions for every plan.


How plan permissions are granted:

  • People who have the 'Admin' global permission can 'bulk edit' permissions for multiple plans at the same time, as described below. Note that this will overwrite any pre-existing plan permissions.
  • People who have the 'Admin' plan permission for one or more plans, but do not have the 'Admin' global permission, can only edit one plan at a time, as described in Configuring a Plan's Permissions.

The processes for granting and revoking permissions across multiple plans are as follows. Note that, for ongoing ease of management, it is recommended that you grant permissions to groups rather than to individual users.

To grant multiple plan permissions to a user,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Bulk Edit Plan Permissions' link in the left navigation column.
  3. The first screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below). Select the plans whose permissions you wish to edit, then click the 'Next' button (at the bottom of the screen).
  4. The second screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below).
  5. In the 'Grant permission to' list at the bottom of the screen, select 'User'.
  6. Type the username into the box, or click the following icon to select from a list of users:
  7. 「追加」ボタンをクリックします。
  8. The user will be added to the list of users on the screen. Select the check-box for each permission that you wish to grant to this user.
  9. 「保存」ボタンをクリックします。

To grant multiple plan permissions to a group,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Bulk Edit Plan Permissions' link in the left navigation column.
  3. The first screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below). Select the plans whose permissions you wish to edit, then click the 'Next' button (at the bottom of the screen).
  4. The second screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below).
  5. In the 'Grant permission to' list at the bottom of the screen, select 'Group'.
  6. Type the group name into the box.
  7. 「追加」ボタンをクリックします。
  8. The group will be added to the list of groups on the screen. Select the check-box for each permission that you wish to grant to this group.
  9. 「保存」ボタンをクリックします。

To grant multiple plan permissions to all Bamboo users,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Bulk Edit Plan Permissions' link in the left navigation column.
  3. The first screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below). Select the plans whose permissions you wish to edit, then click the 'Next' button (at the bottom of the screen).
  4. The second screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below).
  5. Locate 'Logged in users' (under 'Other').
  6. Select the check-box for each permission that you wish to grant to all Bamboo users.
  7. 「保存」ボタンをクリックします。

To grant multiple plan permissions to anonymous users,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Bulk Edit Plan Permissions' link in the left navigation column.
  3. The first screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below). Select the plans whose permissions you wish to edit, then click the 'Next' button (at the bottom of the screen).
  4. The second screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below).
  5. Locate 'Anonymous users' (under 'Other').
    (info) Anonymous users are people who are not logged in to Bamboo.
  6. Select the check-box for each permission that you wish to grant to all anonymous users.
  7. 「保存」ボタンをクリックします。

To revoke multiple plan permissions,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Bulk Edit Plan Permissions' link in the left navigation column.
  3. The first screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below). Select the plans whose permissions you wish to edit, then click the 'Next' button (at the bottom of the screen).
  4. The second screen of the 'Bulk Edit Plan Permissions Wizard' will be displayed (see below).
  5. Locate the relevant user/group/all logged-in users/anonymous users.
  6. Deselect the check-box for each permission that you wish to revoke from the user/group/all users/anonymous users.
    (info) If you deselect all permissions for a user or group, that user or group will disappear from the screen.
  7. 「保存」ボタンをクリックします。

Screenshot 1: 'Bulk Edit Plan Permissions Wizard — Select Plans'  

 

Screenshot 2: 'Bulk Edit Plan Permissions Wizard — Permissions'

 



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.