IBM Cloud Docs
安装独立 IBM Cloud CLI

安装独立 IBM Cloud CLI

IBM Cloud® 命令行界面提供用于管理 IBM Cloud中的资源的命令。 当您安装独立的 IBM Cloud CLI 时,您只会获得 CLI 本身,而不会获得任何推荐的插件或工具。

如果要安装最新的 IBM Cloud CLI 以及用于为 IBM Cloud开发应用程序的其他建议插件和工具,请参阅 IBM Cloud CLI 入门使用插件扩展 IBM Cloud CLI

准备工作

如果需要使用 32 位版本,或“IBM Cloud专用环境下最新版本之外的旧版本,请参见”IBM Cloud语言命令行发布

使用安装程序进行安装

要安装最新的独立 IBM Cloud CLI,请使用以下步骤:

  1. 使用浏览器访问正式的 ibm-cloud-cli-releases GitHub 存储库,并选择操作系统的安装程序以开始下载。 支持以下操作系统:macOSX 64 位、Windows™ 64 位、Linux™ x8664 位和Linux™LE 64 位ppc64le)。

  2. 运行安装程序:

    • 对于 Mac 和 Windows™,请运行安装程序。
    • 对于Linux™,解压缩软件包并运行 "install 脚本。
  3. 登录到 IBM Cloud:

    ibmcloud login
    

    现在,您可以开始管理 IBM Cloud 资源。 输入 ibmcloud help 以查看命令描述。

    如果使用的是联合标识,请使用一次性密码或 API 密钥进行登录

通过 shell 进行安装

要通过 shell 手动为操作系统安装最新的 CLI,请使用适用于您操作系统的以下命令:

如果因为可能会使用 root 权限而不想从 shell 安装,可以 下载并运行安装程序

  • 对于 Mac,将以下命令复制并粘贴到终端,然后运行该命令:

    curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
    
  • 对于 Linux™,复制并粘贴以下命令到终端并运行:

    curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
    
  • 对于 Windows™,将以下命令复制并粘贴到 Windows™PowerShell5终端控制台并运行:

    iex (New-Object Net.WebClient).DownloadString('https://clis.cloud.ibm.com/install/powershell')
    

    如果遇到 The underlying connection was closed: An unexpected error occurred on a send 这样的错误,请确保您安装了 .Net Framework 4.5 或更高版本。 还要尝试通过运行以下命令来启用 TLS 1.2 协议:

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    

安装到定制目录

使用安装程序或 shell 脚本安装 IBM Cloud CLI 时,会将其安装在系统目录中。 如果要指定其他目录,请使用以下步骤。

如果将 IBM Cloud CLI 安装到定制目录,那么无法使用 ibmcloud update 命令来更新 CLI。

  1. 使用浏览器访问正式的 ibm-cloud-cli-releases GitHub 存储库,并选择与您的平台匹配的二进制文件以开始下载。 支持以下平台:macOS、linux32、linux64、ppc64le、win32 和 win64。

  2. 将包解压缩到指定的目录。

    您可以看到以下解压缩的内容:

    适用于Linux™和 Mac:

    IBM_Cloud_CLI
    ├── LICENSE
    ├── NOTICE
    ├── autocomplete
    │   ├── bash_autocomplete
    │   └── zsh_autocomplete
    ├── ibmcloud
    └── ibmcloud-analytics
    

    对于 Windows™:

    IBM_Cloud_CLI
    ├── LICENSE
    ├── NOTICE
    ├── ibmcloud-analytics.exe
    └── ibmcloud.exe
    
  3. 添加到 PATH 环境变量并启用 shell 自动完成。

更新 IBM Cloud CLI

使用最新版本的 CLI。 如果使用的不是最新版本,请运行以下命令来更新 CLI:

ibmcloud update

要确定 IBM Cloud CLI 版本,请运行以下命令:

ibmcloud -v

如果运行的是当前发行版,那么将显示以下输出:

Checking for updates...
No update required. Your CLI is already up-to-date.

要获得有关“IBM CloudCLI 新版本的通知,请订阅”IBM CloudCLI 版本库