设置 CLI

安装、更新和删除所需的命令行工具（CLI），并配置环境以使用 IBM Cloud® Code Engine。

Code Engine CLI 支持的环境

Code Engine 命令行界面支持以下环境：

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

安装 IBM Cloud 命令行工具

安装最新版本的 IBM Cloud 命令行工具（CLI）。

准备工作

您必须注册一个 IBM Cloud 账户。

  1. 下载并安装 IBM Cloud CLI。

    此安装包包含以下文件：

    • IBM Cloud Object Storage 插件
    • IBM Cloud Container Registry 插件
    • IBM Cloud Kubernetes Service 插件

    如需了解更多信息，请参阅 IBM Cloud CLI。

  2. 登录到 IBM Cloud CLI。

    ibmcloud login

  3. 如果您有多个帐户，系统会提示您选择要使用的帐户。 请按照提示操作，或使用 target 命令来选择您的 IBM Cloud 账户。

    ibmcloud target -c <account_id>

  4. 您还必须指定区域。 您可以使用 target 命令来定位或更改区域。

    ibmcloud target -r <region>

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

    ibmcloud resource groups

    示例输出

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

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

    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”的错误信息。

  1. 安装 Code Engine 插件。

    ibmcloud plugin install code-engine

  2. 使用 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.
[...]

  3. 要运行 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，以便充分利用新功能。

  1. 运行 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

  2. 如果有可用更新，请运行 ibmcloud plugin update 命令。

    ibmcloud plugin update code-engine

卸载 CLI

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

  1. 列出已安装的插件。

    ibmcloud plugin list

  2. 卸载这些插件。 例如，要卸载 Code Engine 命令行插件：

    ibmcloud plugin uninstall code-engine

  3. 通过运行以下命令并检查已安装的插件的列表，验证插件是否已卸载。

    ibmcloud plugin list

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

在网页浏览器中访问 IBM Cloud Shell

借助 IBM® Cloud Shell，您可以直接在网页浏览器中使用 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。