グループのインポート/エクスポート

  • GitLab 13.0で実験的な機能として導入されました。 今後のリリースで変更される可能性があります。

GitLabインスタンスまたはGitLab.comで稼働している既存のグループは、関連するすべてのデータとともにエクスポートし、新しいGitLabインスタンスに移動することができます。

グループのインポートオプションが有効な場合、GitLabインポート/エクスポートボタンが表示されます。

こちらも参照してください。

GitLab インポート/エクスポートを有効にするには:

  1. admin} 管理エリア > 設定 > 可視性とアクセス制御に移動します。
  2. ソースのインポートにスクロールします。
  3. 必要なインポートソースを有効にします。

インポート

以下に注意してください。

  • エクスポートは一時的な共有ディレクトリに保存され、特定のワーカーによって24時間ごとに削除されます。
  • インポートしたプロジェクトからグループレベルの関係を維持するには、まず Group Import/Export を実行して、プロジェクトを目的のグループ構造にインポートできるようにします。
  • インポートされたグループは、親グループにインポートされない限り、private の可視レベルが与えられます。
  • 親グループにインポートされた場合、特別な制限がない限り、サブグループも同じレベルの可視性を継承します。
  • インポートしたグループのメンバーリストとそれぞれの権限を保持するには、これらのグループのユーザーをレビューします。 必要なグループをインポートする前に、これらのユーザーが存在することを確認してください。

エクスポート内容

以下の項目がエクスポートされます:

  • マイルストーン
  • ラベル
  • ボードとボードリスト
  • バッジ
  • サブグループ(前述の全データを含む)
  • エピック
  • イベント

以下の項目はエクスポートされません:

  • プロジェクト
  • ランナートークン
  • SAML ディスカバリートークン
注:グループ・エクスポートで保持される特定のデータの詳細についてはimport_export.ymlファイルを参照してください。

グループのエクスポート

  1. グループのホームページに移動します。

  2. サイドバーの Settingsをクリックします。

  3. Advancedセクションで、Export Groupボタンをクリックします。

    Export group panel

  4. エクスポートが生成されると、圧縮された tar アーカイブにエクスポートされたコンテンツへのリンクが記載された、JSON 形式のコンテンツが記載されたメールが送信されます。

  5. または、プロジェクト設定に戻り、Download exportをクリックしてファイルをダウンロードするか、Regenerate exportをクリックして新しいファイルを生成することもできます。

注:最大インポートファイルサイズは管理者が設定でき、デフォルトは50MBです。 管理者として、最大インポートファイルサイズを変更することができます。これを行うには、アプリケーション設定APIまたは管理者UIのmax_import_size オプションを使用します。

CEとEEの間

Community版からEnterprise版へのグループのエクスポート、またはその逆のエクスポートが可能です。

Enterprise EditionからCommunity Editionにグループをエクスポートする場合、Enterprise Editionでのみ保持されているデータが失われる可能性があります。 詳細については、EEからCEへのダウングレードを参照してください。

グループのインポート

  1. トップナビゲーションバーの「+ 」ボタン、または既存のグループページの「新規サブグループ」ボタンから、「新規グループ」ページに移動します。

    Navigation paths to create a new group

  2. 新規グループページで、インポートグループタブを選択します。

    Fill in group details

  3. グループ名を入力してください。

  4. 関連するグループの URL を受け入れるか変更します。

  5. ファイルを選択

  6. グループのエクスポートセクションでエクスポートしたファイルを選択します。

  7. グループのインポートをクリックしてインポートを開始すると、まもなく新しくインポートされたグループのページが表示されます。

バージョン履歴

GitLabは、別のGitLabデプロイからエクスポートされたバンドルをインポートすることができます。 この機能は、2つ前のGitLabマイナーリリースに限定されており、セキュリティリリースのプロセスと同様です。

使用例:

現在のバージョン からエクスポートされたバンドルをインポートできます。
13.0 13.0, 12.10, 12.9
13.1 13.1, 13.0, 12.10

料金制限

不正利用を避けるため、利用者は以下の制限を受けます:

リクエストタイプ 制限
エクスポート 5分ごとに30グループ
エクスポートのダウンロード 各グループ10分ごとに10ダウンロード
インポート 5分ごとに30グループ