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