Giteaから移行する

GiteaからGitLabにプロジェクトをインポートします。

Giteaインポーターは、Giteaからアイテムのサブセットをインポートします。

インポーターのワークフロー

Giteaインポーターは、GitLab.comとGitLab Self-Managedのユーザーコントリビュートの移行後マッピングをサポートしています。このインポーターは、マッピングの代替メソッドもサポートしています。

インポート時:

• リポジトリの公開アクセスは保持されます。リポジトリがGiteaでプライベートの場合、GitLabでもプライベートとして作成されます。
• インポートされたイシュー、マージリクエスト、コメントには、GitLabにインポート済みバッジが付いています。
• GiteaはOAuthプロバイダーではないため、作成者またはアサイン先をGitLabインスタンス上のユーザーにマップできません。プロジェクト作成者（通常はインポートプロセスを開始したユーザー）が作成者として設定されます。イシューについては、元のGitea作成者をまだ確認できます。

前提条件

• Giteaバージョン1.0.0以降。
• Giteaのインポート元を有効にするか、GitLab管理者に有効にするように依頼する必要があります。GitLab.comではデフォルトで有効になっています。
• インポート先のグループに対して、メンテナーロール以上。

Giteaリポジトリをインポートする

インポート中、パーソナルアクセストークンを作成し、Giteaとの1回限りの認可を実行して、リポジトリへのGitLabアクセスを許可します。

Giteaリポジトリをインポートするには、次の手順に従います:

1. 右上隅で、新規作成（ ）と新規プロジェクト/リポジトリを選択します。

2. インポートの認可プロセスを開始するには、Giteaを選択します。

3. https://your-gitea-instance/user/settings/applicationsに移動します。your-gitea-instanceをGiteaインスタンスのホストに置き換えます。

4. Generate New Tokenを選択します。

5. トークンの説明を入力します。

6. Generate Tokenを選択します。

7. トークンハッシュをコピーします。

8. GitLabに戻り、Giteaインポーターにトークンを提供します。

9. Giteaリポジトリの一覧を選択し、GitLabがリポジトリの情報を読み取るまで待ちます。完了すると、GitLabは、インポートするリポジトリを選択するためのインポーターページを表示します。そこから、Giteaリポジトリのインポートステータスを表示できます:

   • インポートされているものは、開始ステータスを示します。
   • 既に正常にインポートされたものは、完了ステータスで緑色で表示されます。
   • まだインポートされていないものは、テーブルの右側にインポートがあります。
   • 既にインポートされているものは、テーブルの右側に再インポートがあります。

10. Giteaリポジトリのインポートを完了するには、次の操作を実行できます:

    • すべてのGiteaプロジェクトを一度にインポートします。左上隅で、Import all projectsを選択します。
    • 名前でプロジェクトをフィルタリングして、選択したプロジェクトのみをインポートします。フィルターを適用すると、Import all projectsが選択したプロジェクトのみをインポートします。
    • 特権がある場合は、プロジェクトに別の名前を選択し、別のネームスペースを選択します。

マッピングの代替メソッド

GitLab 18.5以前では、gitea_user_mapping機能フラグを無効にして、インポートの代替ユーザーコントリビュートマッピングメソッドを使用できます。

このメソッドを使用すると、ユーザーコントリビュートは、デフォルトでプロジェクト作成者（通常はインポートプロセスを開始したユーザー）に割り当てられます。

関連トピック

• インポート/エクスポート設定。
• インポートのSidekiq設定。
• 複数のSidekiqプロセスの実行。
• 特定のジョブクラスの処理。