管理と CI

ワークスペースとチーム

epismo workspace create --handle team
epismo workspace update <workspace-id> --handle new-name
epismo workspace checkout <workspace-id>
epismo workspace use acme
epismo -w acme workspace member list
epismo workspace member list
epismo workspace member upsert <user-id> --role admin
epismo workspace member delete <user-id>

epismo team list
epismo team create --name "Website" --description "Marketing and docs"
epismo team update <team-id> --name "Website launch"
epismo team member list --team-id <team-id>
epismo team member add <user-id> --team-id <team-id>
epismo team member delete <user-id> --team-id <team-id>

epismo workspace checkout <workspace-id> は サブスクリプションの購入画面を開きます。現在の請求期間の終了時に解約が予約されているワークスペースでは、2つ目の契約を作らず、既存のサブスクリプションを再開します。

ワークスペースの役割はオーナー、管理者、メンバーです。ワークスペース参照は正確な ID または acme のような一意なハンドル です。1 コマンドだけの指定には --workspace/-w、シェルや自動処理での指定には EPISMO_WORKSPACE、保存済みの既定値の変更には workspace use を使います。チームは、案件やプレイブックの共有先として指定できます。メンバーの操作には、一括指定に対応するものもあります。引数の形式は --help で確認してください。

クレジット

epismo credit balance
epismo credit checkout --quantity 500

残高の確認やクレジットの購入は、選択した個人スペースまたはワークスペースに対して行います。大きな自動化処理の前に whoami と現在のワークスペースを確認してください。対象の残高が不足していると、クレジットを消費する操作は 402 を返すことがあります。

CI トークン

epismo token create --workspace-id <workspace-id>
EPISMO_TOKEN=<access-token> epismo whoami

トークンはシークレット管理サービスで保管し、案件入力、プレイブックの定義、記録、リポジトリ、シェルの履歴へ入れないでください。対象ワークスペースを指定して発行した EPISMO_TOKEN はそのワークスペースへのアクセス権限を制限するため、競合する --workspace は使わないでください。個人のログイン状態に影響せず再発行できるよう、自動化環境ごとにトークンを分けます。

チームには複数のワークスペースを接続できます。チーム招待の送信・一覧表示・取り消しは、接続済みワークスペースのオーナーまたは管理者であるチーム参加者のみが行えます。受信者は招待先のメールでログインして既存のワークスペースを選ぶか新規作成します。送信者は接続先を指定しません。受け入れ時にはワークスペースを接続し受信者を参加者にしますが、所属メンバー全員を追加するわけではありません。すでにチームに接続済みのワークスペースで招待を受け入れると、招待を消費せずに HTTP 409 を返します。そのワークスペースの参加者はチームのメンバー管理から追加してください。各ワークスペースは自分の参加者を管理します。同じユーザーは複数のワークスペースから参加でき、あるワークスペースのメンバーから削除しても、ほかのワークスペースからの参加は維持されます。切断するとその接続と参加者を削除し、ほかの接続は保持します。チーム経由の権限には参加元ワークスペースとリソースの所属先の両方が接続中である必要があります。直接のユーザー共有は切断後も維持されます。招待の有効期限は14日で、再送すると前の招待を閉じます。接続してもワークスペースの購読要件は変わりません。

epismo -w <sender-workspace> team invite <team-id> --emails customer@example.com
epismo -w <sender-workspace> team invitation list <team-id>
epismo team invitation get <token>
epismo -w <recipient-workspace> team invitation accept <token>
epismo -w <workspace> team invitation revoke <team-id> <invitation-id>
epismo -w <workspace> team disconnect <team-id>
epismo workspace create --handle <handle> --team-invitation-token <token>

所有・責任・ライフサイクル

メンバー削除前に、オーナー・管理者は案件担当・プレイブックの管理者・共有権限の引き継ぎをプレビューして実行できます。未完了の承認タスクは明示指定した場合だけ引き継ぎ、完了済み承認と作成者は履歴として保持します。現在の所属メンバーから後任を選び、プレビューを確認してください。workspace member handover <workspace-id> --member-id <user-id> --successor-id <user-id> は既定でプレビューです。--preview=false で実行すると後任へ編集権限を明示的に付与します。次に workspace member delete --workspace-id <workspace-id> <user-id> で所属を削除し、--preview=false --finalize で引き継ぎを再実行して、その間の変更も整理します。引き継ぎの最終処理（finalize）は所属の削除後にだけ実行でき、メンバー削除そのものは行いません。退会により該当するチーム経由の権限とワークスペース管理権限は失われます。最初の引き継ぎでは直接共有を保持し、所属削除時にそのワークスペース所有のアイテムへの共有を解除します。最終処理でも、途中で追加された共有を整理します。個人所有や別ワークスペースへの共有は維持されます。

HTTP の引き継ぎリクエストは memberId、successorId、transferApprovals を使います。レスポンスには cases、playbooks、tasks、approvals、suggestions の件数を返します。この仕様で CLI の引き継ぎコマンドを使うには、対応する CLI リリースが必要です。