第 8 步：将归档升级为正式版

本页面适用于 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 文档。

在此步骤中，您将把 API 代理配置的归档提升到 Apigee 组织中的生产环境。

按照创建环境中的步骤执行以下操作：
1. 在 Apigee 组织中创建新的生产环境，并启用归档作为部署类型。使用界面或 API。
  例如：
2. 使用 Instances attachment API 将环境连接到运行时实例。
  此命令会触发长时间运行的操作。在继续操作之前，请确保环境已连接到运行时。
3. 使用 Create environment groups API 创建环境组（如果您还没有环境组）。
  在继续操作之前，请确保已创建环境组。您可以使用如下请求来检查新组的状态：
```
curl -i -H "$AUTH" -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
```
4. 使用 Environment Group Attachment API 将新环境连接到环境组。
  将环境连接到组会使该环境中的代理可通过组中的主机名路由。这会触发长时间运行的操作，可能需要几分钟才能完成。建议您等待一两分钟，然后再继续下一步。在此期间，您可以像之前一样检查操作的状态。

在本地开发环境中创建一个新的生产环境：
1. 在 Apigee in VS Code 中，将光标放在 Apigee 部分中的 environments 文件夹上，然后点击。
  
  此时会打开 Create environment 向导。
2. 输入 prod 作为环境名称，然后按 Enter 键。
  环境创建完成。
3. 展开 Apigee 部分中的 prod 环境文件夹以查看其内容。
4. 将光标放在 Apigee 部分中的 deployments.json 文件上，然后点击。
  此时 Deployments 向导会打开。
5. 选择 helloworld API 代理以将其添加到部署中，然后点击 OK。
  deployments.json 文件会在编辑器中打开。此文件已更新，proxies 部署数组中包含 helloworld API 代理，如下所示：
```
{
  "proxies": [
     "helloworld"
  ],
  "sharedflows": []
}
```

将 API 代理配置的归档部署到 Apigee 组织中的 prod 环境。

在 Apigee VS Code 的 Terminal 标签页中，导航到 myapigeeworkspace 目录。
```
cd myapigeeworkspace
```

运行以下命令：

gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

以下提供了一个响应示例：

Using Apigee organization dev
Waiting for operation [$OPERATION_ID] to complete...⠹

运行以下命令来检查操作的状态，将 $OPERATION_ID 替换为在上一个调用中返回的操作 ID：

gcloud beta apigee operations describe $OPERATION_ID

以下提供了一个响应示例。请注意，state 设置为 IN_PROGRESS。

Using Apigee organization 'prod'
done: true
metadata:
  '@type': type.googleapis.com/google.cloud.apigee.v1.OperationMetadata
  operationType: INSERT
  state: IN_PROGRESS
  targetResourceName: uri
name: organizations/prod/operations/$OPERATION_ID
organization: prod
response:
  '@type': type.googleapis.com/google.cloud.apigee.v1.CanaryEvaluation
  control: 1-5-0-20210319-071117-ghq74
  endTime: '2021-03-20T06:15:44.329363950Z'
  metricLabels:
    env: test
    location: us-central1
  name: uri
  startTime: '2021-03-20T06:14:44.306534584Z'
  treatment: 1-5-0-20210319-190954-if0wk
  verdict: NONE
uuid: $OPERATION_ID

重复上一步，直到 state 设置为 FINISHED，表示归档部署已完成。

运行以下命令来查看 prod 环境中的所有归档部署：

gcloud beta apigee archives list --environment=prod

以下提供了一个响应示例：

Using Apigee organization 'prod'
ARCHIVE ID                        ENVIRONMENT   DEPLOYED AT           LABELS            OPERATION STATUS
vrytwbhso558oil53m                prod          2021-04-20 21:20:53   release=052021.1  Deployed

恭喜！您已成功将 API 归档文件提升至 Apigee 生产环境！