步驟 8：將封存檔案推送至實際工作環境

本頁適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

在這個步驟中，您會將 API Proxy 設定的封存檔升級至 Apigee 機構的正式版環境。

1. 請按照「建立環境」一文中的步驟操作，執行下列操作：
   1. 在 Apigee 機構中建立新的prod 環境，並啟用Archive 做為部署類型。使用使用者介面或API。

      例如：

      

   2. 使用執行個體附件 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. 使用環境群組附加 API，將新環境附加至環境群組。

      將環境連結至群組後，該環境中的 Proxy 就能透過群組中的主機名稱進行路由。這會觸發長時間執行的作業，可能需要幾分鐘才能完成。建議您稍候一兩分鐘，再繼續進行下一個步驟。在此期間，您可以如先前一樣查看作業狀態。

2. 在本機開發環境中建立新的prod 環境：
   1. 在 VS Code 中的 Apigee 中，將游標移至 Apigee 部分的「environments」資料夾，然後按一下 。

      

      系統會開啟「建立環境」精靈。

   2. 輸入環境名稱「prod」，然後按下 Enter 鍵。

      環境已建立。

   3. 展開 Apigee 部分中的 prod 環境資料夾，即可查看內容。
   4. 將滑鼠游標移至 Apigee 部分的 deployments.json 檔案，然後按一下 。

      系統會開啟「部署」精靈。

   5. 選取「helloworld」API 代理程式，將其新增至部署作業，然後按一下「OK」。

      系統會在編輯器中開啟 deployments.json 檔案。檔案已更新，在 proxies 部署陣列中加入 helloworld API Proxy，如下所示：

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }

3. 將 API Proxy 設定的封存檔部署至 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 實際工作環境！