CosmicAC Logo

Manage teams

Create, edit, archive, restore, and switch between teams in CosmicAC, and change a team's storage quota.

Create teams to organize people and their jobs, update team details, and archive teams that you no longer use. Manage teams in Settings > Teams. To restore an archived team, use the CosmicAC CLI.

Prerequisites

Before you start, make sure that you have what the task requires.

  • Create a team: the platform administrator role.
  • Edit or archive a team: the team lead role or the platform administrator role.
  • Change a team's storage quota: the platform administrator role.
  • Restore a team: the platform administrator role and CosmicAC CLI version 1.3.2 or later, signed in to your deployment. For more information, see Install the CLI.

For details about roles and permissions, see Teams and roles.

Open the team list

  1. In the sidebar, click Settings.
  2. Click Teams.

The Teams page lists your teams. If you're a platform administrator, the page lists every team in the deployment.

Create a team

  1. On the Teams page, click Create team.
  2. In the Name field, enter a name that no other active team uses.
  3. Optional: in the Description field, enter a description of up to 160 characters.
  4. Click Create team.

The new team has no members. To add its first team lead, switch to the new team, and then invite that person. See Manage team members.

Switch your active team

Your active team owns the jobs and API keys that you create.

  1. At the top of the sidebar, click the team switcher.
  2. Click the team that you want to work in.

The page reloads with that team active.

Edit a team

You can update a team's name and description. A team lead can edit only their active team. A platform administrator can edit any team.

  1. If you're a team lead, switch to the team that you want to edit.
  2. On the Teams page, in the team's row, click Edit team.
  3. Update the Name or Description field.
  4. Click Save changes.

Change a team's storage quota

A storage quota limits the total size, in GiB, of a team's storage volumes. A team follows the deployment's default quota until you set a quota for it. As a platform administrator, you can change the quota of any team.

On the Teams page, the Storage quota column shows each team's quota. Default appears next to a quota that follows the default.

  1. On the Teams page, in the team's row, click Edit storage quota. The Edit storage quota dialog opens and shows the default quota.
  2. In the Quota field, enter a whole number of GiB that's at least 1.
  3. Click Save quota.

The Storage quota column shows the new quota. The new quota takes effect immediately. CosmicAC checks the quota each time someone in the team creates or resizes a volume. Changing the quota doesn't change the size of existing volumes.

If the team already holds more than the new quota, its volumes and jobs keep working. Nobody in the team can create or resize a volume until the team frees space.

To make the team follow the default quota again, open the Edit storage quota dialog for the team, and then click Reset to default. The Storage quota column shows Default next to the team's quota.

Archive a team

Archive a team when you no longer need it.

Archiving a team deletes its pending invitations, and the team's API keys stop working. Nobody can select an archived team. Only a platform administrator can restore an archived team, and only with the CLI. For more information, see Restore an archived team.

You can't archive a team that still has jobs, reserved nodes, or members other than you. Suspended members count as members, but you don't need to remove yourself.

Nobody can remove a team's last active team lead. If you're a platform administrator who isn't a member of the team, ask the team lead to archive the team instead.

  1. Remove every other member from the team. See Manage team members.
  2. Delete the team's jobs.
  3. If the team has reserved nodes, ask a platform administrator to clear the reservation. See Clear a team's reservation.
  4. On the Teams page, in the team's row, click Archive team.
  5. In the Archive team dialog, click Archive team.

If you archive your active team, the web interface reloads and opens your next available team.

Restore an archived team

To make an archived team active again, restore it with the CLI. The web interface doesn't have a restore action.

  1. To find the team's ID, list the teams.

    cosmicac teams list

    An archived team has the status team archived.

  2. Restore the team. Replace <team> with the team's ID or name.

    cosmicac teams unarchive --team <team>
  3. When the CLI asks you to confirm, enter y.

The CLI prints a message with the restored team's name and ID. The team keeps its members and its storage volumes. The team's API keys work again, but revoked and expired keys still don't work. CosmicAC doesn't recreate the pending invitations that it deleted when it archived the team. To invite those people again, see Invite a member.

Restoring a team doesn't change your active team. To work in the restored team, run cosmicac teams use <team> or select the team in the team switcher. For more information, see Switch your active team.

If another active team uses the same name, the CLI returns the error Team name already in use. To fix the error, rename the other team, and then restore the archived team again. For more information, see Edit a team.

Next steps

On this page