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.com anstelle von plugins.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 Cloud des 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 Cloud des 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 Cloud des 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