本頁面由 Cloud Translation API 翻譯而成。

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

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

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

請按照「建立環境」一文中的步驟操作，執行下列動作：
1. 在 Apigee 機構中建立新的 prod 環境，並啟用「封存」做為部署類型。使用使用者介面或 API。
2. 使用執行個體附件 API，將環境附加至執行階段執行個體。
  這項指令會觸發長時間執行的作業。請先確認環境已附加至執行階段，再繼續操作。
3. 如果沒有環境群組，請使用「建立環境群組 API」建立。
  請先確認已建立環境群組，再繼續操作。您可以使用類似下列的請求，查看新群組的狀態：
```
curl -i -H "$AUTH" -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
```
4. 使用環境群組連結 API，將新環境連結至環境群組。
  將環境附加至群組後，該環境中的 Proxy 即可透過群組中的主機名稱進行路由。這會觸發長時間執行的作業，可能需要幾分鐘才能完成。建議等待一到兩分鐘，再繼續下一個步驟。在此期間，您仍可照常查看作業狀態。

在本機開發環境中建立新的 prod 環境：
1. 在 VS Code 的 Apigee 檢視畫面中，將游標懸停在「environments」資料夾上，然後按一下。
  
  系統會開啟「建立環境」精靈。
2. 輸入環境名稱 prod，然後按下 Enter 鍵。
  環境已建立。
3. 展開 Apigee 部分的 prod 環境資料夾，即可查看內容。
4. 將游標移到 Apigee 部分的 deployments.json 檔案上，然後按一下。
  「Deployments」(部署作業) 精靈隨即開啟。
5. 選取「helloworld」API Proxy，將其新增至部署作業，然後按一下「OK」。
  系統會在編輯器中開啟 deployments.json 檔案。檔案已更新，在 proxies 部署陣列中加入 helloworld API 代理，如下所示：
```
{
  "proxies": [
     "helloworld"
  ],
  "sharedflows": []
}
```

將 API Proxy 設定的封存檔部署至 Apigee 機構的 prod 環境。

在 Apigee VS Code 的「終端機」分頁中，前往「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 正式環境！

步驟 8：將封存檔案推送至實際工作環境 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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