現在ローカル環境でGit管理しているソースコードをGitLabへ移したい場合、既存の履歴を保持したままリモートリポジトリへ接続してプッシュすることで移行できます。新しくGitLab用のプロジェクトを作成し、ローカルリポジトリの接続先を変更するだけで、これまでのコミット履歴も含めて管理できます。この記事では、すでにローカルへクローン済みのプロジェクトをGitLabへ移行する具体的な手順を解説します。
GitLabへ移行する前に確認するポイント
GitLabへコードを移す前に、現在のフォルダがGitリポジトリとして正常に管理されているか確認しましょう。
Visual Studio Codeのターミナルやコマンドプロンプトで、対象プロジェクトのフォルダへ移動し、以下のコマンドを実行します。
git status
Git管理されている場合は、現在のブランチや変更状況が表示されます。エラーが表示される場合は、まだGit管理されていない可能性があります。
また、現在設定されているリモートリポジトリは以下のコマンドで確認できます。
git remote -v
ここで表示されるURLが、現在利用しているソースコード管理サービスの接続先になります。
GitLabで新しいリポジトリを作成する
まずGitLab側に移行先となる空のプロジェクトを作成します。
GitLabへログインしたら「New project」から新規プロジェクトを作成します。このとき、既存のローカルコードを移行する場合はREADMEファイルや.gitignoreなどを自動作成しないようにすると、後の作業が簡単になります。
例えばローカルに以下のようなプロジェクトがある場合、新しく作成したGitLabプロジェクトは空の状態にしておきます。
sample-project
├── src
├── package.json
└── README.md
GitLab側に空のリポジトリができたら、そのURLをコピーします。通常はHTTPSまたはSSH形式のURLを利用します。
既存のローカルリポジトリをGitLabへ接続する
次に、ローカルリポジトリのリモート接続先をGitLabへ変更します。
現在別のリモートリポジトリが設定されている場合は、まず削除します。
git remote remove origin
その後、GitLabで作成したリポジトリを新しいoriginとして登録します。
git remote add origin GitLabのリポジトリURL
設定後、以下のコマンドで正しく変更されたか確認できます。
git remote -v
表示されたURLがGitLabのものになっていれば接続設定は完了です。
ローカルのコードをGitLabへプッシュする
リモート設定が完了したら、ローカルにあるコミット履歴をGitLabへ送信します。
現在のブランチ名を確認します。
git branch
例えばmainブランチの場合は、以下のコマンドでプッシュできます。
git push -u origin main
もしmasterブランチを利用している場合は、以下のように変更します。
git push -u origin master
初回プッシュではGitLabへの認証が求められる場合があります。HTTPS接続の場合はパスワードではなくアクセストークンの入力が必要になるケースがあります。
GitLab移行後に確認しておきたいこと
プッシュ完了後はGitLabのプロジェクトページを開き、ファイルやコミット履歴が正しく表示されているか確認します。
特に確認したいポイントは以下の項目です。
- ソースコードがすべてアップロードされているか
- 過去のコミット履歴が残っているか
- ブランチ情報が正しく反映されているか
- .gitignoreの設定が問題ないか
例えば開発途中のプロジェクトでは、node_modulesやビルド済みファイルなど不要なデータまでアップロードされていないか確認すると、今後の管理がしやすくなります。
Git GUIツールを使った移行について
TortoiseGitなどのGit管理ツールを利用している場合でも、基本的な流れは同じです。
GUIの場合は「リモートURLの変更」や「リポジトリ設定」からGitLabのURLを登録し、その後プッシュ操作を行います。
ただし、Gitの仕組みを理解するためには、一度コマンド操作でremote設定やpushの流れを確認しておくと、別のサービスへ移行するときにも応用できます。
まとめ
ローカルで管理しているソースコードをGitLabへ移行する場合、新しくGitLabリポジトリを作成し、ローカルリポジトリのremote設定を変更してpushするだけで完了します。
重要なのは、単純にファイルをコピーするのではなく、Gitのコミット履歴を含めて移行することです。正しい手順で作業すれば、これまでの開発履歴を保持したままGitLabで安全にコード管理を始められます。
コメント