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 build plan. For each plan, different permissions can be granted to particular groups and/or users.
The following plan permissions are available:

権限の計画

説明

付与対象

'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.






The processes for granting and revoking plan permissions are described below. Note that, for ongoing ease of management, it is recommended that you grant permissions to groups rather than to individual users.


To grant plan permissions to a user,

(info) If you are creating a new plan, start at step 5.

  1. Click 'Home' to go to the Dashboard.
  2. Click the 'All Plans' tab.
  3. Locate the plan in the list and click this icon:
  4. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot 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:
    (info) Note that the assignment of permissions to LDAP users and groups in Bamboo is case sensitive. For instance, if the username of the LDAP user is 'Bob', you will need to type in 'Bob' (not 'bob' or 'BOB').
  7. 追加」ボタンをクリックします。
  8. The user will be added to the list of users on the 'Permissions' tab. Select the check-box for each permission that you wish to grant to this user.
  9. Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, click the 'Next' button and go to Completing and Enabling a New Plan (hidden).

To grant plan permissions to a group,

(info) If you are creating a new plan, start at step 5.

  1. Click 'Home' to go to the Dashboard.
  2. Click the 'All Plans' tab.
  3. Locate the plan in the list and click this icon:
  4. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
  5. In the 'Grant permission to' list at the bottom of the screen, select 'Group'.
  6. Type the group name into the box.
    (info) Note that the assignment of permissions to LDAP users and groups in Bamboo is case sensitive. For instance, if the name of the LDAP group is 'Dev', you will need to type in 'Dev' (not 'dev' or 'DEV').
  7. 追加」ボタンをクリックします。
  8. The group will be added to the list of groups on the 'Permissions' tab. Select the check-box for each permission that you wish to grant to this group.
  9. Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, click the 'Next' button and go to Completing and Enabling a New Plan (hidden).

To grant plan permissions to all Bamboo users,

(info) If you are creating a new plan, start at step 5.

  1. Click 'Home' to go to the Dashboard.
  2. Click the 'All Plans' tab.
  3. Locate the plan in the list and click this icon:
  4. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot 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. Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, click the 'Next' button and go to Completing and Enabling a New Plan (hidden).

To grant plan permissions to anonymous users,

(info) If you are creating a new plan, start at step 5.# Click 'Home' to go to the Dashboard.

  1. Click the 'All Plans' tab.
  2. Locate the plan in the list and click this icon:
  3. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
  4. Locate 'Anonymous users' (under 'Other').
  5. Select the check-box for each permission that you wish to grant to all anonymous users.
  6. Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, click the 'Next' button and go to Completing and Enabling a New Plan (hidden).

To revoke plan permissions,

(info) If you are creating a new plan, start at step 5.# Click 'Home' to go to the Dashboard.

  1. Click the 'All Plans' tab.
  2. Locate the plan in the list and click this icon:
  3. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
  4. Locate the relevant user/group/all logged-in users/anonymous users.
  5. 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 'Permissions' tab for this plan.
  6. Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, click the 'Next' button and go to Completing and Enabling a New Plan (hidden).

Screenshot: Plan Permissions