设置 CLI

安装，更新和删除所需的 CLI ，并设置环境以使用 IBM Cloud® Code Engine。

Code Engine CLI 支持的环境

Code Engine CLI 支持以下环境:

Linux 64 位
Linux 64 位 ARM
Linux 32 位
Mac OS X 64 位
Mac OS X M1/ARM
Windows 64 位
Windows 32 位

安装 IBM Cloud CLI

安装最新版本的 IBM Cloud CLI。

准备工作

必须创建 IBM Cloud 帐户。

下载并安装 IBM Cloud CLI。

此安装包含以下文件:
- IBM Cloud Functions 插件
- IBM Cloud Object Storage 插件
- IBM Cloud Container Registry 插件
- IBM Cloud Kubernetes Service 插件
有关更多信息，请参阅 IBM Cloud CLI。
登录到 IBM Cloud CLI。
```
ibmcloud login
```
如果您有多个帐户，系统会提示您选择要使用的帐户。遵循提示或使用 target 命令来选择 IBM Cloud 帐户。
```
ibmcloud target -c <account_id>
```
您还必须指定区域。您可以使用 target 命令将区域作为目标或更改区域。
```
ibmcloud target -r <region>
```

必须指定资源组。要获取资源组的列表，请运行以下命令。

ibmcloud resource groups

示例输出

Retrieving all resource groups under account <account_name> as email@ibm.com...
OK
Name      ID                                 Default Group   State   
default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE

通过运行以下命令将资源组设定为目标。

ibmcloud target -g <resource_group>

示例输出

Targeted resource group default

安装 Code Engine CLI 插件

安装最新版本的 Code Engine CLI。

请确保已安装最新版本的 IBM Cloud CLI。否则， Code Engine CLI 安装可能会失败，并显示类似 Could not find compatible binary to install for plug-in code-engine的消息。

安装 Code Engine 插件。
```
ibmcloud plugin install code-engine
```

使用 ibmcloud plugin show code-engine 命令来验证是否已安装该插件。

ibmcloud plugin show code-engine

示例输出

Plugin Name                              code-engine[ce]
Plugin Version                           1.31.0
Plugin SDK Version                       0.9.0
Minimal IBM Cloud CLI version required   1.0.0
Private endpoints supported              true

Commands:
code-engine,ce                    Manage Code Engine components.
[...]

要运行 Code Engine 命令，请使用 ibmcloud code-engine 或 ibmcloud ce。要查看您可以使用 Code Engine 插件执行的所有操作，请运行 ibmcloud ce 而不使用任何参数。
```
ibmcloud ce
```

(可选) 您可以安装 jq 软件包。许多 Code Engine 命令包含用于创建 JSON 输出的选项 (--output JSON)。通过此包，您可以从命令行查看和解析 JSON 响应。

有关 Code Engine 命令的更多信息，请参阅 ibmcloud ce 命令。

更新 Code Engine CLI

定期更新 CLI 以利用新功能。

通过运行 ibmcloud plugin list 命令来查看当前插件列表。

ibmcloud plugin list

示例输出

Listing installed plug-ins...

Plugin Name                                  Version   Status             Private endpoints supported
code-engine[ce]                              1.31.0                       true
container-registry                           0.1.571                      true
container-service[kubernetes-service]        1.0.408                      false

如果更新可用，请运行 ibmcloud plugin update 命令。
```
ibmcloud plugin update code-engine
```

卸载 CLI

如果不再需要 CLI，可以将其卸载。

列出已安装的插件。
```
ibmcloud plugin list
```
卸载插件。例如，要卸载 Code Engine CLI 插件:
```
ibmcloud plugin uninstall code-engine
```
通过运行以下命令并检查已安装的插件的列表，验证插件是否已卸载。
```
ibmcloud plugin list
```

您删除的插件不会显示在结果中。

在 Web 浏览器中访问 IBM Cloud Shell

通过 IBM® Cloud Shell，您可以直接从 Web 浏览器使用 IBM Cloud CLI 和其他 CLI 插件。

IBM Cloud Shell 已启用多个插件和工具，包括基本 IBM Cloud CLI (ibmcloud) 和 Code Engine CLI。

使用 Cloud Shell时，请记住以下限制。

您最多可以打开五个并行会话，这些会话独立运行，以便您可以一次处理不同的资源，区域和帐户。
本地下载和编辑的任何文件 (例如 YAML 文件) 都会临时存储在 Cloud Shell 中，并且不会在会话之间持久存储。
Cloud Shell 具有限制一周内 50 小时的使用配额。

要启动并使用 IBM Cloud Shell，请在 IBM Cloud 控制台菜单栏中，单击 Cloud Shell 图标 IBM Cloud Shell 图标。会话将使用当前帐户凭证启动并自动将您登录到 IBM Cloud CLI。