Skip to main content
サービスアカウントは、組織に代わって作業を自動化する人以外のIDです。CI/CDパイプライン、スクリプト、Slack自動化、Droid Computersなど、特定のチームメイトではなく組織にワークロードを紐づけるべき場合に使用します。
Enterprise機能 — サービスアカウントはエンタープライズ顧客が利用できます。詳細についてはお問い合わせください。

​
まずは基本から

サービスアカウントを作成

SettingsのAPIキーセクションから安定したIDを追加します。実行内容がチームに分かるよう、明確な名前と必要に応じた説明を付けてください。サービスアカウントを作成または編集できるのは、マネージャーとオーナーのみです。

APIキーを生成

スクリプト、CIジョブ、その他の自動化ワークロード用のキーを作成します。キーの値は一度しか表示されないため、コピーして安全に保管してください。

Droid Computersを関連付ける

サービスアカウントが所有するコンピューターを作成し、長時間実行される作業を同じIDのまま継続できるようにします。

Gitアクセスを設定

GitHubには組織のGitHub Appインストールを使用します。GitLab Cloudでは、Settingsにサービスアカウント用のGitLabトークンを追加します。

​
サービスアカウントの仕組み

サービスアカウントはFactory APIキーで認証され、独立したプリンシパルとして実行されます。セッション、コンピューター、課金イベント、監査関連の情報は、人間のユーザーではなくサービスアカウントに紐づけられます。 サービスアカウントが認証に使用されるには、有効である必要があります。無効にしたり削除したりすると、そのキーを使う新しいリクエストは失敗し、そのIDに依存するワークロードは別のアカウントへ移行するか、別のアカウントで再起動する必要があります。

​
アクセスを安全に管理する

一時的な自動化で使うキーには有効期限を設定します。誤ってキーが漏えいしても、短命なキーであれば影響範囲を抑えられます。
新しいキーを作成し、ワークロードを更新してから古いキーを失効させます。定期的なローテーションにより、認証情報が侵害された場合のリスクを減らせます。
サービスアカウント名は変更できない識別子です。別の名前が必要な場合は、新しいサービスアカウントを作成してください。
サービスアカウントを削除するとアクセス権が取り消され、可能な範囲でそのアカウントが所有するFactoryリソースも整理されます。

​
一般的なユースケース

CI/CD

あるエンジニア1人のアカウントに依存せず、リリース、テスト、デプロイのワークフローを実行します。

Slack自動化

チャンネルやワークフローを設定して、Droidをチーム共有のIDとして実行します。

リポジトリ自動化

サービスアカウントで管理される認証情報を使って、リポジトリのclone、push、各種操作を行います。

永続的なコンピューター

Droid Computersを、チームメイト個人のアカウントではなく自動化用IDに紐づけたまま維持します。