マニフェストファイルをアップロードして複数のリポジトリをインポートする
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
GitLabでは、Androidリポジトリで使用されているものと同様のマニフェストファイルに基づいて、必要なすべてのGitリポジトリをインポートできます。マニフェストを使用して、Androidオープンソースプロジェクト(AOSP)のような多数のリポジトリを持つプロジェクトをインポートします。
前提要件
- マニフェストインポートソースを有効にする必要があります。有効になっていない場合は、GitLab管理者に有効にするように依頼してください。マニフェストインポートソースは、GitLab.comではデフォルトで有効になっています。
- GitLabが動作するにはマニフェストインポートにサブグループが必要なため、データベースにPostgreSQLを使用する必要があります。データベース要件の詳細をご覧ください。
- インポート先の宛先グループに対する、少なくともメンテナーロールが必要です。
マニフェストの形式
マニフェストは、最大1 MBのXMLファイルである必要があります。GitサーバーへのURLを含むreview属性を持つremoteタグが1つ必要です。また、各projectタグにはname属性とpath属性が必要です。GitLabは、remoteタグのURLとプロジェクト名を組み合わせて、リポジトリへのURLをビルドします。パス属性は、GitLabのプロジェクトパスを表すために使用されます。
以下は、有効なマニフェストファイルの例です:
<manifest>
<remote review="https://android.googlesource.com/" />
<project path="build/make" name="platform/build" />
<project path="build/blueprint" name="platform/build/blueprint" />
</manifest>その結果、次のプロジェクトが作成されます:
| GitLab | インポートURL |
|---|---|
https://gitlab.com/YOUR_GROUP/build/make | https://android.googlesource.com/platform/build |
https://gitlab.com/YOUR_GROUP/build/blueprint | https://android.googlesource.com/platform/build/blueprint |
リポジトリをインポートします
インポートを開始するには、次の手順に従います:
- GitLabのダッシュボードで、新規プロジェクトを選択します。
- プロジェクトのインポートタブに切り替えます。
- マニフェストファイルを選択します。
- マニフェストXMLファイルをGitLabに提供します。
- インポート先のグループを選択します(グループがない場合は、最初にグループを作成する必要があります)。
- 利用可能なリポジトリのリストを選択します。この時点で、マニフェストファイルに基づくプロジェクトリストを含むインポートステータスページにリダイレクトされます。
- インポートするには、次の手順に従います:
- 初めてすべてのプロジェクトをインポートする場合: Import all repositories(すべてのリポジトリをインポートする)を選択します。
- 個々のプロジェクトを再度インポートする場合: 再インポートを選択します。新しい名前を指定し、もう一度再インポートを選択します。再インポートすると、ソースプロジェクトの新しいコピーが作成されます。