この記事で実現できること
- 「GitLab」のリポジトリを「AWS CodeCommit」へ移行すること。
前提
- AWSアカウントがあること。
- 作業に使うIAMロール（IAMユーザ）に、「AWSCodeCommitPowerUser」ポリシーがアタッチされていること。CodeCommitのポリシーの詳細は CodeCommit の AWS 管理ポリシー を参照。
- AWS CLI バージョン 1.7.38 以降がインストールされ、configureの設定が完了していること。理由は AWS CodeCommit コマンドラインリファレンス を参照。
- Git バージョン 1.7.9 以降がインストールされていること。理由は Git リポジトリを AWS CodeCommit に移行する > Git をインストール を参照。
AWS CLI と Git は、最新バージョンのインストールを推奨。
手順開始前にやること
- ローカルの編集内容は引き継がれないため、移行先に引き継ぎたい内容はプッシュしておく。
- マージリクエストは引き継がれないため、移行前のリポジトリでマージリクエストを作成していた場合、移行後新たにプルリクエストを作成する。
手順
1. CodeCommitでリポジトリを作成する
-
CodeCommitにアクセスし、ナビゲーションバーからリポジトリを作成するAWSリージョンを選択する。
-
「リポジトリの作成」をクリックする。
-
「リポジトリ名」と、必要に応じて「説明 - オプショナル」欄にリポジトリの説明を記入し、「作成」をクリックする。
-
中身が空のリポジトリが作成された。
-
「URLのクローン」から「HTTPSのクローン」を選択し、クローン用のURLをコピーする。
後の手順で使うため、コピーしたURLはメモしておく。
2. CodeCommitへのHTTPS接続用のGit認証情報を作成する
既に「Git認証情報」が作成されている場合は、2.の手順は飛ばしてください。
-
IAMにアクセスし、「ユーザー」から「自分のIAMユーザー」を選択する。
-
「セキュリティ認証情報」タブを選択し、「AWS CodeCommit の HTTPS Git 認証情報」で「認証情報を生成」を選択する。
-
新しい認証情報が作成される。
ポップアップを閉じてしまったら今回作成されたパスワードは保存できなくなってしまうため、「認証情報をダウンロード」からダウンロードして、安全な場所に保存しておく。
このユーザー名とパスワードは後の手順で使うため、保存した場所を覚えておく。
3. GitLabリポジトリのクローンを作成して、CodeCommitリポジトリにプッシュする
-
GitLabにアクセスし、CodeCommitに移行したいプロジェクトを開く。
-
画面右の「クローン」から「HTTPSでクローン」の「URL横のアイコン」を選択し、クローン用のURLをコピーする。
次の手順で使うため、コピーしたURLはメモしておく。
-
コマンドプロンプトの任意のディレクトリで以下のコマンドを実行し、GitLabリポジトリのクローンをローカルディレクトリに作成する。
クローンを作成するディレクトリには任意の名前を付ける。git clone --mirror ${ 3.2でコピーしたGitLabリポジトリのクローン用URL } ${ GitLabリポジトリのクローンを作成するディレクトリ名 } -
以下のコマンドを実行し、クローンを作成したディレクトリに移動する。
cd ${ クローンを作成したディレクトリ名 } -
以下のコマンドを実行し、ローカルにクローンしたGitLabリポジトリを1.3で作成したCodeCommitリポジトリにプッシュする。
認証を求められた場合は、2.3で作成されたユーザー名とパスワードを入力する。
※--allオプションでは、タグがプッシュされないので注意。git push ${ 1-5.でコピーしたCodeCommitリポジトリのクローン用URL } --all
-
GitLabリポジトリのタグもプッシュしたい場合は、3.5が完了するのを待ってから以下のコマンドを実行する。
git push ${ 1-5.でコピーしたCodeCommitリポジトリのクローン用URL } --tags -
プッシュ完了後にCodeCommitリポジトリを見ると、コード・ブランチ・Git タグを移行できていることが確認できる。
