Ampliando a CLI do IBM Cloud com plug-ins

A interface da linha de comandos da IBM Cloud® suporta uma estrutura de plug-in para estender sua capacidade. Instale um plug-in de um repositório, de um URL ou instale um binário de plug-in localmente.

Para obter mais comandos para gerenciar plug-ins, execute ibmcloud plugin para ver as mensagens de ajuda. Para obter mais informações, consulte Incluindo e removendo plug-ins da CLI do IBM Cloud..

Antes de Iniciar

Instale a CLI IBM Cloud independente para que seja possível instalar plug-ins da CLI para IBM Cloud.

Procurando um plug-in

Use o comando ibmcloud plugin repo-plugins para descobrir todos os plug-ins disponíveis no repositório..

ibmcloud plugin repo-plugins

Status             Name                                        Versions                       Description   
Update Available   container-service/kubernetes-service        0.3.49, 0.3.47, 0.3.34...      IBM Cloud Kubernetes Service for management of Kubernetes clusters   
Update Available   cloud-functions                             1.0.32, 1.0.30, 1.0.29...      Manage Cloud Functions
...

Instalando um plug-in por meio do repositório da CLI do IBM Cloud

Instalando um plug-in específico

Use o comando ibmcloud plugin install PLUGIN_NAME para instalar um plug-in específico. Por exemplo, use o comando a seguir para instalar o plug-in da CLI do IBM Cloud Code Engine:

ibmcloud plugin install code-engine

Looking up 'code-engine' from repository 'IBM Cloud'...
Plug-in 'code-engine 1.23.2' found in repository 'IBM Cloud'
Attempting to download the binary file...
 54.29 MiB / 54.29 MiB [============================================] 100.00% 10s
56929376  bytes downloaded
Installing binary...
OK
Plug-in 'code-engine 1.23.2' was successfully installed into /Users/username/.bluemix/plugins/code-engine. Use 'ibmcloud plugin show code-engine' to show its details.

Instalando todos os plug-ins

Use o comando plugin install -a para instalar todos os plug-ins mais recentes disponíveis no repositório:

ibmcloud plugin install -a

Instalando vários plug-ins

Use o comando plugin install PLUGIN_NAME@VERSION para instalar vários plug-ins ao mesmo tempo Por exemplo, use o comando a seguir para instalar os plug-ins container-service@1.0.506 e secrets-manager@0.1.25:

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

Para obter mais informações, consulte ibmcloud plugin install.

Confirmando Plug-ins Instalados

Use o comando plugin list para confirmar que todos os plug-ins necessários estão instalados na CLI do IBM Cloud. O comando plugin list retorna as informações a seguir para cada plug-in instalado:

O nome do plug-in
A versão atual do plug-in
Se uma versão mais recente do plug-in está disponível
Se a versão do plug-in suporta o uso de endpoints privados

ibmcloud plugin list

Atualizando plug-ins instalados

Use o comando plugin update para atualizar os plug-ins instalados na CLI do IBM Cloud. O comando plugin update retorna as informações a seguir para cada plug-in instalado:

A versão atual do plug-in
A versão mais recente do plug-in que está disponível

ibmcloud plugin update

Informações relacionadas

Também é possível instalar um plug-in a partir de uma URL, fazer download de um plug-in ou instalar um binário de plug-in localmente:

Para instalar um plug-in localmente ou de uma URL, consulte ibmcloud plugin install.
Para fazer download de um plug-in, consulte Como fazer download de um plug-in?