チーム

チームは、チームメンバーと、組織、チームおよびプロジェクトの操作権限を管理するための仕組みです。

操作権限は、ロールで決まります。ロールには、reader / admin / owner の 3 種類があり、チーム単位に設定します。

リソースに対する操作 reader admin owner 備考
組織の読み込み
組織の登録
組織の更新
組織の削除
チームの読み込み
チームの登録
チームの更新 owner ロールのチームは、owner ロールのチームメンバーのみが操作可能です。
チームの削除 owner ロールのチームは削除できません。
チームへの招待
チームへの招待キャンセル チームに招待されたメンバーも操作可能です。
チームメンバーの削除
チームへのプロジェクト権限の読み込み
チームへのプロジェクト権限操作
プロジェクトの読み込み
プロジェクトの登録
プロジェクトの削除

チーム規則

  • チームは、複数登録できます。
  • チームは、ロールを持ちます。
    • ロールには、reader / admin / owner の 3 種類があります。
  • チームは、複数のチームメンバーを持てます。
    • チーム編成は、チームへの招待機能を使います。
  • ユーザーは、複数のチームに所属することができます。
  • 組織を登録すると自動的に、Owners というチームが登録されます。
    • Owners チームのロールは、owner です。
  • 組織を登録したユーザーは、自動的に Owners チームに属します。

チーム名規則

チームを登録するときに命名するチーム名は、以下の点に気をつけてください。

  • 組織内でユニークでなければなりません。
  • 大文字小文字の区別はありません。
  • 使用可能な文字は、英数字(a-z, A-Z, 0-9)です。
    • ただし、先頭に使用できる文字は、英字(a-z, A-Z)のみです。
  • 文字数は、63 文字以内です。

magellan-cli を使ったチームの操作

magellan-cli コマンドラインツールを使ってできるチームの操作は、magellan-cli team に集約されています。

どのような操作ができるかは、magellan-cli team help とすることで確認することができます。

$ magellan-cli team help
Commands:
  magellan-cli team list              # teams の一覧を表示します
  magellan-cli team show [ID]         # IDで指定されたteamの詳細を表示します
  magellan-cli team select NAME       # NAMEを指定してteamを選択します
  magellan-cli team deselect          # teamの選択を解除します
  magellan-cli team delete NAME       # NAMEを指定してteamを削除します
  magellan-cli team create NAME ROLE  # NAMEとROLEを指定してteamを登録します
  magellan-cli team help [COMMAND]    # 利用可能なコマンドの一覧か特定のコマンドの説明を表示します

Options:
  -v, [--version], [--no-version]  # バージョンを表示します
  -V, [--verbose], [--no-verbose]  # 追加のログ情報を表示します
  -D, [--dryrun], [--no-dryrun]    # 登録や削除などのシステムには反映させずにアクションを実行します

以下では、チームの登録チームの一覧チームの選択およびチームの削除について、使い方を簡単に紹介します。詳しくは、Reference を参照してください。

チームの登録

チームを登録したいときは、magellan-cli team create コマンドを使います。コマンドの引数に、チーム名とロールを指定します。ロールには、reader、admin、owner のいずれかが指定できます。例えば、チーム名 TeamA、ロール reader でチームを登録したいときは、次のように使います。

$ magellan-cli team create TeamA reader
$

実行後、何もメッセージが表示されなければ、チームの登録に成功しています。

既に、指定した名称が使われていた場合は、Name has already been taken というメッセージが表示されます。この場合は、名称を変えて再度試してください。

$ magellan-cli team create TeamA admin
Name has already been taken

チームの一覧

チームの一覧を確認したいときは、magellan-cli team list コマンドを使います。

$ magellan-cli team list
+---+-------+--------------+--------+--------+----------------+
|   |  id   | organization |  name  |  role  |   team_code    |
+---+-------+--------------+--------+--------+----------------+
| * | 35565 | MyCompany    | TeamA  | reader | ixJcYZ4p8JC5pg |
|   | 30050 | MyCompany    | Owners | owner  | GCc4RYN40cwTOQ |
+---+-------+--------------+--------+--------+----------------+

Total: 2

行頭についている * は、その行が示すチームが選択状態であることを表します。この例では、TeamA が選択されていることを表します。

チームの選択

チームを選択したいときは、magellan-cli team select コマンドを使います。チーム TeamA を選択したいときは、次のように使います。

$ magellan-cli team select TeamA

チームの削除

チームを削除したいときは、magellan-cli team delete コマンドを使います。例えば、チーム TeamA を削除したいときは、次のように使います。

$ magellan-cli team delete TeamA
OK

チームの削除に成功した場合は、OK のメッセージが表示されます。

tips用アイコン

owner ロールのチームは、削除できません。