Code Engine CLI 入门

您可以使用 IBM Cloud® Code Engine API来创建和管理您的 Code Engine 实体。

配置 CLI 环境

要使用 CLI 来创建和管理 Code Engine 实体，请设置 CLI 环境。请确保已安装最新版本的 IBM Cloud 命令行工具（CLI）。

准备工作

下载并安装 IBM Cloud CLI。

登录到 IBM Cloud CLI。

登录到 IBM Cloud CLI。

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

```txt {: pre}
    ibmcloud target -c <account_id>
    ```
3. 指定区域。 使用 **`target`** 命令来定位或更改区域。

```txt {: pre}
    ibmcloud target -r <region>
    ```
4. 指定资源组。 要获取资源组的列表，请运行以下命令。

```txt {: pre}
    ibmcloud resource groups
    ```
    示例输出

    ```txt {: screen}
    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
    ```
5. 通过运行以下命令将资源组设定为目标。

```txt {: pre}
    ibmcloud target -g <resource_group>
    ```
    示例输出

    ```txt {: screen}
    Targeted resource group default
    ```

安装 Code Engine CLI 插件。
```
ibmcloud plugin install code-engine
```
请确认已安装 Code Engine 命令行界面（CLI）插件。您可以使用 ibmcloud code-engine version 命令或 ibmcloud plugin list 命令来确认插件已安装。
```
ibmcloud code-engine version
```
示例输出
```
OK
version:  v1.54.2
commit:   e4800be63b1077563bdbaee9e656ce1f81c3e08d
```
运行 ibmcloud ce help 命令以查看 Code Engine CLI 的命令。例如，
```
ibmcloud ce help
```

使用 Code Engine CLI

现在，Code Engine CLI 环境已设置完毕，您已准备好使用 Code Engine 资源，例如应用程序，函数或使用 CLI 的作业。

必须先在项目上下文中工作，然后才能使用 Code Engine 资源。

项目是由 Code Engine 中的各类实体（如应用程序、函数、作业、机队和构建）组成的集合。项目基于 Kubernetes 名称空间。项目的名称在 IBM Cloud® 资源组，用户帐户和区域中必须唯一。项目用于管理资源并提供对其实体的访问权限。

一个项目提供以下功能：

用于实体名称的唯一命名空间。
对项目资源的外部访问进行管理。
对后端服务、注册表和存储库的出站访问进行管理。
运输层服务（ TLS ）的自动生成证书。

有关 Code Engine 项目的更多信息，请参阅管理项目。

使用 project create 命令创建项目。使用对您所在区域唯一的项目名称。
```
ibmcloud ce project create --name PROJECT_NAME
```
示例输出
```
Creating project 'myproject'...
OK
```

使用 project get 命令查看有关项目的详细信息。

ibmcloud ce project get --name PROJECT_NAME

示例输出

Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500
Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

或者，可以使用 project list 命令来显示已创建项目的列表。

要使用 CLI 处理项目，必须选择该项目作为当前上下文。除非指定 --no-select 选项，否则项目在创建时将自动选择为当前上下文。要选择当前未成为目标的项目，请使用 project select 命令。

有关使用项目的更多信息，请参阅管理项目。

后续步骤

现在，您已设置 CLI 环境，并且已执行第一步以确保您正在 Code Engine 项目的上下文中工作，您可以使用 Code Engine CLI 来处理应用程序，函数和作业。

要开始使用 CLI 来使用 Code Engine 组件，请参阅以下主题。

有关 Code Engine CLI 的更多信息，请参阅设置 CLI 环境。

有关在 Code Engine CLI 环境中工作的更多信息，请参阅 Code Engine CLI 命令参考文档。

有关每个 CLI 版本的更改摘要，请参阅 CLI 版本历史记录。请务必保持 CLI 版本最新，以便能够使用所有可用的命令及其选项。