CLI-Plug-ins in IBM Cloud hinzufügen und entfernen (ibmcloud plugin)
IBM Cloud® unterstützt ein Plug-in-Framework zur Erweiterung der verfügbaren Funktionalität. Mit den folgenden Befehlen können Sie die Plug-in der Befehlszeilenschnittstelle (CLI) von IBM Cloud verwalten.
ibmcloud plugin repos
Um Plug-in-Repositories zu finden, die Sie eventuell hinzufügen möchten, können Sie alle Plug-in-Repositories auflisten, die in IBM Cloud CLI registriert sind.
ibmcloud plugin repos
ibmcloud plugin repo-add
Neues Plug-in-Repository zur Befehlszeilenschnittstelle von IBM Cloud hinzufügen.
ibmcloud plugin repo-add REPO_NAME REPO_URL
Befehlsoptionen:
- REPO_NAME (erforderlich)
- Der Name des Repositorys, das hinzugefügt werden soll. Sie können einen eigenen Namen für jedes Repository definieren.
- REPO_URL (erforderlich)
- Die URL des Repositorys, das hinzugefügt werden soll. Die Repository-URL muss das Protokoll enthalten (z. B.
https://plugins.cloud.ibm.comanstelle vonplugins.cloud.ibm.com). https://plugins.cloud.ibm.com ist das offizielle Plug-in-Repository der IBM Cloud-CLI.
Beispiele:
Offizielles Plug-in-Repository der IBM Cloud-Befehlszeilenschnittstelle als ibmcloud-repo hinzufügen:
ibmcloud plugin repo-add ibmcloud-repo https://plugins.cloud.ibm.com
ibmcloud plugin repo-remove
Plug-in-Repository aus der IBM Cloud-CLI entfernen.
ibmcloud plugin repo-remove REPO_NAME
Befehlsoptionen:
- REPO_NAME (erforderlich)
- Der Name des Repositorys, das entfernt werden soll.
Beispiele:
Repository ibmcloud-repo aus der IBM Cloud-Befehlszeilenschnittstelle entfernen:
ibmcloud plugin repo-remove ibmcloud-repo
ibmcloud plugin repo-plugins
Alle verfügbaren Plug-ins in allen hinzufügten Repositorys oder einem bestimmten Repository auflisten.
ibmcloud plugin repo-plugins [-r REPO_NAME]
Befehlsoptionen:
- -r REPO_NAME (optional)
- Nur die Plug-ins im angegebenen Repository auflisten.
Beispiele:
Alle Plug-ins in allen hinzugefügten Repositorys auflisten:
ibmcloud plugin repo-plugins
Alle Plug-ins im Repository ibmcloud-repo auflisten:
ibmcloud plugin repo-plugins -r ibmcloud-repo
ibmcloud plugin repo-plugin
Details eines Plug-ins im Repository anzeigen.
ibmcloud plugin repo-plugin PLUGIN_NAME [-r REPO_NAME]
Befehlsoptionen:
- -r REPO_NAME (optional)
- Der Name des Repositorys. Wird kein Repository angegeben, verwendet der Befehl das Standardrepository des Plug-ins.
Beispiele:
Details des Plug-ins "IBM-Containers" im Repository "sample-repo" auflisten:
ibmcloud plugin repo-plugin IBM-Containers -r sample-repo
Details zum Plug-in " IBM-Containers" im Standard-Repository auflisten
ibmcloud plugin repo-plugin IBM-Containers -r sample-repo
ibmcloud plugin list
Alle installierten Plug-ins in der IBM Cloud-CLI auflisten. Jedes Plug-in gibt die aktuell installierte Version zurück, ob eine neuere Version zur Aktualisierung verfügbar ist und ob die installierte Version des Plug-ins die Verwendung privater Endpunkte unterstützt.
ibmcloud plugin list
ibmcloud plugin show
Details eines installierten Plug-ins anzeigen.
ibmcloud plugin show PLUGIN-NAME
ibmcloud plugin install
Installieren Sie eine bestimmte Version eines Plug-ins für IBM Cloud CLI aus dem angegebenen Pfad oder Repository oder alle zuletzt verfügbaren Plug-ins aus dem Repository.
ibmcloud plugin install PLUGIN_PATH|PLUGIN_NAME [-r REPO_NAME] [-v VERSION] [-f]
ibmcloud plugin install [-a, --all] [-r REPO_NAME] [-f]
ibmcloud plugin install LOCAL-PATH/TO/PLUGIN | URL [-f]
Wird kein Repository angegeben, verwendet der Befehl das Standardrepository IBM Cloud des Plug-ins. Wenn Sie ein einzelnes Plug-in installieren und keine Version angegeben ist, wählt der Befehl die letzte verfügbare Version zur
Installation aus. Wenn das Flag '-a, --all' angegeben ist, installiert der Befehl alle zuletzt verfügbaren Plug-ins im Repository.
Befehlsoptionen:
- PLUGIN_PATH|PLUGIN_NAME
- Wenn -r REPO_NAME nicht angegeben ist, wird das Plug-in aus dem angegebenen lokalen Pfad oder der angegebenen fernen URL installiert.
- -a, --all (optional)
- Installieren Sie alle aktuell verfügbaren Plug-ins aus dem Repository.
- -r REPO_NAME (optional)
- Der Name des Repositorys, in dem sich die Plug-in-Binärdatei befindet. Wird kein Repository angegeben, verwendet der Befehl das Standardrepository
IBM Clouddes Plug-ins. - -v VERSION (optional)
- Die Version des Plug-ins, die installiert werden soll. Bestimmte semantische Versionen oder Einschränkungen werden akzeptiert.
- -f (optional)
- Installieren des Plug-ins ohne Bestätigung erzwingen.
Die IBM Cloud-CLI trägt den offiziellen Repository-Namen IBM Cloud.
Beispiele:
Plug-in von der lokalen Datei installieren:
ibmcloud plugin install /downloads/new_plugin
Plug-in von der Remote URL installieren:
ibmcloud plugin install http://example.com/downloads/my-plugin
Plug-in container-service der neuesten Version aus dem Repository IBM Cloud installieren:
ibmcloud plugin install container-service -r "IBM Cloud"
Sie können alternativ Folgendes ausführen:
ibmcloud plugin install container-service
Plug-in container-service mit der Version 0.1.425 aus dem offiziellen Plug-in-Repository installieren:
ibmcloud plugin install container-service -v 0.1.425
Installieren Sie die neuesten verfügbaren Plug-ins aus dem offiziellen Plug-in-Repository:
ibmcloud plugin install --all
Installieren Sie alle neuesten verfügbaren Plug-ins aus dem offiziellen Plug-in-Repository ohne Bestätigung:
ibmcloud plugin install --all -f
Mehrere Plug-ins gleichzeitig installieren:
ibmcloud plugin install container-service@1.0.506 secrets-manager@0.1.25
Download des Plug-ins 'ibmcloud'
Laden Sie eine bestimmte Version eines Plug-ins für IBM Cloud CLI aus dem angegebenen Repository herunter, oder alle zuletzt verfügbaren Plug-ins im Repository.
ibmcloud plugin download PLUGIN_NAME [-r REPO_NAME] [-v VERSION] [-d, --dest DOWNLOAD_DIRECTORY] [-f]
ibmcloud plugin download [-a, --all] [-r REPO_NAME] [-f]
ibmcloud plugin download URL [-f] [-d DOWNLOAD_DIRECTORY]
Wird kein Repository angegeben, verwendet der Befehl das Standardrepository IBM Cloud des Plug-ins. Wenn Sie ein einzelnes Plug-in herunterladen und keine Version angegeben ist, wählt der Befehl die letzte verfügbare Version zum
Herunterladen aus. Wenn das Flag '-a, --all' angegeben ist, lädt der Befehl alle zuletzt verfügbaren Plug-ins aus dem Repository herunter.
Befehlsoptionen:
- -a, --all (optional)
- Lädt alle aktuell verfügbaren Plug-ins aus dem Repository herunter.
- -r REPO_NAME (optional)
- Der Name des Repositorys, in dem sich die Plug-in-Binärdatei befindet. Wird kein Repository angegeben, verwendet der Befehl das Standardrepository
IBM Clouddes Plug-ins. - -v VERSION (optional)
- Version des Plug-ins, das heruntergeladen werden soll. Bestimmte semantische Versionen oder Einschränkungen werden akzeptiert.
- -d, --dest DOWNLOAD_DIRECTORY (optional)
- Das Zielverzeichnis für das heruntergeladene Plug-in. Falls nicht angegeben, ist dies das Arbeitsverzeichnis.
- -f
- Erzwingt den Download des Plug-ins ohne Bestätigung.
Die IBM Cloud-CLI trägt den offiziellen Repository-Namen IBM Cloud.
Beispiele:
Laden Sie ein Plug-in von der entfernten URL herunter:
ibmcloud plugin download http://example.com/downloads/my-plugin
Laden Sie das container-service Plug-in in der neuesten Version aus dem IBM Cloud Repository herunter:
ibmcloud plugin download container-service -r "IBM Cloud"
Sie können alternativ Folgendes ausführen:
ibmcloud plugin download container-service
Laden Sie das Plug-in container-service mit der Version 0.1.425 aus dem offiziellen Plug-in-Repository herunter:
ibmcloud plugin download container-service -v 0.1.425
Laden Sie das Plug-in container-service mit der Version 0.1.425 aus dem offiziellen Plug-in-Repository in das Verzeichnis ~/my_downloads herunter:
ibmcloud plugin download container-service -v 0.1.425 -d ~/my_downloads
Laden Sie die neuesten verfügbaren Plug-ins aus dem offiziellen Plug-in-Repository herunter:
ibmcloud plugin download --all
Laden Sie alle aktuell verfügbaren Plug-ins aus dem offiziellen Plug-in-Repository herunter, ohne sie zu bestätigen:
ibmcloud plugin download --all -f
ibmcloud plugin update
Upgrade des Plug-ins aus einem Repository durchführen.
ibmcloud plugin update [PLUGIN NAME] [-r REPO_NAME] [-v VERSION] [--all]
Wird kein Repository angegeben, verwendet der Befehl das Standardrepository IBM Cloud des Plug-ins. Wenn keine Version angegeben wird, wählt der Befehl die neueste verfügbare Version zur Installation aus.
Befehlsoptionen:
- PLUGIN NAME
- Name des zu aktualisierenden Plug-ins. Wenn keine Angabe erfolgt, prüft der Befehl Upgrades für alle installierten Befehle.
- -r REPO_NAME
- Der Name des Repositorys, in dem sich die Plug-in-Binärdatei befindet. Wenn keine Angabe gemacht wird, verwendet der Befehl das Standardrepository
IBM Clouddes Plug-ins. - -v VERSION (optional)
- Die Version des Plug-ins, auf die aktualisiert werden soll. Wenn keine Version angegeben wird, wird das Plug-in auf die neueste Version aktualisiert.
- --all
- Aktualisieren Sie alle verfügbaren Plug-ins.
Beispiele:
Offizielles Plug-in-Repository IBM Cloud auf alle verfügbaren Upgrades prüfen:
ibmcloud plugin update -r "IBM Cloud"
Sie können alternativ Folgendes ausführen:
ibmcloud plugin update
Aktualisieren Sie das Plug-in container-service im offiziellen Plug-in-Repository auf die neueste Version:
ibmcloud plugin update container-service
Aktualisieren Sie das Plug-in container-service im offiziellen Plug-in-Repository auf die Version ' 0.1.440 ':
ibmcloud plugin update container-service -v 0.1.440
ibmcloud plugin uninstall
Angegebenes Plug-in in der IBM Cloud-CLI deinstallieren.
ibmcloud plugin uninstall PLUGIN_NAME
Befehlsoptionen:
- PLUGIN_NAME (erforderlich)
- Der Name des Plug-ins, das deinstalliert werden soll.
Beispiele:
Plug-in 'container-service' deinstallieren, das zuvor installiert wurde:
ibmcloud plugin uninstall container-service