リモートリポジトリを管理する

Note

この記事には、github.com ドメインを使うコマンドまたは例が含まれています。 octocorp.ghe.com など、別のドメインで GitHub にアクセスすることもできます。

リモートリポジトリの追加

新しいリモートを追加するには、リポジトリが保存されているディレクトリでターミナルから git remote add コマンドを使います。

git remote add コマンドは 2 つの引数を取ります。

リモート名 (例: origin)
リモート URL (例: https://github.com/OWNER/REPOSITORY.git)

次に例を示します。

$ git remote add origin https://github.com/OWNER/REPOSITORY.git
# Set a new remote

$ git remote -v
# Verify new remote
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

どの URL を使うかの詳細については、「リモートリポジトリについて」を参照してください。

トラブルシューティング: リモート配信元が既に存在します

このエラーは、ローカルのリポジトリに既に存在している名前でリモートを追加しようとしたということです。

$ git remote add origin https://github.com/octocat/Spoon-Knife.git
> fatal: remote origin already exists.

この問題を解決するには、以下を実行してください。

新しいリモートに別の名前を使う。
新しいリモートを追加する前に、既存のリモートリポジトリの名前を変更する。詳細については、後述する「リモートリポジトリの名前を変更する」を参照してください。
新しいリモートを追加する前に、既存のリモートリポジトリの名前を削除する。詳細については、後述する「リモートリポジトリの削除」を参照してください。

リモートリポジトリの URL の変更

git remote set-url コマンドは、既存のリモートリポジトリ URL を変更します。

Tip

HTTPS と SSH の URL の違いについては、「リモートリポジトリについて」を参照してください。

git remote set-url コマンドは 2 つの引数を取ります。

既存のリモート名。たとえば、origin や upstream の 2 つが一般的な選択肢です。
リモートの新しい URL。たとえば次のような点です。
- HTTPS を使うよう更新する場合、URL は以下のようになります:
```
https://github.com/OWNER/REPOSITORY.git
```
- SSH を使うよう更新する場合、URL は以下のようになります:
```
git@github.com:OWNER/REPOSITORY.git
```

リモート URL の SSH から HTTPS への切り替え

[ターミナル][ターミナル][Git Bash] を開きます。
ワーキングディレクトリをローカルプロジェクトに変更します。

変更したいリモートの名前を取得するため、既存のリモート一覧を表示します。

$ git remote -v
> origin  git@github.com:OWNER/REPOSITORY.git (fetch)
> origin  git@github.com:OWNER/REPOSITORY.git (push)

git remote set-url コマンドを使用して、リモートの URL を SSH から HTTPS に変更します。
```
git remote set-url origin https://github.com/OWNER/REPOSITORY.git
```

リモート URL が変更されたことを検証します。

$ git remote -v
# Verify new remote URL
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

次回、リモートリポジトリに git fetch、git pull、git push を実行すると、GitHub のユーザー名とパスワードの入力を求められます。 Git からパスワードの入力するダイアログが表示されたら、personal access token を入力します。または、Git Credential Manager などの認証情報ヘルパーを使用できます。より安全な認証方法を優先し、Git のパスワードベースの認証が削除されました。詳しくは、「個人用アクセストークンを管理する」を参照してください。

資格情報ヘルパーを使用して、Git が GitHub と通信するたびに、GitHub ユーザー名と personal access token を記憶させることができます。

リモート URL の HTTPS から SSH への切り替え

[ターミナル][ターミナル][Git Bash] を開きます。
ワーキングディレクトリをローカルプロジェクトに変更します。

変更したいリモートの名前を取得するため、既存のリモート一覧を表示します。

$ git remote -v
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

git remote set-url コマンドを使用して、リモートの URL を HTTPS から SSH に変更します。
```
git remote set-url origin git@github.com:OWNER/REPOSITORY.git
```

リモート URL が変更されたことを検証します。

$ git remote -v
# Verify new remote URL
> origin  git@github.com:OWNER/REPOSITORY.git (fetch)
> origin  git@github.com:OWNER/REPOSITORY.git (push)

トラブルシューティング: このようなリモート '[name]' はありません

このエラーは、変更しようとしたリモートが存在しないことを意味します。

$ git remote set-url sofake https://github.com/octocat/Spoon-Knife
> fatal: No such remote 'sofake'

リモート名を正しく入力したか確認してください。

リモートリポジトリの名前を変更する

git remote rename コマンドを使用して、既存のリモートの名前を変更します。

git remote rename コマンドは 2 つの引数を取ります。

既存のリモート名 (例: origin)
リモートの新しい名前 (例: destination)

リモートリポジトリの名前変更の例

これらの例では、HTTPS を使用して複製することを前提としています (推奨)。

$ git remote -v
# View existing remotes
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

$ git remote rename origin destination
# Change remote name from 'origin' to 'destination'

$ git remote -v
# Verify remote's new name
> destination  https://github.com/OWNER/REPOSITORY.git (fetch)
> destination  https://github.com/OWNER/REPOSITORY.git (push)

トラブルシューティング: 構成セクションの 'remote.[古い名前]' を 'remote.[新しい名前]' に変更できませんでした

このエラーは、入力した古いリモート名が存在しないことを意味します。

git remote -v コマンドを使用すると、現在存在するリモートを確認できます。

$ git remote -v
# View existing remotes
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

トラブルシューティング: リモート [新しい名前] は既に存在します

このエラーは、使用しようとしたリモート名がすでに存在する、という意味です。これを解決するには、別のリモート名を使用するか、または元のリモートの名前を変更するかのいずれかです。

リモートリポジトリを削除する

git remote rm コマンドを使用して、リポジトリからリモート URL を削除します。

git remote rm コマンドは、次の 1 つの引数を受け取ります。

リモート名 (例: destination)

リポジトリからリモート URL を削除すると、ローカルおよびリモートリポジトリのリンクのみが解除されます。リモートリポジトリは削除されません。

リモートリポジトリの削除の例