准备工作

如果需要使用 32 位版本，或 IBM Cloud Dedicated 环境中最新版本以外的旧版本，请参阅 IBM Cloud CLI 版本。

使用安装程序进行安装

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

1. 使用浏览器访问正式的 ibm-cloud-cli-releases GitHub 存储库，并选择操作系统的安装程序以开始下载。 支持以下操作系统：macOS X 64 位、Windows™ 64 位、Linux™ x86 64 位和 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™ PowerShell 5 终端控制台并运行：

  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 自动完成。

   • 将 {YOUR_DIRECTORY}/IBM_CLOUD_CLI 添加到 PATH 环境变量。
   • 有关 shell 自动完成支持（仅限 Mac 和 Linux™ ），请参阅 为 IBM Cloud CLI 启用 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 Cloud CLI 新版本的通知，请订阅 IBM Cloud CLI 版本库。