新增及移除 IBM Cloud CLI 外掛程式 (ibmcloud 外掛程式)

IBM Cloud® 支援可延伸其功能的外掛程式架構。使用下列指令管理 IBM Cloud Command Line Interface 外掛程式。

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下載目錄（可選）: 所下載外掛程式的目的地目錄。如果未指定，則這是工作目錄。
-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