アカウントとプロジェクト
Tuist の一部の機能では、データの永続化を提供し他のサービスと連携できるサーバーが必要です。サーバーと連携するには、アカウントと、ローカルプロジェクトに接続するプロジェクトが必要です。
アカウント#
サーバーを利用するにはアカウントが必要です。アカウントには次の 2 種類があります。
- 個人アカウント: サインアップ時に自動的に作成され、ID プロバイダー(GitHub など)から取得したハンドルまたはメールアドレスの前半部分で識別されます。
- 組織アカウント: 手動で作成され、開発者が定義したハンドルで識別されます。組織では、他のメンバーを招待してプロジェクトで共同作業できます。
GitHub に慣れている場合、その概念は似ています。個人アカウントと組織アカウントを持ち、URL を構築する際に使用されるハンドルで識別されます。
組織は tuist organization のサブコマンドで管理できます。新しい組織アカウントを作成するには、次を実行してください。
tuist organization create {account-handle}
組織への参加#
ユーザーは、招待、自動的なシングルサインオン登録、またはSystem for Cross-domain Identity Management provisioningを通じて組織のメンバーになれます。
組織の ID プロバイダーで認証しても、それだけではメンバーシップは付与されません。組織のシングルサインオン登録ポリシーにより、信頼済みドメインのユーザーが招待を必要とするか、自動的に参加できるかが決まります。
管理者はダッシュボードから、または tuist organization invite でメンバーを招待できます。招待を受けた人が承認した際に user 以外のロールを付与するには、--role admin または --role viewer を指定してください。
ロール#
組織のメンバーは次の 3 つのロールのいずれかを保持します。
| ロール | 付与される権限 |
|---|---|
| Admin | ユーザーが行えるすべての操作に加え、組織の管理(メンバーと招待、プロジェクト、請求、トークン、Webhook、設定)が可能です。 |
| User | 組織の作業を読み取り、操作できます。ビルドとテストの実行、キャッシュへの書き込み、プレビューの作成と削除、テストケースの状態の変更などです。 |
| Viewer | 組織の作業を読み取れますが、変更はできません。ダッシュボード、ビルド、テスト実行、flaky テストと隔離されたテスト、プレビュー、バンドル、ランナーのアクティビティはすべて読み取り可能です。マシン上でコマンドを実行するため、ランナーへのインタラクティブシェルや VNC セッションの接続は許可されません。 |
誰かを招待する際にロールを選択し、後でダッシュボードのMembersから変更できます。この方法で設定されたロールは、後のサインインで上書きされることはありません。
プロジェクト#
プロジェクトはリモートプロジェクトを通じてアカウントと統合する必要があります。GitHub との比較を続けると、ローカルリポジトリとリモートリポジトリを持ち、変更をプッシュするようなものです。tuist project を使ってプロジェクトを作成・管理できます。
プロジェクトはフルハンドルで識別され、これは組織ハンドルとプロジェクトハンドルを連結した結果です。たとえば、ハンドルが tuist の組織と、ハンドルが tuist のプロジェクトがある場合、フルハンドルは tuist/tuist になります。
ローカルプロジェクトとリモートプロジェクトの紐付けは構成ファイルで行います。存在しない場合は Tuist.swift に作成し、次の内容を追加してください。
let tuist = Tuist(fullHandle: "{account-handle}/{project-handle}") // e.g. tuist/tuist
モジュールキャッシュなどの一部の機能では、Tuist で管理されたプロジェクトが必要です。Tuist でプロジェクトを管理していない場合、これらの機能は利用できません。
プロジェクトの URL はフルハンドルを使用して構築されます。たとえば、公開されている Tuist のダッシュボードは tuist.dev/tuist/tuist でアクセスでき、ここで tuist/tuist がプロジェクトのフルハンドルです。