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.comau lieu deplugins.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