この機能でできること
Git プロバイダを接続し、分析するリポジトリを選びます。保存だけでは初回同期は始まりません。連携カードから実行するか、定期処理が有効ならその実行を待ってください。
利用する場面
- 最初の Git データを取り込むとき。
- データ欠損を調べたりトークンを更新したりするとき。
最初の手順
- 1フォームに示す権限を使います。GitHub は repo と read:user、GitLab は read_api と read_user です。
- 2Bitbucket の API トークンでは Atlassian メールによる Basic 認証を使い、リポジトリ・PR・アカウントの読み取り権限を確認します。OAuth は別の方式です。
- 3独自インスタンスなら URL を指定し、リポジトリを選んで同期します。
- 4完了状態と日時を確認してから指標を開きます。
設定項目
| 設定項目 | 役割 | 設定のポイント | よくある間違い |
|---|---|---|---|
| トークンと権限 | プロバイダのリポジトリへのアクセスを許可します。 | 権限と有効期限を確認します。自動化で実際の変更を行う場合は書き込み権限も必要です。 | すべての機能が読み取り専用で動くと考えること。 |
| URL とリポジトリ | 接続先と同期するデータを指定します。 | 完全な URL を確認し、チームのリポジトリから始めます。 | 測定したい範囲と関係のないリポジトリを含めること。 |
利用例
状況: 最近の活動が指標に表示されません。
- 1最終同期を確認し、手動同期を実行します。
- 2失敗した場合はエラー、トークン期限、リポジトリのアクセス権を確認します。
分かること: 同期とフィルターのどちらを調べる必要があるか確認できます。
よくある質問
どのデータを読み取りますか？
コミット・PR のメタデータ、ファイルツリー、技術判定に使う一部のマニフェストと設定ファイルを読み取ります。ソース全体をクローンすることはありません。トークンは AES-256-GCM で暗号化されます。
同期の頻度は？
バックグラウンド処理はサーバー設定に依存し、有効な場合の既定間隔は約 30 分です。手動同期も使えます。
接続を削除するとどうなりますか？
その接続から同期したリポジトリと、関連するコミット・PR が Commitlane から削除されます。プロバイダ側の元データは変わりません。トークンだけを更新する場合は、データを残すため既存の接続を編集してください。
使い方のヒント
- リポジトリを増やす前に、接続状態と取り込んだデータを確認してください。