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

本页面适用于 ApigeeApigee Hybrid

查看 Apigee Edge 文档。

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

  1. 按照创建环境中的步骤执行以下操作:
    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 将新环境连接到环境组。

      将环境连接到组会使该环境中的代理可通过组中的主机名路由。 这会触发长时间运行的操作,可能需要几分钟才能完成。建议您等待一两分钟,然后再继续下一步。在此期间,您可以像之前一样检查操作的状态。

  2. 在本地开发环境中创建一个新的生产环境:
    1. 在 Apigee in VS Code 中,将光标放在 Apigee 部分中的 environments 文件夹上,然后点击 “创建”图标

      将光标放在 environments 文件夹上时显示 +

      此时会打开 Create environment 向导。

    2. 输入 prod 作为环境名称,然后按 Enter 键。

      环境创建完成。

    3. 展开 Apigee 部分中的 prod 环境文件夹以查看其内容。
    4. 将光标放在 Apigee 部分中的 deployments.json 文件上,然后点击 “配置”图标

      此时 Deployments 向导会打开。

    5. 选择 helloworld API 代理以将其添加到部署中,然后点击 helloworld

      deployments.json 文件会在编辑器中打开。此文件已更新,proxies 部署数组中包含 helloworld API 代理,如下所示:

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }
  3. 将 API 代理配置的归档部署到 Apigee 组织中的 prod 环境。
    1. 在 Apigee VS Code 的 Terminal 标签页中,导航到 myapigeeworkspace 目录。
      cd myapigeeworkspace
    2. 运行以下命令:
      gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

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

      Using Apigee organization dev
      Waiting for operation [$OPERATION_ID] to complete...⠹
    3. 运行以下命令来检查操作的状态,将 $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
    4. 重复上一步,直到 state 设置为 FINISHED,表示归档部署已完成。
    5. 运行以下命令来查看 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 生产环境!