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

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

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

查看 Apigee Edge 說明文件。

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

請按照「建立環境」一文中的步驟操作，執行下列動作：
1. 在 Apigee 機構中建立新的 prod 環境，並啟用「封存」做為部署類型。使用 UI 或 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. 使用 Environment group attachment API，將新環境附加至環境群組。
  將環境附加至群組後，該環境中的 Proxy 即可透過群組中的主機名稱進行路由。這會觸發長時間執行的作業，可能需要幾分鐘才能完成。建議您稍候片刻，再繼續下一個步驟。在此期間，您仍可照常查看作業狀態。

在本地開發環境中建立新的 prod 環境：
1. 在 VS Code 的 Apigee 中，將游標放在「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 的「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 正式環境！

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

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