GitLabは「個人用アクセストークン」を使用して接続します。設定は以下の場所で行ってください:設定 → 接続 → ソースコントロール.
トークンの作成方法
GitLabでは、該当する「api」スコープを持つ個人用アクセストークンを作成します。これによりリポジトリ内容の読み取り、ブランチの作成、マージリクエストの作成が可能になります。
作成したトークンをソースコントロールの設定に貼り付けてください。Coroidはそのトークンを保存時には暗号化し、インターフェースやAPIを通じて返却することはなく、設定のエクスポートにも含めません。
トークンの所有権について
チームで共有して使用する場合は、個人のアカウントではなく自動化専用のアカウントでトークンを作成してください。そうすれば人員の異動があっても接続が維持されます。
実際に管理できる期限を設定してください。誰も気づかないうちにトークンが期限切れになると、プッシュ処理が突然失敗する現象が発生し、エラーメッセージだけでは原因を特定しにくいです。
マージリクエストについて
Coroidはマージリクエストを、GitHubでのプルリクエストと同様に扱います。つまりタスクごとにブランチを作成し、作業が完了したらベースブランチにマージする形です。
既存の承認ルールやパイプライン要件は従来通り適用されます。
GitLabレビューアプリ
GitLabレビューアプリを利用する場合、それらの環境をマージリクエストに添付してレビュー証拠として使用できます。詳細はレビュー証拠.
自己管理型のGitLab
接続には、GitLabインスタンスがCoroidからアクセス可能であることが前提となります。ネットワーク境界の背後にある自己管理型インスタンスの場合、トークンを使用する前にまずこの点を解決する必要があります。