Ajout et retrait de plug-in d'interface de ligne de commande IBM Cloud (ibmcloud plugin)

IBM Cloud® prend en charge une infrastructure de plug-in permettant d'étendre sa capacité. Les commandes suivantes permettent de gérer les plug-in d'interface de ligne de commande IBM Cloud.

ibmcloud plugin repos

Pour trouver les référentiels de plug-ins que vous souhaiteriez ajouter, vous pouvez dresser la liste de tous les référentiels de plug-ins enregistrés dans IBM Cloud CLI.

ibmcloud plugin repos

ibmcloud plugin repo-add

Ajouter un nouveau référentiel de plug-in dans l'interface de ligne de commande IBM Cloud.

ibmcloud plugin repo-add REPO_NAME REPO_URL

Options de commande :

REPO_NAME (obligatoire)
Nom du référentiel à ajouter. Vous pouvez définir votre propre nom pour chaque référentiel.
REPO_URL (obligatoire)
URL du référentiel à ajouter. L'URL du référentiel doit contenir le protocole (par exemple, https://plugins.cloud.ibm.com au lieu de plugins.cloud.ibm.com). https://plugins.cloud.ibm.com est le référentiel de plug-in officiel de IBM Cloud CLI.

Exemples :

Ajouter le référentiel de plug-in officiel de l'interface de ligne de commande IBM Cloud sous la forme ibmcloud-repo :

ibmcloud plugin repo-add ibmcloud-repo https://plugins.cloud.ibm.com

ibmcloud plugin repo-remove

Retirer un référentiel de plug-in de l'interface de ligne de commande IBM Cloud.

ibmcloud plugin repo-remove REPO_NAME

Options de commande :

REPO_NAME (obligatoire)
Nom du référentiel à supprimer.

Exemples :

Retirer le référentiel ibmcloud-repo de l'interface de ligne de commande IBM Cloud :

ibmcloud plugin repo-remove ibmcloud-repo

ibmcloud plugin repo-plugins

Répertorier tous les plug-in disponibles dans tous les référentiels ajoutés ou dans un référentiel spécifique.

ibmcloud plugin repo-plugins [-r REPO_NAME]

Options de commande :

-r REPO_NAME (facultatif)
Répertorier uniquement les plug-in dans le référentiel spécifié.

Exemples :

Répertorier tous les plug-in dans tous les référentiels ajoutés :

ibmcloud plugin repo-plugins

Répertorier tous les plug-in du référentiel ibmcloud-repo :

ibmcloud plugin repo-plugins -r ibmcloud-repo

ibmcloud plugin repo-plugin

Afficher les détails d'un plug-in dans le référentiel

ibmcloud plugin repo-plugin PLUGIN_NAME [-r REPO_NAME]

Options de commande :

-r REPO_NAME (facultatif)
Nom du référentiel. Si aucun référentiel n'est spécifié, la commande utilise le référentiel de plug-in par défaut.

Exemples :

Afficher les détails du plug-in "IBM-Containers" dans le référentiel "sample-repo" :

ibmcloud plugin repo-plugin IBM-Containers -r sample-repo

Lister les détails du plug-in " IBM-Containers" dans le référentiel par défaut

ibmcloud plugin repo-plugin IBM-Containers -r sample-repo

ibmcloud plugin liste

Répertorier tous les plug-in installés dans l'interface de ligne de commande IBM Cloud. Chaque plug-in indique la version actuellement installée, s'il existe une version plus récente disponible pour la mise à jour et si la version du plug-in installée prend en charge l'utilisation de points d'extrémité privés.

ibmcloud plugin list

ibmcloud plugin show

Afficher les détails d'un plug-in installé

ibmcloud plugin show PLUGIN-NAME

ibmcloud plugin install

Installer une version spécifique d'un plug-in pour IBM Cloud CLI à partir du chemin ou du référentiel spécifié, ou tous les derniers plug-ins disponibles dans le référentiel.

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]

Si aucun référentiel n'est spécifié, la commande utilise le référentiel de plug-in par défaut IBM Cloud. Si vous installez un seul plug-in et qu'aucune version n'est spécifiée, la commande sélectionne la dernière version disponible à installer. Si l'option '-a, --all' est spécifiée, la commande installe tous les derniers plug-ins disponibles dans le référentiel.

Options de commande :

CHEMIN_PLUGIN |NOM_PLUGIN
Si -r REPO_NAME n'est pas spécifié, le plug-in est installé à partir du chemin local spécifié ou de l'URL distante.
-a, -- all (facultatif)
Installer tous les derniers plug-ins disponibles dans le référentiel.
-r REPO_NAME (facultatif)
Nom du référentiel hébergeant le fichier binaire du plug-in. Si aucun référentiel n'est spécifié, la commande utilise le référentiel de plug-in par défaut IBM Cloud.
-v VERSION (facultatif)
Version du plug-in à installer. Accepte une contrainte ou une version sémantique spécifique.
-f (facultatif)
Forcer l'installation du plug-in sans confirmation.

Le nom de référentiel officiel de l'interface de ligne de commande IBM Cloud est IBM Cloud.

Exemples :

Installer un plug-in depuis le fichier local :

ibmcloud plugin install /downloads/new_plugin

Installer un plug-in depuis l'adresse URL distante :

ibmcloud plugin install http://example.com/downloads/my-plugin

Installer la dernière version du plug-in container-service à partir du référentiel IBM Cloud :

ibmcloud plugin install container-service -r "IBM Cloud"

Ou bien vous pouvez exécuter :

ibmcloud plugin install container-service

Installer le plug-in container-service version 0.1.425 à partir du référentiel de plug-in officiel :

ibmcloud plugin install container-service -v 0.1.425

Installez tous les derniers plug-ins disponibles à partir du dépôt officiel de plug-ins :

ibmcloud plugin install --all

Installer tous les derniers plug-ins disponibles à partir du dépôt officiel de plug-ins sans confirmation :

ibmcloud plugin install --all -f

Installez plusieurs plug-in en même temps:

ibmcloud plugin install container-service@1.0.506 secrets-manager@0.1.25

Téléchargement du plug-in ibmcloud

Télécharger une version spécifique d'un plug-in pour IBM Cloud CLI à partir du référentiel spécifié, ou tous les derniers plug-ins disponibles dans le référentiel.

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]

Si aucun référentiel n'est spécifié, la commande utilise le référentiel de plug-in par défaut IBM Cloud. Si vous téléchargez un seul plug-in et qu'aucune version n'est spécifiée, la commande sélectionne la dernière version disponible à télécharger. Si l'option '-a, --all' est spécifiée, la commande télécharge tous les derniers plug-ins disponibles dans le référentiel.

Options de commande :

-a, -- all (facultatif)
Télécharge tous les derniers plug-ins disponibles dans le référentiel.
-r REPO_NAME (facultatif)
Nom du référentiel hébergeant le fichier binaire du plug-in. Si aucun référentiel n'est spécifié, la commande utilise le référentiel de plug-in par défaut IBM Cloud.
-v VERSION (facultatif)
Version du plug-in à télécharger. Accepte une contrainte ou une version sémantique spécifique.
-d, --dest DOWNLOAD_DIRECTORY (optionnel)
Répertoire de destination du plug-in téléchargé. S'il n'est pas spécifié, il s'agit du répertoire de travail.
-f
Force le téléchargement du plug-in sans confirmation.

Le nom de référentiel officiel de l'interface de ligne de commande IBM Cloud est IBM Cloud.

Exemples :

Télécharger un plug-in à partir du site distant URL:

ibmcloud plugin download http://example.com/downloads/my-plugin

Téléchargez la dernière version du plug-in container-service à partir du dépôt IBM Cloud:

ibmcloud plugin download container-service -r "IBM Cloud"

Ou bien vous pouvez exécuter :

ibmcloud plugin download container-service

Téléchargez le plug-in container-service avec la version 0.1.425 depuis le dépôt officiel du plug-in :

ibmcloud plugin download container-service -v 0.1.425

Téléchargez le plug-in container-service avec la version 0.1.425 depuis le référentiel de plug-in officiel, dans le répertoire ~/my_downloads:

ibmcloud plugin download container-service -v 0.1.425 -d ~/my_downloads

Téléchargez tous les derniers plug-ins disponibles à partir du dépôt officiel de plug-ins :

ibmcloud plugin download --all

Télécharger tous les derniers plug-ins disponibles à partir du dépôt officiel de plug-ins sans confirmation :

ibmcloud plugin download --all -f

ibmcloud plugin update

Mettre à niveau le plug-in à partir d'un référentiel

ibmcloud plugin update [PLUGIN NAME] [-r REPO_NAME] [-v VERSION] [--all]

Si aucun référentiel n'est spécifié, la commande utilise le référentiel de plug-in par défaut IBM Cloud. Si aucune version n'est indiquée, la commande sélectionne la version la plus récente disponible pour l'installation.

Options de commande :

PLUGIN NAME
Nom du plug-in à mettre à jour. Si ce paramètre n'est pas spécifié, la commande recherche des mises à niveau pour tous les plug-in installés.
-r REPO_NAME
Nom du référentiel hébergeant le fichier binaire du plug-in. Si aucun référentiel n'est spécifié, la commande utilise le référentiel de plug-in par défaut IBM Cloud.
-v VERSION (facultatif)
Version du plug-in vers laquelle effectuer la mise à jour. Si elle n'est pas indiquée, le plug-in est mis à jour vers la version la plus récente.
--all
Mettez à jour tous les plug-in disponibles.

Exemples :

Rechercher toutes les mises à niveau disponibles dans le référentiel de plug-in officiel IBM Cloud :

ibmcloud plugin update -r "IBM Cloud"

Ou bien vous pouvez exécuter :

ibmcloud plugin update

Mettre à jour le plug-in container-service dans le dépôt officiel du plug-in vers la version la plus récente :

ibmcloud plugin update container-service

Mettre à jour le plug-in container-service dans le dépôt officiel de plug-in vers la version ' 0.1.440 ' :

ibmcloud plugin update container-service -v 0.1.440

ibmcloud plugin uninstall

Désinstaller le plug-in spécifié de l'interface de ligne de commande IBM Cloud.

ibmcloud plugin uninstall PLUGIN_NAME

Options de commande :

PLUGIN_NAME (obligatoire)
Nom du plug-in à désinstaller.

Exemples :

Désinstaller le plug-in 'container-service' précédemment installé :

ibmcloud plugin uninstall container-service