Informationen zu GitHub CLI-Erweiterungen
Hinweis: Erweiterungen außerhalb von GitHub Enterprise Cloud und GitHub CLI sind nicht von GitHub Enterprise Cloud zertifiziert und werden durch separate Nutzungsbedingungen, Datenschutzrichtlinien und Supportdokumentation geregelt. Um das Risiko bei der Verwendung von Drittanbietererweiterungen zu minimieren, überprüfe den Quellcode der Erweiterung, bevor du die Erweiterung installierst oder aktualisierst.
GitHub CLI-Erweiterungen sind benutzerdefinierte GitHub CLI-Befehle, die jeder erstellen und verwenden kann. Weitere Informationen zum Erstellen von GitHub CLI-Erweiterungen findest du unter Erstellen von GitHub CLI-Erweiterungen.
Erweiterungen werden lokal installiert und sind auf den Benutzer beschränkt. Wenn du also von einem anderen Computer aus auf GitHub CLI zugreifst oder ein anderer Benutzer von deinem Computer aus auf GitHub CLI zugreift, ist die Erweiterung nicht verfügbar.
Suchen nach Erweiterungen
Du findest Erweiterungen, indem du Repositorys mit dem gh-extension-Thema durchsuchst.
Installieren von Erweiterungen
Um eine Erweiterung zu installieren, verwende den extensions install-Unterbefehl. Ersetze den repo-Parameter durch das Repository der Erweiterung. Du kannst die vollständige URL wie z. B. https://github.com/octocat/gh-whoami verwenden, oder einfach den Besitzer und das Repository, z. B. octocat/gh-whoami.
Wenn der Besitzer und das Repository verwendet werden, installiert gh die Erweiterung mithilfe des Hostnamens, bei dem gh derzeit authentifiziert ist. Das vollständige URL-Format ist nützlich, wenn Erweiterungen von einem anderen Host aus installiert werden. Benutzer in GitHub Enterprise Server sollten beispielsweise die vollständige Repository-URL verwenden, um Erweiterungen von GitHub.com oder einem anderen Host aus zu installieren.
Verwende zum Installieren einer Erweiterung in der Entwicklung aus dem aktuellen Verzeichnis . als Wert für den repo-Parameter.
gh extension install REPO
Wenn du bereits eine Erweiterung mit demselben Namen installiert hast, ist der Befehl nicht erfolgreich ausführbar. Wenn du z. B. octocat/gh-whoami installiert hast, musst du dies deinstallieren, bevor du hubot/gh-whoami installierst.
Ausführen einer Erweiterung
Wenn Sie eine Erweiterung installiert haben, führen Sie die Erweiterung wie einen nativen GitHub CLI-Befehl mit gh EXTENSION-NAME aus. Das EXTENSION-NAME ist der Name des Repositorys, das die Erweiterung enthält, abzüglich des Präfixes gh-.
Wenn Sie beispielsweise die Erweiterung aus dem octocat/gh-whoami-Repository installiert haben, führen Sie die Erweiterung mit dem folgenden Befehl aus.
gh whoami
In der Regel finden Sie spezifische Informationen zur Verwendung einer Erweiterung in der Infodatei des Repositorys, das die Erweiterung enthält.
Anzeigen installierter Erweiterungen
Um alle installierten Erweiterungen anzuzeigen, verwende den extensions list-Unterbefehl. Die Ausgabe teilt dir auch mit, für welche Erweiterungen Updates verfügbar sind.
gh extension list
Aktualisieren von Erweiterungen
Um eine Erweiterung zu aktualisieren, verwende den extensions upgrade-Unterbefehl. Ersetze den extension-Parameter durch den Namen der Erweiterung.
gh extension upgrade EXTENSION
Um alle installierten Erweiterungen zu aktualisieren, verwende das --all-Flag.
gh extension upgrade --all
Deinstallieren von Erweiterungen
Um eine Erweiterung zu deinstallieren, verwende den extensions remove-Unterbefehl. Ersetze den extension-Parameter durch den Namen der Erweiterung.
gh extension remove EXTENSION