Skip to content

Commit

Permalink
fix: migrate teams instructions (#56)
Browse files Browse the repository at this point in the history
  • Loading branch information
staceysalamon-aiven authored Feb 19, 2024
1 parent c06db44 commit 468126d
Showing 1 changed file with 33 additions and 32 deletions.
65 changes: 33 additions & 32 deletions docs/tools/aiven-console/howto/create-manage-teams.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,30 +2,30 @@
title: Create and manage teams
---

**Teams** let you create user groups and assign different access levels
to specific projects. Users must be part of an organization before being
added to a team. To create and manage teams, click **Admin** and then
select **Teams**.
**Teams** let you create user groups and assign different access levels to specific projects.

Users must be part of an organization before being added to a team. To create and manage
teams, click **Admin** and then select **Teams**.

:::important
**Teams are becoming groups**

Groups are an easier way to control access to your organization's
projects and services for a group of users. See
[Migrate teams to groups](#migrate_teams_to_groups).
projects and services for a group of users.
[Migrate your teams to groups](#migrate_teams_to_groups).
:::

## Create a new team

1. Click **Create new team**.
2. Enter a **Team Name**.
3. Click **Create team**.
1. Enter a **Team Name**.
1. Click **Create team**.

## Add users to a team

1. Click the name of the team that you want to add users to.
2. On the **Team Members** tab, click **Invite users**.
3. Enter the email address of the user and click **Invite users**.
1. On the **Team Members** tab, click **Invite users**.
1. Enter the email address of the user and click **Invite users**.

The user will get an email with an invitation link.

Expand All @@ -49,41 +49,42 @@ To add projects and roles to a team:

1. Click the name of the team and select the **Projects and Roles**
tab.
2. Click **Add projects**.
3. Select a **Project Name** and **Permission Level**.
4. Click **Add project to team**.
1. Click **Add projects**.
1. Select a **Project Name** and **Permission Level**.
1. Click **Add project to team**.

You can edit the permissions or delete the project from this team by
clicking the more options menu for the project.

## Migrate teams to groups {#migrate_teams_to_groups}

To get started using organization groups, replace your existing teams
with groups:

1. In the organization, click **Admin**
1. In the organization, click **Admin**.

2. Click **Organization** and on the **Teams** tab view each team to
make a note of:
1. On the **Teams** tab, click each team name to view it and make a note of:

- which users are members of the team
- which projects the team is assigned to
- the permission level that is assigned for each project

3. Click **Groups** and then **Create group**.
:::note
Users on the Account Owners team automatically become super admin with full access to
manage the organization. You don't need to create a group for these users or manage
this team after the migration. Instead, you can
[make users super admin](/docs/platform/howto/make-super-admin).
:::

1. Click **Groups**.

4. Enter the name of one of the teams and assign the same users to this
group. Do this for each of your organization's teams.
1. Click **Create group**.

5. [Add each new group to the same projects](/docs/platform/howto/add-groups-projects) that the teams are assigned to. Set the role to the same
permission level that is used for the team.
1. Enter the name of one of the teams and assign the same users to this group. Do this
for each team.

:::important
Users on the account owners team automatically become super admin.
To give them the same permission level, after deleting the account
owners team
[make them super admin](/docs/platform/howto/make-super-admin).
:::
1. [Add each new group to the projects](/docs/platform/howto/add-groups-projects)
that the teams are assigned to with the same role.

6. After confirming all users have the correct access, delete the
teams.
1. After confirming all users have the correct level of access to the projects,
delete the teams.
:::note
You cannot delete the Account Owners team.
:::

0 comments on commit 468126d

Please sign in to comment.