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

步驟 7：部署至 Apigee 環境

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

查看 Apigee Edge 說明文件。

使用 VS Code 中的 Apigee 完成本機開發和測試後，您就可以將 API 以封存檔形式部署至 Apigee 環境。在這個步驟中，您將建立支援封存檔案部署作業的 Apigee 環境，並將 API Proxy 設定的封存檔案部署至 Apigee 環境。

事前準備：按照「開始使用 gcloud 搭配 Apigee」一文所述，安裝 Google Cloud SDK 和 gcloud beta apigee 元件。

請按照「建立環境」一文中的步驟操作，執行下列動作：
1. 在 Apigee 機構中建立新的 dev 環境，並啟用「封存」做為部署類型。使用使用者介面或 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 即可透過群組中的主機名稱進行路由。這會觸發長時間執行的作業，可能需要幾分鐘才能完成。建議等待一到兩分鐘，再繼續下一個步驟。在此期間，您仍可照常查看作業狀態。
將 API Proxy 設定的封存檔案部署至 Apigee 環境。
1. 在 Apigee VS Code 的「終端機」分頁中，前往「myapigeeworkspace」目錄。
```
cd myapigeeworkspace
```
  執行 ls 時，目錄應包含 src 資料夾。
2. 執行下列指令：
```
gcloud beta apigee archives deploy --environment=dev --labels=release=052021
```
  以下是回應範例：
```
Using Apigee organization dev
Waiting for operation [b64c2665-b5ac-43cc-9e2d-232e8895c2ed] to complete...done
```
在「Terminal」(終端機)分頁中執行下列指令，測試 API：
```
curl https://INTERNAL_LOAD_BALANCER_IP/helloworld /
  -H "Host: ENV_GROUP_HOSTNAME" 
```
如要進一步瞭解這個範例中的變數，以及如何設定 API 存取權，請參閱「部署範例 Proxy」。

系統會顯示下列錯誤訊息：
```
{"fault":{"faultstring":"Failed to resolve API Key variable request.queryparam.apikey",
  "detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}
```
您必須建立包含 helloworld API 的 API 產品，然後建立並註冊開發人員和 API 產品，才能取得 API 金鑰。

取得 API 金鑰。

使用 Apigee UI 建立 API 產品：

前往「API 產品」頁面：
在 Google Cloud 控制台中，前往「發布」>「API 產品」頁面。

前往 API 產品
點選「+ 建立」。
輸入 API 產品的產品詳細資料。

在欄位中輸入下列資訊：

欄位	設定
`Name:`	myproduct
`Display name:`	myproduct
`Environment:`	dev
`Access:`	公開
`Quota:`	留空
`Allowed OAuth scope:`	留空

在「Operations」部分，點選「+ Add an Operation」。
在「來源」下方，從「API Proxy」下拉式選單中選取「helloworld」。
在「Operation」(作業) 下方的「Path」(路徑) 欄位中，輸入 /。
其他欄位則保留預設值。
按一下「儲存」儲存作業。
按一下「儲存」，儲存 API 產品。

在機構中建立開發人員：

在 Google Cloud 控制台中，前往「發布」>「開發人員」頁面。

前往「開發人員」
點選「+ 建立」。

在欄位中輸入下列資訊：

欄位	設定
`First Name:`	Alex
`Last Name:`	Hamilton
`Username:`	ahamilton
`Email:`	ahamilton@example.com

按一下「新增」。

註冊應用程式：

開啟應用程式編輯器。
1. 在 Google Cloud 控制台，前往「Distribution」>「Apps」頁面。
  
  前往「應用程式」
2. 點選「+ 建立」。

在欄位中輸入下列資訊：

欄位	設定
`Name:`	myapp
`Display name:`	myapp
`Developer:`	ahamilton@example.com
`Callback URL:`	留空
`Notes:`	留空
`Expiry:`	從未使用
`Product:`	按一下「新增產品」。選取「myproduct」。按一下「新增」。
`Custom attributes:`	留空

點選「建立」。

複製 API 金鑰。
1. 在 Google Cloud 控制台，前往「Distribution」>「Apps」頁面。
  
  前往「應用程式」
2. 按一下「myapp」。
3. 在「憑證」部分中，按一下「金鑰」旁邊的「顯示」。
4. 按一下「複製」。

再次執行 curl 呼叫，並使用 apikey 查詢參數傳遞 API 金鑰，如下所示：

curl -v https://$PUBLIC_FACING_IP/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

系統會傳回以下回應：

{
  "root": {
    "city": "San Jose",
    "firstName": "John",
    "lastName": "Doe",
    "state": "CA"
  }
}

恭喜！您已成功將 API 封存檔案部署至 Apigee 環境！

在下一個步驟中，您會將 API 封存檔案推送至 Apigee 實際工作環境。

1 2 3 4 5 6 7 (NEXT) Step 8: Promote an archive to production

步驟 7：部署至 Apigee 環境 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

步驟 7：部署至 Apigee 環境