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

搭配 Apigee Edge 使用 Envoy 適用的 Apigee 轉接程式

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。資訊

這個範例說明如何搭配使用 Apigee Adapter for Envoy 與 Apigee Edge。

必要條件

事前準備：
下載並安裝適用於 Envoy 遠端服務和 CLI 的 Apigee Adapter 如開始使用中所述。

總覽

本範例說明如何搭配使用 Apigee Adapter for Envoy 搭配公用雲端的 Apigee Edge。API (應用程式介面) Proxy 呼叫流經 Envoy 為原生應用程式，透過 Edge 提供 API 執行支援 Envoy 的 Apigee Remote Service。

下圖顯示 Apigee Edge 整合功能的基本架構：

原生執行 Envoy 轉接器與 Apigee Edge Cloud 通訊的概略說明，包括管理層、執行階段層和 GCP 服務

Envoy Proxy 和遠端服務在本機執行。 Envoy 會處理往返目標服務的 API 流量，並與遠端服務進行通訊。遠端服務也會與 Apigee Edge Cloud 通訊，擷取 API 產品和 Proxy 資訊。

設定 Apigee Edge

在這個步驟中，您將使用遠端服務 CLI 為 Envoy 資產提供 Apigee 轉接器，以便將其佈建至 Apigee Edge。這項佈建指令會將 API Proxy 部署至 Apigee Edge，並在 Apigee 上設定憑證，然後產生遠端服務會用來從您的系統安全地連線至 Apigee 的憑證。

前往 $CLI_HOME 目錄：
```
cd $CLI_HOME
```

建立下列環境變數。這些變數會用做佈建指令碼的參數：

export ORG=organization_name
export ENV=environment_name
export USER=your_apigee_username
export PASSWORD=your_apigee_password

其中：

變數	說明
`organization_name`	Apigee 機構的名稱。
`environment_name`	貴機構中環境的名稱。
`your_apigee_username`	您的 Apigee 帳戶使用者名稱。使用者名稱通常是電子郵件地址。
`your_apigee_password`	Apigee 密碼。

執行下列指令，在 Apigee Edge 上佈建遠端服務 Proxy：

./apigee-remote-service-cli provision --legacy --mfa $MFA --username $USER --password $PASSWORD \
    --organization $ORG --environment $ENV > config.yaml

檢查 config.yaml 檔案的內容。內容應如下所示：

# Configuration for apigee-remote-service-envoy (platform: SaaS)
# generated by apigee-remote-service-cli provision on 2020-08-26 09:43:41
apiVersion: v1
kind: ConfigMap
metadata:
  name: apigee-remote-service-envoy
  namespace: apigee
data:
  config.yaml: |
    tenant:
      internal_api: https://istioservices.apigee.net/edgemicro
      remote_service_api: https://my-username-test.apigee.net/remote-service
      org_name: my-org
      env_name: my-env
      key: f7e09c32f827cab87b8ce43842ed8467ffd2c58e6f795241e38fe7b1aec7664
      secret: 1cb5cca00dfb433cb80b32837451fce4bf694633cddbb73d704517e12b35e75

金鑰和密鑰值會用於驗證從遠端服務 Proxy 傳送至 Apigee Edge 的要求。

為 Envoy 服務執行 Apigee 遠端服務

您可以以原生二進位檔或 Docker 執行遠端服務。

原生執行服務

使用佈建指令輸出的設定檔執行服務二進位檔：

$CLI_HOME/apigee-remote-service-envoy -c config_file_path/config.yaml

在 Docker 上執行服務

Docker 映像檔以發布標記的形式發布。請使用最新版本進行安裝。有有三種圖片變化版本可供選擇：

內容多變	圖片
Google distroless	`gcr.io/distroless/base`
Ubuntu	`google/apigee-envoy-adapter:v1.1.0-ubuntu`
Ubuntu 搭配 Boring Crypto	`google/apigee-envoy-adapter:v1.1.0-boring`

舉例來說，如要透過掛載的磁碟機執行此映像檔，並使用本機 config.yaml 做為 /config.yaml，請使用下列指令：

docker run -v ./config.yaml:/config.yaml google/apigee-envoy-adapter:v1.1.0

注意： Docker 映像檔會以非超級使用者的身分執行。確定取得 config.yaml 檔案的讀取權限。

建立設定檔範例

使用 apigee-remote-service-cli samples create 指令產生範例設定檔。

在本例中，您需要以下產生的檔案：

envoy-config.yaml：HTTP 服務的部署設定。

如要產生樣本，請按照下列步驟操作：

前往 $CLI_HOME 目錄。
執行以下指令產生檔案：
```
./apigee-remote-service-cli samples create --template native -c ./config.yaml
```
注意： 根據預設，指令會使用 Istio 1.6 範本針對 Istio 1.7，請指定 --template istio-1.7 旗標

以下檔案會輸出至 ./samples 目錄：
```
ls samples
envoy-config.yaml
```

詳情請參閱「樣本指令」。

安裝並執行 Envoy Proxy

請按照下列步驟安裝及執行 Envoy Proxy：

下載 Envoy 二進位檔或建構，或使用 Docker。
使用您先前為 httpbin.org 服務產生的範例設定檔執行 Envoy：
```
envoy -c $CLI_HOME/samples/envoy-config.yaml
```
注意：如要為其他服務進行設定，請使用範例指令，並將 CLI。

測試安裝結果

呼叫 httpbin 服務：

curl -i http://localhost:8080/httpbin/headers

這項服務目前是由 Apigee 管理，而且您未提供 API 金鑰。呼叫會傳回下列錯誤。

curl -i http://localhost:8080/httpbin/headers
HTTP/1.1 403 Forbidden
date: Tue, 12 May 2020 17:51:36 GMT
server: envoy
content-length: 0
x-envoy-upstream-service-time: 11

設定 API 產品並取得 API 金鑰，方法如下：如何取得 API 金鑰。

使用金鑰發出 API 呼叫：

export APIKEY=YOUR_API_KEY
curl -i http://localhost:8080/httpbin/headers -H "x-api-key: $APIKEY"

呼叫應該會成功並顯示 200 狀態，並在回應中傳回標頭清單。例如：

curl -i httpbin.default.svc.cluster.local/headers -H "x-api-key: kyOTalNNLMPfOSy6rnVeclmVSL6pA2zS"
HTTP/1.1 200 OK
server: envoy
date: Tue, 12 May 2020 17:55:34 GMT
content-type: application/json
content-length: 828
access-control-allow-origin: *
access-control-allow-credentials: true
x-envoy-upstream-service-time: 301

{
  "headers": {
    "Accept": "*/*",
    "Content-Length": "0",
    "Host": "httpbin.default.svc.cluster.local",
    "User-Agent": "curl/7.70.0-DEV",
    "X-Api-Key": "kyOTalNNLMPfOSy6rneclmVSL6pA2zS",
    "X-Apigee-Accesstoken": "",
    "X-Apigee-Api": "httpbin.default.svc.cluster.local",
    "X-Apigee-Apiproducts": "httpbin",
    "X-Apigee-Application": "httpbin",
    "X-Apigee-Authorized": "true",
    "X-Apigee-Clientid": "kyOTalNNLMPfOSy6rVeclmVSL6pA2zS",
    "X-Apigee-Developeremail": "user@example.com",
    "X-Apigee-Environment": "test",
    "X-Apigee-Organization": "my-org",
    "X-Apigee-Scope": "",
    "X-B3-Parentspanid": "1476f9a2329bbdfa",
    "X-B3-Sampled": "0",
    "X-B3-Spanid": "1ad5c19bfb4bc96f",
    "X-B3-Traceid": "6f329a34e8ca07811476f9a2329bbdfa"
  }
}

後續步驟

傳送至 httpbin 服務的 API 流量現在是由 Apigee 管理。以下以下提供一些可探索和嘗試的功能：

如果您已按照如何取得 API 金鑰、配額限制設定為每分鐘 5 次要求。請再試著呼叫 httpbin 服務幾次，以觸發配額。配額用盡時，系統會傳回 HTTP 狀態 403 錯誤。
在 Edge UI 中存取 Apigee 數據分析。依序前往「Analyze」>「API Metrics」>「API Proxy Performance」。
產生並使用 JWT 權杖來驗證 API 呼叫。
使用 CLI 管理、建立符記，以及控制繫結。如需 CLI 詳細資料，請參閱參考資料。