Hinzufügen eines Remoterepositorys
Verwende zum Hinzufügen eines neuen Remoterepositorys im Terminal den Befehl git remote add
in dem Verzeichnis, in dem dein Repository gespeichert ist.
Der Befehl git remote add
akzeptiert zwei Argumente:
- Einen Remotenamen (beispielsweise
origin
) - Eine Remote-URL (beispielsweise
https://HOSTNAME/OWNER/REPOSITORY.git
)
Beispiel:
$ git remote add origin https://HOSTNAME/OWNER/REPOSITORY.git
# Set a new remote
$ git remote -v
# Verify new remote
> origin https://HOSTNAME/OWNER/REPOSITORY.git (fetch)
> origin https://HOSTNAME/OWNER/REPOSITORY.git (push)
Weitere Informationen zu der zu verwendenden URL findest du unter Informationen zu Remote-Repositorys.
Problembehandlung: Das Remoterepository „origin“ ist bereits vorhanden.
Dieser Fehler bedeutet, dass du versucht hast, ein Remoterepository hinzuzufügen, dessen Name bereits in deinem lokalen Repository vorhanden ist.
$ git remote add origin https://HOSTNAME/octocat/Spoon-Knife.git
> fatal: remote origin already exists.
Du kannst das Problem wie folgt beheben:
- Verwende einen anderen Namen für das Remoterepository.
- Benenne das vorhandene Remoterepository um, bevor du das neue Remoterepository hinzufügst. Weitere Informationen findest du weiter unten unter Umbenennen eines Remoterepositorys.
- Lösche das vorhandene Remoterepository, bevor du das neue Remoterepository hinzufügst. Weitere Informationen findest du weiter unten unter Entfernen eines Remoterepositorys.
Ändern der URL eines Remoterepositorys
Der Befehl git remote set-url
dient zum Ändern der URL eines vorhandenen Remoterepositorys.
Tipp: Weitere Informationen zum Unterschied zwischen HTTPS- und SSH-URLs findest du unter Informationen zu Remote-Repositorys.
Der Befehl git remote set-url
akzeptiert zwei Argumente:
-
einen vorhandenen Remote-Namen.
origin
undupstream
werden beispielsweise häufig verwendet. -
eine neue URL für das Remote-Repository. Beispiel:
- Wenn Du eine Aktualisierung auf HTTPS durchführst, sieht die URL ähnlich aus wie folgende:
https://HOSTNAME/OWNER/REPOSITORY.git
- Wenn Du eine Aktualisierung auf SSH durchführst, sieht die URL ähnlich aus wie folgende:
git@HOSTNAME:OWNER/REPOSITORY.git
Remote-URLs von SSH auf HTTPS umstellen
-
Öffne TerminalTerminalGit Bash.
-
Ändere das aktuelle Arbeitsverzeichnis in das lokale Projekt.
-
Liste die vorhandenen Remote-Repositorys auf, um den Namen des Remote-Repositorys zu erhalten, dessen URL Du ändern möchtest.
$ git remote -v > origin git@HOSTNAME:OWNER/REPOSITORY.git (fetch) > origin git@HOSTNAME:OWNER/REPOSITORY.git (push)
-
Ändere die URL deines Remoterepositorys mithilfe des Befehls
git remote set-url
von SSH in HTTPS.git remote set-url origin https://HOSTNAME/OWNER/REPOSITORY.git
-
Überprüfe, ob die Remote-URL geändert wurde.
$ git remote -v # Verify new remote URL > origin https://HOSTNAME/OWNER/REPOSITORY.git (fetch) > origin https://HOSTNAME/OWNER/REPOSITORY.git (push)
Wenn du das nächste Mal git fetch
, git pull
oder git push
für das Remoterepository verwendest, wirst du zur Angabe deines GitHub-Benutzernamens und deines GitHub-Kennworts aufgefordert. Wenn Sie Git zur Eingabe Ihres Kennworts auffordert, geben Sie Ihr personal access token ein. Alternativ kann ein Hilfsprogramm für Anmeldedaten wie die Git Anmeldeinformationsverwaltung verwendet werden. Die kennwortbasierte Authentifizierung für Git wurde zugunsten sichererer Authentifizierungsmethoden aufgegeben. Weitere Informationen findest du unter Verwalten deiner persönlichen Zugriffstoken.
Du kannst ein Hilfsprogramm für Anmeldeinformationen verwenden, damit Git deinen GitHub-Benutzernamen und dein personal access token speichert und bei jeder Kommunikation mit GitHub darauf zurückgreift.
Umstellen von Remote-URLs von HTTPS auf SSH
-
Öffne TerminalTerminalGit Bash.
-
Ändere das aktuelle Arbeitsverzeichnis in das lokale Projekt.
-
Liste die vorhandenen Remote-Repositorys auf, um den Namen des Remote-Repositorys zu erhalten, dessen URL Du ändern möchtest.
$ git remote -v > origin https://HOSTNAME/OWNER/REPOSITORY.git (fetch) > origin https://HOSTNAME/OWNER/REPOSITORY.git (push)
-
Ändere die URL deines Remoterepositorys mithilfe des Befehls
git remote set-url
von HTTPS in SSH.git remote set-url origin git@HOSTNAME:OWNER/REPOSITORY.git
-
Überprüfe, ob die Remote-URL geändert wurde.
$ git remote -v # Verify new remote URL > origin git@HOSTNAME:OWNER/REPOSITORY.git (fetch) > origin git@HOSTNAME:OWNER/REPOSITORY.git (push)
Problembehandlung: Es ist kein Remoterepository mit dem Namen „[Name]“ vorhanden.
Wenn dieser Fehler ausgegeben wird, ist das Remote-Repository, das Du ändern wolltest, nicht vorhanden:
$ git remote set-url sofake https://HOSTNAME/octocat/Spoon-Knife
> fatal: No such remote 'sofake'
Überprüfe, ob Du den Namen des Remote-Repositorys korrekt eingegeben hast.
Umbenennen eines Remoterepositorys
Verwende den Befehl git remote rename
, um ein vorhandenes Remoterepository umzubenennen.
Der Befehl git remote rename
akzeptiert zwei Argumente:
- Den Namen eines vorhandenen Remoterepositorys (beispielsweise
origin
) - Einen neuen Namen für das Remoterepository (beispielsweise
destination
)
Beispiel für die Umbenennung eines Remoterepositorys
In diesen Beispielen wird davon ausgegangen, dass du beim Klonen HTTPS verwendest (wie empfohlen).
$ git remote -v
# View existing remotes
> origin https://HOSTNAME/OWNER/REPOSITORY.git (fetch)
> origin https://HOSTNAME/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://HOSTNAME/OWNER/REPOSITORY.git (fetch)
> destination https://HOSTNAME/OWNER/REPOSITORY.git (push)
Problembehandlung: Der Konfigurationsabschnitt „remote.[alter Name]“ konnte nicht in „remote.[neuer Name]“ umbenannt werden.
Dieser Fehler tritt auf, wenn der alte Name, den du für das Remoterepository eingegeben hast, nicht vorhanden ist.
Mit dem Befehl git remote -v
kannst du überprüfen, welche Remoterepositorys vorhanden sind:
$ git remote -v
# View existing remotes
> origin https://HOSTNAME/OWNER/REPOSITORY.git (fetch)
> origin https://HOSTNAME/OWNER/REPOSITORY.git (push)
Problembehandlung: Das Remoterepository „[neuer Name]“ ist bereits vorhanden.
Wenn dieser Fehler ausgegeben wird, wird der Name, in den Du das Remote-Repository umbenennen möchtest, bereits verwendet. Verwende in diesem Fall entweder einen anderen Namen für das Remoterepository, oder benenne das ursprüngliche Remoterepository um.
Entfernen eines Remoterepositorys
Verwende den Befehl git remote rm
, um eine Remote-URL aus deinem Repository zu entfernen.
Der Befehl git remote rm
akzeptiert ein einzelnes Argument:
- Einen Remotenamen (beispielsweise
destination
)
Wenn du die Remote-URL aus deinem Repository entfernst, wird lediglich die Verknüpfung zwischen lokalem Repository und Remoterepository aufgehoben. Das Remoterepository wird dadurch nicht gelöscht.
Beispiel für das Entfernen eines Remoterepositorys
In diesen Beispielen wird davon ausgegangen, dass du beim Klonen HTTPS verwendest (wie empfohlen).
$ git remote -v
# View current remotes
> origin https://HOSTNAME/OWNER/REPOSITORY.git (fetch)
> origin https://HOSTNAME/OWNER/REPOSITORY.git (push)
> destination https://HOSTNAME/FORKER/REPOSITORY.git (fetch)
> destination https://HOSTNAME/FORKER/REPOSITORY.git (push)
$ git remote rm destination
# Remove remote
$ git remote -v
# Verify it's gone
> origin https://HOSTNAME/OWNER/REPOSITORY.git (fetch)
> origin https://HOSTNAME/OWNER/REPOSITORY.git (push)
Hinweis: Durch git remote rm
wird das Remoterepository nicht vom Server gelöscht. Der Befehl entfernt lediglich das Remoterepository und die zugehörigen Verweise aus deinem lokalen Repository.
Problembehandlung: Der Konfigurationsabschnitt „remote.[Name]“ konnte nicht entfernt werden.
Wenn dieser Fehler ausgegeben wird, ist das Remote-Repository, das Du entfernen wolltest, nicht vorhanden:
$ git remote rm sofake
> error: Could not remove config section 'remote.sofake'
Überprüfe, ob Du den Namen des Remote-Repositorys korrekt eingegeben hast.