添加和除去 IBM Cloud CLI 插件 (ibmcloud plugin)

IBM Cloud® 支持通过插件框架来扩展其功能。使用以下命令管理 IBM Cloud 命令行界面插件。

ibmcloud plugin repos

要查找可能要添加的插件库，可以列出在 IBM Cloud CLI 中注册的所有插件库。

ibmcloud plugin repos

ibmcloud plugin repo-add

将新的插件存储库添加到 IBM Cloud CLI 中。

ibmcloud plugin repo-add REPO_NAME REPO_URL

命令选项：

REPO_NAME（必需）: 要添加的存储库的名称。可以为每个存储库定义您自己的名称。
REPO_URL（必需）: 要添加的存储库的 URL。 URL 必须包含协议（例如，用 https://plugins.cloud.ibm.com 代替 plugins.cloud.ibm.com ）。https://plugins.cloud.ibm.com 是 IBM Cloud CLI 的官方插件库。

示例：

将 IBM Cloud CLI 的官方插件存储库添加为 ibmcloud-repo：

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

ibmcloud plugin repo-remove

从 IBM Cloud CLI 中除去插件存储库。

ibmcloud plugin repo-remove REPO_NAME

命令选项：

REPO_NAME（必需）: 要除去的存储库的名称。

示例：

从 IBM Cloud CLI 中除去 ibmcloud-repo 存储库：

ibmcloud plugin repo-remove ibmcloud-repo

ibmcloud plugin repo-plugins

列出所有添加的存储库或特定存储库中的所有可用插件。

ibmcloud plugin repo-plugins [-r REPO_NAME]

命令选项：

-r REPO_NAME （可选）: 仅列出指定存储库中的插件。

示例：

列出所有添加的存储库中的所有插件：

ibmcloud plugin repo-plugins

列出 ibmcloud-repo 存储库中的所有插件：

ibmcloud plugin repo-plugins -r ibmcloud-repo

ibmcloud plugin repo-plugin

显示存储库中插件的详细信息。

ibmcloud plugin repo-plugin PLUGIN_NAME [-r REPO_NAME]

命令选项：

-r REPO_NAME （可选）: 存储库的名称。如果未指定存储库，此命令将使用缺省插件存储库。

示例：

列出存储库“sample-repo”中插件“IBM-Containers”的详细信息：

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

列出默认版本库中插件 " IBM-Containers" 的详细信息

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

ibmcloud plugin list

列出 IBM Cloud CLI 中的所有已安装插件。每个插件都会返回当前安装的版本、是否有可供更新的最新版本，以及所安装的插件版本是否支持私人端点使用。

ibmcloud plugin list

ibmcloud plugin show

显示已安装插件的详细信息。

ibmcloud plugin show PLUGIN-NAME

ibmcloud plugin install

从指定路径或存储库或存储库中的所有最新可用插件将特定版本的插件安装到 IBM Cloud CLI。

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]

如果未指定存储库，此命令将使用缺省插件存储库 IBM Cloud。如果要安装单个插件，并且未指定任何版本，那么该命令将选择要安装的最新可用版本。如果指定了 '-a, --all' 标记，命令将安装软件源中所有最新的可用插件。

命令选项：

PLUGIN_PATH | PLUGIN_NAME: 如果未指定 -r REPO_NAME，插件将从指定的本地路径或远程 URL 安装。
-a, --all （可选）: 安装软件源中所有最新的可用插件。
-r REPO_NAME （可选）: 插件二进制文件所在的存储库的名称。如果未指定存储库，此命令将使用缺省插件存储库 IBM Cloud。
-v 版本（可选）: 要安装的插件的版本。接受特定语义版本或约束。
-f（可选）: 强制安装插件而不确认。

IBM Cloud CLI 的官方存储库名称为 IBM Cloud。

示例：

从本地文件安装插件：

ibmcloud plugin install /downloads/new_plugin

从远程 URL 安装插件：

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

从 IBM Cloud 软件仓库安装最新版本的 container-service 插件：

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

或者，可以运行：

ibmcloud plugin install container-service

从官方插件库安装 container-service 插件，版本为 0.1.425：

ibmcloud plugin install container-service -v 0.1.425

从官方插件存储库安装所有最新的可用插件:

ibmcloud plugin install --all

从官方插件存储库安装所有最新的可用插件，而无需确认:

ibmcloud plugin install --all -f

同时安装多个插件:

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

ibmcloud 插件下载

从指定的存储库或存储库中的所有最新可用插件将特定版本的插件下载到 IBM Cloud CLI。

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]

如果未指定存储库，此命令将使用缺省插件存储库 IBM Cloud。如果要下载单个插件，并且未指定版本，那么该命令将选择要下载的最新可用版本。如果指定了 '-a, --all' 标志，命令将下载软件源中所有最新的可用插件。

命令选项：

-a, --all （可选）: 下载存储库中的所有最新可用插件。
-r REPO_NAME （可选）: 插件二进制文件所在的存储库的名称。如果未指定存储库，此命令将使用缺省插件存储库 IBM Cloud。
-v 版本（可选）: 要下载的插件的版本。接受特定语义版本或约束。
-d, --dest DOWNLOAD_DIRECTORY（可选）: 下载的插件的目标目录。如果未指定，那么这是工作目录。
-f: 不经确认强制下载插件。

IBM Cloud CLI 的官方存储库名称为 IBM Cloud。

示例：

从远程 URL 下载插件：

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

从 IBM Cloud 软件仓库下载最新版本的 container-service 插件：

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

或者，可以运行：

ibmcloud plugin download container-service

从官方插件库下载 container-service 插件，版本为 0.1.425：

ibmcloud plugin download container-service -v 0.1.425

将版本为 0.1.425 的 container-service 插件从官方插件存储库下载到 ~/my_downloads 目录中:

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

从官方插件存储库下载所有最新的可用插件:

ibmcloud plugin download --all

从官方插件存储库下载所有最新的可用插件，无需确认:

ibmcloud plugin download --all -f

ibmcloud plugin update

从存储库升级插件。

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

如果未指定存储库，此命令将使用缺省插件存储库 IBM Cloud。如果未指定版本，此命令将选择可用的最新版本进行安装。

命令选项：

PLUGIN NAME: 要更新的插件的名称。如果未指定，此命令将检查安装的所有插件的升级。
-r REPO_NAME: 插件二进制文件所在的存储库的名称。如果未指定，此命令将使用缺省插件存储库 IBM Cloud。
-v 版本（可选）: 要更新到的插件版本。如果未提供，那么将插件更新到最新版本。
--all: 更新所有可用插件。

示例：

检查官方插件存储库 IBM Cloud 中所有可用的升级：

ibmcloud plugin update -r "IBM Cloud"

或者，可以运行：

ibmcloud plugin update

将官方插件库中的插件 container-service 升级到最新版本：

ibmcloud plugin update container-service

更新官方插件库中的插件 container-service 至版本 ' 0.1.440 '：

ibmcloud plugin update container-service -v 0.1.440

ibmcloud plugin uninstall

从 IBM Cloud CLI 中卸载指定的插件。

ibmcloud plugin uninstall PLUGIN_NAME

命令选项：

PLUGIN_NAME（必需）: 要卸载的插件的名称。

示例：

卸载先前安装的“container-service”插件：

ibmcloud plugin uninstall container-service