此页面由 Cloud Translation API 翻译。

将 Apigee Adapter for Envoy 与 Apigee Edge 搭配使用

您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。信息

此示例演示了如何将 Apigee Adapter for Envoy 与 Apigee Edge 搭配使用。

前提条件

准备工作：
按照使用入门中的说明，下载并安装 Apigee Adapter for Envoy 远程服务和 CLI。

概览

此示例说明了如何将适用于 Envoy 的 Apigee Adapter 与适用于公有云的 Apigee Edge 结合使用。API 代理调用会流经作为原生应用运行的 Envoy，并且 Edge 提供 API Apigee Remote Service for Envoy 提供的管理服务。

下图显示了 Apigee Edge 集成的基本架构：

简要说明
原生运行以与 Apigee Edge Cloud 通信的 Envoy Adapter 视图，包括
管理层面、运行时层面和 GCP 服务

Envoy 代理和远程服务正在本地运行。 Envoy 负责处理进出目标服务的 API 流量，并与远程服务通信。远程服务还会与使用 Apigee Edge Cloud 检索 API 产品和代理信息。

预配 Apigee Edge

在此步骤中，您将使用远程服务 CLI 为 Envoy 资产预配 Apigee Adapter 到 Apigee Edge。预配命令会将 API 代理部署到 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 上预配远程服务代理：
注意：系统会将命令输出重定向到配置文件，以便在后续步骤中使用。
```
./apigee-remote-service-cli provision --legacy --username $USER --password $PASSWORD \
    --organization $ORG --environment $ENV > config.yaml
```

查看 config.yaml 文件的内容。代码应如下所示：

# Configuration for apigee-remote-service-envoy
# generated by apigee-remote-service-cli provision on 2020-06-06 11:55:52
tenant:
  internal_api: https://istioservices.apigee.net/edgemicro
  remote_service_api: https://my-org-test.apigee.net/remote-service
  org_name: my-org
  env_name: test
  key: ecaa56d4101701cb877670909f3614219091b00ce559842e1b584a34b7c6a3e4
  secret: 0c66638bb865c1e13019990ea42da66b097d02a6ba333f050fb27cef20259d98

键值和密钥值用于验证来自远程服务代理的请求到 Apigee Edge。

运行 Apigee Remote Service for Envoy 服务

您可以将远程服务作为原生二进制文件运行还是在 Docker 上运行

以原生方式运行服务

使用预配命令输出的配置文件执行服务二进制文件：

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

在 Docker 上运行服务

Docker 映像与版本标记一起发布。对于此安装，请使用最新版本。有三种映像变体可供选择：

变体	映像
scratch	`google/apigee-envoy-adapter:v1.0.0`
Ubuntu	`google/apigee-envoy-adapter:v1.0.0-ubuntu`
包含 Boring Crypto 的 Ubuntu	`google/apigee-envoy-adapter:v1.0.0-boring`

例如，如需通过卷装载将暂存映像与 /config.yaml 形式提供的本地 config.yaml 一起运行，请使用以下命令：

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

安装并运行 Envoy 代理

请按照以下步骤安装并运行 Envoy 代理：

下载 Envoy 二进制文件或进行构建，或使用 Docker。
使用为 httpbin.org 服务设置的示例配置文件运行 Envoy：
```
envoy -c $REMOTE_SERVICE_HOME/samples/native/envoy-httpbin.yaml
```
注意：YAML 文件是 Envoy 配置示例该文件将 httpbin 服务设置为代理目标。如果您想配置其他目标，则需要创建自己的配置文件并修改 Apigee 运行时和集群信息。

测试安装

调用 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 密钥中的说明配置了 API 产品，则配额限制设置为每分钟 5 个请求。请尝试再调用几次 httpbin 服务以触发该配额。如果超出配额，就会看到以下错误：
```
HTTP/1.1 429 Too Many Requests
```
在 Edge 界面中访问 Apigee Analytics。转到分析 > API 指标 > API 代理性能。
生成并使用 JWT 令牌以对 API 调用进行身份验证。
使用 CLI 可以进行管理、创建令牌和控制绑定。如需了解 CLI 详情，请参阅参考文档。