Incluindo e removendo plug-ins da CLI do IBM Cloud (ibmcloud plugin)

O IBM Cloud® suporta uma estrutura de plug-in para estender a sua capacidade. Use os comandos a seguir para gerenciar os plug-ins da interface da linha de comandos da IBM Cloud.

ibmcloud plugin repos

Para localizar repositórios de plug-ins que talvez queira adicionar, você pode listar todos os repositórios de plug-ins registrados em IBM Cloud CLI.

ibmcloud plugin repos

Plugin repo-add ibmcloud

Incluir um novo repositório de plug-in na CLI do IBM Cloud.

ibmcloud plugin repo-add REPO_NAME REPO_URL

Opções de comando:

REPO_NAME (necessário): O nome do repositório a ser incluído. É possível definir seu próprio nome para cada repositório.
REPO_URL (necessário): A URL do repositório a ser incluído. A URL do repositório deve conter o protocolo (por exemplo, https://plugins.cloud.ibm.com em vez de plugins.cloud.ibm.com). https://plugins.cloud.ibm.com é o repositório de plug-ins oficial da CLI da IBM Cloud.

Exemplos:

Inclua o repositório de plug-in oficial da CLI do IBM Cloud como ibmcloud-repo:

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

Plugin repo-remove ibmcloud

Remover um repositório de plug-in da CLI do IBM Cloud.

ibmcloud plugin repo-remove REPO_NAME

Opções de comando:

REPO_NAME (necessário): O nome do repositório a ser removido.

Exemplos:

Remova o repositório ibmcloud-repo da CLI do IBM Cloud:

ibmcloud plugin repo-remove ibmcloud-repo

ibmcloud plugin repo-plugins

Listar todos os plug-ins disponíveis em todos os repositórios incluídos ou em um repositório específico.

ibmcloud plugin repo-plugins [-r REPO_NAME]

Opções de comando:

-r REPO_NAME (opcional): Lista apenas os plug-ins no repositório especificado.

Exemplos:

Listar todos os plug-ins em todos os repositórios incluídos:

ibmcloud plugin repo-plugins

Liste todos os plug-ins no repositório ibmcloud-repo:

ibmcloud plugin repo-plugins -r ibmcloud-repo

Plugin ibmcloud

Mostrar os detalhes de um plug-in no repositório.

ibmcloud plugin repo-plugin PLUGIN_NAME [-r REPO_NAME]

Opções de comando:

-r REPO_NAME (opcional): O nome do repositório. Se nenhum repositório for especificado, o comando usará o repositório de plug-in padrão.

Exemplos:

Listar detalhes do plug-in "IBM-Containers" no repositório "sample-repo":

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

Listar detalhes do plug-in " IBM-Containers" no repositório padrão

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

ibmcloud plugin list

Listar todos os plug-ins instalados na CLI do IBM Cloud. Cada plug-in retorna a versão atual que está instalada, se há uma versão mais recente disponível para atualização e se a versão do plug-in instalada suporta o uso de endpoint privado.

ibmcloud plugin list

Ibmcloud plugin show

Mostrar detalhes de um plug-in instalado.

ibmcloud plugin show PLUGIN-NAME

Plugin install ibmcloud

Instale uma versão específica de um plug-in para IBM Cloud CLI a partir do caminho ou repositório especificado, ou todos os plug-ins mais recentes disponíveis no repositório.

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]

Se nenhum repositório for especificado, o comando usará o repositório de plug-in padrão IBM Cloud. Se você estiver instalando um único plug-in e nenhuma versão for especificada, o comando selecionará a versão mais recente disponível para instalação. Se o sinalizador '-a, --all' for especificado, o comando instalará todos os plug-ins mais recentes disponíveis no repositório.

Opções de comando:

PLUGIN_PATH|PLUGIN_NAME: Se -r REPO_NAME não for especificado, o plug-in será instalado a partir do caminho local ou URL remota especificada.
-a, --all (opcional): Instale todos os plug-ins mais recentes disponíveis no repositório.
-r REPO_NAME (opcional): O nome do repositório no qual o binário do plug-in está localizado. Se nenhum repositório for especificado, o comando usará o repositório de plug-in padrão IBM Cloud.
-v VERSION (opcional): A versão do plug-in a ser instalado. Aceita a versão semântica específica ou a restrição.
-f (opcional): Força a instalação do plug-in sem confirmação.

A CLI do IBM Cloud tem o nome de repositório oficial do IBM Cloud.

Exemplos:

Instalar um plug-in por meio do arquivo local:

ibmcloud plugin install /downloads/new_plugin

Instalar um plug-in por meio da URL remota:

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

Instale o plug-in container-service da versão mais recente por meio do repositório do IBM Cloud:

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

ou é possível executar:

ibmcloud plugin install container-service

Instale o plug-in container-service com a versão 0.1.425 por meio do repositório de plug-in oficial:

ibmcloud plugin install container-service -v 0.1.425

Instale todos os plug-ins mais recentes disponíveis no repositório oficial de plug-ins:

ibmcloud plugin install --all

Instale todos os plug-ins mais recentes disponíveis no repositório oficial de plug-ins sem confirmação:

ibmcloud plugin install --all -f

Instalar vários plug-ins ao mesmo tempo:

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

download do plugin ibmcloud

Faça o download de uma versão específica de um plug-in para IBM Cloud CLI do repositório especificado ou de todos os plug-ins mais recentes disponíveis no repositório.

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]

Se nenhum repositório for especificado, o comando usará o repositório de plug-in padrão IBM Cloud. Se estiver fazendo download de um único plug-in e nenhuma versão for especificada, o comando selecionará a versão mais recente disponível para download. Se o sinalizador '-a, --all' for especificado, o comando fará o download de todos os plug-ins mais recentes disponíveis no repositório.

Opções de comando:

-a, --all (opcional): Faz o download de todos os plug-ins mais recentes disponíveis no repositório.
-r REPO_NAME (opcional): O nome do repositório no qual o binário do plug-in está localizado. Se nenhum repositório for especificado, o comando usará o repositório de plug-in padrão IBM Cloud.
-v VERSION (opcional): A versão do plug-in a ser transferido por download. Aceita a versão semântica específica ou a restrição.
-d, --dest DOWNLOAD_DIRECTORY (opcional): O diretório de destino para o plug-in baixado. Se não especificado, este é o diretório de trabalho.
-f: Força o download do plug-in sem confirmação.

A CLI do IBM Cloud tem o nome de repositório oficial do IBM Cloud.

Exemplos:

Faça o download de um plug-in do site remoto URL:

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

Faça o download do plug-in container-service da versão mais recente do repositório IBM Cloud:

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

ou é possível executar:

ibmcloud plugin download container-service

Baixe o plug-in container-service com a versão 0.1.425 do repositório oficial de plug-ins:

ibmcloud plugin download container-service -v 0.1.425

Faça o download do plug-in container-service com a versão 0.1.425 a partir do repositório oficial do plug-in, no diretório ~/my_downloads:

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

Faça o download de todos os plug-ins mais recentes disponíveis no repositório oficial de plug-ins:

ibmcloud plugin download --all

Faça o download de todos os plug-ins mais recentes disponíveis no repositório oficial de plug-ins sem confirmação:

ibmcloud plugin download --all -f

ibmcloud plugin update

Fazer upgrade do plug-in por meio de um repositório.

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

Se nenhum repositório for especificado, o comando usará o repositório de plug-in padrão IBM Cloud. Se nenhuma versão for especificada, o comando selecionará a versão mais recente disponível para instalação.

Opções de comando:

PLUGIN NAME: Nome do plug-in a ser atualizado. Se não especificado, o comando verificará os upgrades de todos os plug-ins instalados.
-r REPO_NAME: O nome do repositório no qual o binário do plug-in está localizado. Se não especificado, o comando usará o repositório de plug-in padrão IBM Cloud.
-v VERSION (opcional): A versão para a qual o plug-in será atualizado. Se não fornecido, atualize o plug-in para a versão mais recente.
--all: Atualizar todos os plug-ins disponíveis.

Exemplos:

Verifique todos os upgrades disponíveis no repositório de plug-in oficial do IBM Cloud:

ibmcloud plugin update -r "IBM Cloud"

ou é possível executar:

ibmcloud plugin update

Atualize o plug-in container-service no repositório oficial de plug-ins para a versão mais recente:

ibmcloud plugin update container-service

Atualize o plug-in container-service no repositório oficial de plug-ins para a versão ' 0.1.440 ':

ibmcloud plugin update container-service -v 0.1.440

Ibmcloud plugin uninstall

Desinstalar o plug-in especificado da CLI do IBM Cloud.

ibmcloud plugin uninstall PLUGIN_NAME

Opções de comando:

PLUGIN_NAME (necessário): O nome do plug-in a ser desinstalado.

Exemplos:

Desinstalar o plug-in 'container-service' que foi instalado anteriormente:

ibmcloud plugin uninstall container-service