Git リモート URL を簡単に更新する方法：初心者向けクイックガイド

GitのリモートURLは、git remote set-urlコマンドを使って簡単に変更できます。リモートURLを変更したいリポジトリに移動し、このコマンドを実行するだけです。set-urlコマンドは「リモート名」と「新しいリポジトリURL」という2つの引数を受け取ります。

リモートのGitリポジトリの名前を変更しましたか？あるいは、リポジトリを別の場所へ移動させようとしていますか？どちらの場合もリポジトリのURLが変わるため、既存のリモート参照が機能しなくなってしまいます。

ご安心ください。git remote set-urlコマンドを使えば、リモートリポジトリのURLをすぐに更新できます。

このガイドでは、Gitリモートとは何か、そしてその変更方法について解説します。実際のコマンド例も交えて、初心者の方でもすぐに実践できるように説明していきます。

Gitリモートとは？

Gitリモートとは、ローカルにあるリポジトリとリモートリポジトリをつなぐポインター（参照）のことです。

Gitは分散型バージョン管理システムです。つまり、複数の開発者がそれぞれ自分のマシン上にプロジェクトのコピーを保持できます。リポジトリへの変更は、リモートサーバーにプッシュしてはじめて、他の開発者がアクセスできるようになります。

1つのGitリポジトリには複数のリモートを紐付けることができますが、ほとんどのリポジトリには1つのリモートしか設定されていません。複数のリモートを持つリポジトリは、テスト環境、ステージング環境、本番環境など、異なる開発環境に接続しているのが一般的です。

リポジトリの名前を変更したり、別のホスティングプラットフォームへ移行したりする場合は、リモートURLの更新が必要になります。

git remote set-urlコマンドは、リポジトリに関連付けられたGitリモートを変更します。このコマンドは、リモート名（通常は「origin」）と、リポジトリが新しく指すURLを受け取ります。

実際に試してみよう

まず、対象のリポジトリに移動します：

cd Projects/git-submodule-tutorial

リポジトリ内に入ったら、git remote -vコマンドで現在設定されているリモートを確認してみましょう：

git remote -v

このコマンドは以下のような出力を返します：

origin    https://github.com/Career-Karma-Tutorials/git-submodule-tutorial (fetch)
origin    https://github.com/Career-Karma-Tutorials/git-submodule-tutorial (push)

ここでは「origin」という名前のリモートが1つ設定されています。このリモートは、リモートリポジトリからコードを取得（fetch）し、プッシュ（push）するために使われます。プロジェクトに複数のリモートを設定していない限り、同様の出力が表示されるはずです。

今回は、GitHub上でリポジトリの名前を「git-submodule」に変更したため、リモートURLを更新します。以下のコマンドでリモートを変更できます：

git remote set-url origin https://github.com/Career-Karma-Tutorials/git-submodule

「origin」はURLを変更したいリモートの名前で、指定したURLがプロジェクトの新しいURLになります。

リモートURLには、HTTP形式またはSSH形式のどちらでも指定できます。たとえば、SSHのURLに変更する場合は次のようにします：

git remote set-url origin git@github.com:Career-Karma-Tutorials/git-submodule.git

これで「origin」リモートがSSHのURLを指すようになりました。

新しいリモートURLが正しく設定されたか、git remote -vコマンドで確認しましょう：

git remote -v origin

リモートが正しく変更されました：

origin    git@github.com:Career-Karma-Tutorials/git-submodule.git (fetch)
origin    git@github.com:Career-Karma-Tutorials/git-submodule.git (push)

これで完了です！

設定ファイルを直接編集してリモートを変更する

作業ディレクトリ内にあるGitリポジトリのconfigファイルを編集することで、手動でリモートを変更することもできます。この方法は、Gitリポジトリの設定に対して複数の変更を行いたい場合に便利です。

リポジトリ内の.git/configファイルを開き、[remote "origin"]というセクションまでスクロールします：

[remote "origin"]
 url = git@github.com:Career-Karma-Tutorials/git-submodule.git
 fetch = +refs/heads/*:refs/remotes/origin/*

この記述を編集することで「origin」リモートを変更できます。必要な変更を加えたら、ファイルを保存してください。

ただし、リモートの変更にはGitコマンドを使うのがおすすめです。設定ファイルを手動で編集すると、誤りが発生するリスクが高まるためです。

fatal: No such remote '[name]' エラーの対処法

リモートを変更しようとした際に、次のエラーが表示されることがあります：

fatal: No such remote '[name]'

このエラーは、存在しないリモートのURLを変更しようとしたときに発生します。解決するには、変更したいリモートの名前が正しく入力されているかを確認してください。

まとめ

GitリポジトリのリモートURLは、git remote set-urlコマンドで変更できます。また、リポジトリ内の.git/configファイルを直接編集する方法もあります。

これであなたも、プロのようにGitでリモートを管理・変更できるようになりました！