runr_group (Resource)

A group (team) of members. Members get the group's organization-wide role and the project access granted to the group (runr_project_access with group_id). Needs groups.manage (and roles.manage to set the role). Members synced from single sign-on (source sso) are kept by the SSO group mapping and are not part of members.

Example Usage#

# Members get the group's organization-wide role and the project access granted to the group.
resource "runr_group" "platform" {
  name        = "platform"
  description = "Platform team"
  role        = "viewer"
  members     = ["grace@example.com", "alan"] # user ids, e-mail addresses or usernames
}

# Deploy rights on one project for the whole group.
resource "runr_project_access" "platform_orders" {
  project_id = runr_project.orders.id
  group_id   = runr_group.platform.id
  role       = runr_role.release_manager.key
}

Schema#

Required#

name (String) Group name (unique).

Optional#

description (String) Description.
members (Set of String) Members, each given by user id, e-mail address or username. Unset: Terraform leaves the membership alone; an empty set removes every manually added member.
role (String) Organization-wide role of the members (a built-in role key or runr_role.<name>.key). Unset: the group grants project access only.

Read-Only#

id (String) Group id.

Import#

Import is supported using the following syntax:

The terraform import command can be used, for example:

# <group id or name>; members stay unmanaged until the configuration sets them
terraform import runr_group.platform platform