Adición y eliminación de plugins de CLI de IBM Cloud (ibmcloud plugin)

IBM Cloud® da soporte a una infraestructura de plug-in para ampliar su capacidad. Utilice los mandatos siguientes para gestionar los plug-ins de la interfaz de línea de mandatos de IBM Cloud.

ibmcloud plugin repos

Para encontrar los repositorios de plug-ins que desee añadir, puede obtener una lista de todos los repositorios de plug-ins registrados en IBM Cloud CLI.

ibmcloud plugin repos

ibmcloud plugin repo-add

Agrega un nuevo repositorio de plug-in a la CLI de IBM Cloud.

ibmcloud plugin repo-add REPO_NAME REPO_URL

Opciones de mandato:

REPO_NAME (necesario): Nombre del repositorio que se debe añadir. Puede volver a definir su propio nombre para cada repositorio.
REPO_URL (necesario): URL del repositorio que se debe añadir. El URL del repositorio debe contener el protocolo (por ejemplo, https://plugins.cloud.ibm.com en lugar de plugins.cloud.ibm.com). https://plugins.cloud.ibm.com es el repositorio de plug-in oficial de la CLI de IBM Cloud.

Ejemplos:

Añadir el repositorio de plugins oficial de la CLI de IBM Cloud como ibmcloud-repo:

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

ibmcloud plugin repo-remove

Elimina el repositorio de plugins de la CLI de IBM Cloud.

ibmcloud plugin repo-remove REPO_NAME

Opciones de mandato:

REPO_NAME (necesario): Nombre del repositorio que se debe eliminar.

Ejemplos:

Eliminar el repositorio ibmcloud-repo desde la CLI de IBM Cloud:

ibmcloud plugin repo-remove ibmcloud-repo

ibmcloud plugin repo-plugins

Crear una lista de todos los plug-ins disponibles en todos los repositorios o repositorios específicos.

ibmcloud plugin repo-plugins [-r REPO_NAME]

Opciones de mandato:

-r REPO_NAME (opcional): Listar únicamente los plugins del repositorio especificado.

Ejemplos:

Listar todos los plugins de todos los repositorios añadidos:

ibmcloud plugin repo-plugins

Listar todos los plug-ins del repositorio ibmcloud-repo:

ibmcloud plugin repo-plugins -r ibmcloud-repo

ibmcloud plugin repo-plugin

Mostrar los detalles de un plug-in del repositorio.

ibmcloud plugin repo-plugin PLUGIN_NAME [-r REPO_NAME]

Opciones de mandato:

-r REPO_NAME (opcional): Nombre del repositorio. Si no se especifica ningún repositorio, el mandato utilizará el repositorio de plug-in predeterminado.

Ejemplos:

Listar los detalles del plugin "IBM-Containers" en el repositorio "sample-repo":

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

Listar detalles del plug-in " IBM-Containers" en el repositorio por defecto

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

ibmcloud plugin list

Crea una lista de todos los plug-ins instalados en la CLI de IBM Cloud. Cada complemento devuelve la versión actual que está instalada, si hay una versión más reciente disponible para actualizar y si la versión del complemento instalado admite el uso de puntos finales privados.

ibmcloud plugin list

ibmcloud plugin show

Mostrar los detalles de un plugin instalado.

ibmcloud plugin show PLUGIN-NAME

ibmcloud plugin install

Instale una versión específica de un plug-in en IBM Cloud CLI desde la ruta o el repositorio especificados, o todos los plug-ins más recientes disponibles en el repositorio.

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 no se especifica ningún repositorio, el mandato utiliza el repositorio de plugins predeterminado IBM Cloud. Si está instalando un único plug-in y no se especifica ninguna versión, el comando selecciona la última versión disponible para instalar. Si se especifica la bandera '-a, --all', el comando instala todos los últimos plug-ins disponibles en el repositorio.

Opciones de mandato:

PLUGIN_PATH|PLUGIN_NAME: Si no se especifica -r REPO_NAME, el plug-in se instala desde la vía de acceso local o URL remota especificada.
-a, -- all (opcional): Instale los últimos plug-ins disponibles en el repositorio.
-r REPO_NAME (opcional): Nombre del repositorio en el que se encuentra el binario del plug-in. Si no se especifica ningún repositorio, el mandato utiliza el repositorio de plugins predeterminado IBM Cloud.
-v VERSION (opcional): Versión del plugin que se va a instalar. Acepta restricción o versión semántica específica.
-f (opcional): Forzar la instalación del plugin sin confirmación.

La CLI de IBM Cloud tiene el nombre de repositorio oficial IBM Cloud.

Ejemplos:

Instalar un plug-in desde el archivo local:

ibmcloud plugin install /downloads/new_plugin

Instalar un plug-in desde el URL remoto:

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

Instala el plugin container-service de la versión más reciente desde el repositorio de IBM Cloud:

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

o puede ejecutar:

ibmcloud plugin install container-service

Instala el plugin container-service con la versión 0.1.425 desde el repositorio oficial de plugins:

ibmcloud plugin install container-service -v 0.1.425

Instale todos los plug-ins más recientes disponibles en el repositorio oficial de plug-ins:

ibmcloud plugin install --all

Instale todos los plug-ins disponibles más recientes desde el repositorio oficial de plug-ins sin confirmación:

ibmcloud plugin install --all -f

Instale varios plug-ins al mismo tiempo:

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

descarga de plugin ibmcloud

Descargue una versión específica de un plug-in a IBM Cloud CLI desde el repositorio especificado, o todos los últimos plug-ins disponibles en el repositorio.

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 no se especifica ningún repositorio, el mandato utiliza el repositorio de plugins predeterminado IBM Cloud. Si está descargando un único plug-in y no se especifica la versión, el comando selecciona la última versión disponible para descargar. Si se especifica la bandera '-a, --all', el comando descarga todos los últimos plug-ins disponibles en el repositorio.

Opciones de mandato:

-a, -- all (opcional): Descarga todos los últimos plug-ins disponibles en el repositorio.
-r REPO_NAME (opcional): Nombre del repositorio en el que se encuentra el binario del plug-in. Si no se especifica ningún repositorio, el mandato utiliza el repositorio de plugins predeterminado IBM Cloud.
-v VERSION (opcional): Versión del plugin que se va a descargar. Acepta restricción o versión semántica específica.
-d, --dest DOWNLOAD_DIRECTORY (opcional): El directorio de destino para el plugin descargado. Si no se especifica, este es el directorio de trabajo.
-f: Fuerza la descarga del plug-in sin confirmación.

La CLI de IBM Cloud tiene el nombre de repositorio oficial IBM Cloud.

Ejemplos:

Descargue un plug-in desde el sitio remoto URL:

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

Descargue el plug-in container-service de la última versión desde el repositorio IBM Cloud :

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

o puede ejecutar:

ibmcloud plugin download container-service

Descargue el plug-in container-service con la versión 0.1.425 del repositorio oficial de plug-ins:

ibmcloud plugin download container-service -v 0.1.425

Descargue el plugin de container-service con la versión 0.1.425 desde el repositorio de plugins oficial, en el directorio ~/my_downloads :

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

Descargue los últimos plug-ins disponibles del repositorio oficial de plug-ins:

ibmcloud plugin download --all

Descargue todos los plug-ins disponibles más recientes del repositorio oficial de plug-ins sin confirmación:

ibmcloud plugin download --all -f

ibmcloud plugin update

Actualizar el plugin desde un repositorio.

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

Si no se especifica ningún repositorio, el mandato utiliza el repositorio de plugins predeterminado IBM Cloud. Si no se especifica ninguna versión, el mandato selecciona la versión disponible más reciente para instalar.

Opciones de mandato:

PLUGIN NAME: Nombre del plug-in que se debe actualizar. Si no se especifica, el mandato comprobará las actualizaciones para todos los plug-ins instalados.
-r REPO_NAME: Nombre del repositorio en el que se encuentra el binario del plug-in. Si no se especifica, el mandato utiliza el repositorio de plugins predeterminado IBM Cloud.
-v VERSION (opcional): Versión a la que se tiene que actualizar el plugin. Si no se indica, actualice el plugin a la versión más reciente.
--all: Actualizar todos los plug-ins disponibles.

Ejemplos:

Buscar todas las actualizaciones disponibles en el repositorio oficial de plugins, IBM Cloud:

ibmcloud plugin update -r "IBM Cloud"

o puede ejecutar:

ibmcloud plugin update

Actualice el plug-in container-service en el repositorio oficial de plug-ins a la versión más reciente:

ibmcloud plugin update container-service

Actualice el plug-in container-service en el repositorio oficial de plug-ins a la versión ' 0.1.440 ':

ibmcloud plugin update container-service -v 0.1.440

ibmcloud plugin uninstall

Desinstala el plug-in especificado desde la CLI de IBM Cloud.

ibmcloud plugin uninstall PLUGIN_NAME

Opciones de mandato:

PLUGIN_NAME (necesario): Nombre del plug-in que se debe desinstalar.

Ejemplos:

Desinstala el plugin 'container-service' que se ha instalado previamente:

ibmcloud plugin uninstall container-service