虚拟网关

使用创建虚拟网关Amazon Web Services Management Console

1. 通过 https://console.aws.amazon.com/appmesh/ 打开 App Mesh 控制台。

2. 选择要在其中创建虚拟网关的网关。列出了您拥有和与您共享的所有网格。

3. 在左侧导航栏中选择虚拟网关。

4. 选择创建虚拟网关。

5. 对于虚拟网关名称，为您的虚拟网关输入名称。

6. （可选，但推荐）配置客户端策略默认值。

   1. （可选）如果您希望网关仅使用传输层安全 (TLS) 与虚拟服务通信，请选择强制执行 TLS。

   2. （可选）对于端口，指定一个或多个要强制与虚拟服务进行 TLS 通信的端口。

   3. 对于 Conflict method（验证方法），选择下列选项之一。您指定的证书必须已存在并满足特定要求。有关更多信息，请参阅 证书要求：

      • Amazon Private Certificate Authority托管 — 选择一个或多个现有证书。

      • E@@ nvoy Secret Discovery Service (SDS) 托管 — 输入 Envoy 使用秘密发现服务获取的密钥的名称。

      • 本地文件托管-指定部署 Envoy 的文件系统上证书链文件的路径。

   4. （可选）输入主题 Subjec t（主题）。要添加其他 SAN，请选择添加 SAN。SAN 必须采用 FQDN 或 URI 格式。

   5. （可选）选择提供客户端证书和以下选项之一，以便在服务器请求客户端证书时提供客户端证书并启用双向 TLS 身份验证。要了解有关双向 TLS 的更多信息，请参阅 App Mesh 双向 TLS 身份验证文档。

      • E@@ nvoy Secret Discovery Service (SDS) 托管 — 输入 Envoy 使用秘密发现服务获取的密钥的名称。

      • 本地文件托管-在部署 Envoy 的文件系统上指定证书链文件的路径以及私钥。有关使用对本地文件 end-to-end 进行加密的示例应用程序部署网格的完整演示，请参阅上的 “使用文件提供的 TLS 证书配置 TLS” GitHub。

7. （可选）要配置日志，请选择日志。输入你希望 Envoy 使用的 HTTP 访问日志路径。我们建议使用该/dev/stdout路径，以便您可以使用 Docker 日志驱动程序将 Envoy 日志导出到 Amazon Lo CloudWatch gs 等服务。

   注意

   日志必须仍由您应用程序中的代理进行接收并发送至目标。此文件路径仅指示 Envoy 要发送日志的位置。

   显示更多显示更少

8. 配置监听器。

   1. 选择协议并指定 Envoy 侦听流量的端口。http 侦听器允许连接过渡到 websockets。您可以单击 “添加监听器” 来添加多个监听器。“删除” 按钮将删除该监听器。

   2. （可选）启用连接池

      连接池限制了虚拟网关 Envoy 可同时建立的连接数。它旨在保护您的 Envoy 实例免受连接不堪重负，并允许您调整流量调整以适应应用程序的需求。

      您可以为虚拟网关侦听器配置目标端连接池设置。默认情况下，App Mesh 将客户端连接池设置设置设置为无限，从而简化了网格配置。

      注意

      connectionPool和connectionPool portMapping 协议必须相同。如果您的侦听器协议为grpc或http2，则maxRequests仅指定。如果您的侦听器协议是http，则可以同时指定maxConnections和maxPendingRequests。

      • 对于最大连接数，指定最大出站连接数。

      • 对于最大请求数，指定可使用虚拟网关某个 Envoy 创建的最大parallel 请求数。

      • （可选）对于最大待处理请求数，指定 Envoy 排队的最大连接数之后的溢出请求数。默认值为 2147483647。

      显示更多显示更少

   3. （可选）如果要为侦听器配置运行状况检查，请选择启用运行状况检查。

      运行状况检查策略是可选的，但如果您为Health 策略指定任何值，则必须为Health 阈值、运行状况检查间隔、运行状况检查协议、超时期限和不健康阈值指定值。

      • 对于 Health 检查协议，选择一个协议。如果选择 grpc，您的服务必须符合 GRPC Health 检查协议。

      • 对于 Health check port (运行状况检查端口)，指定应对其运行状况检查的端口。

      • 对于 Healthy threshold (正常阈值)，指定在声明侦听器运行状况良好之前必须出现的连续成功的运行状况检查次数。

      • 对于 Health check interval (运行状况检查间隔)，指定执行每次运行状况检查间隔的时间（毫秒）。

      • 对于 Path (路径)，指定运行状况检查请求的目标路径。此值仅在Healt h 检查协议为http或时使用http2。其他协议将忽略此值。

      • 对于 Tmethoy（超时时间），以毫秒为单位指定接收来自运行状况检查的响应时要等待的时间。

      • 对于 Unhealthy threshold (不正常阈值)，指定在声明侦听器运行状况不正常之前必须出现的连续失败的运行状况检查次数。

      显示更多显示更少

   4. （可选）如果要指定客户端是否使用 TLS 与该虚拟网关通信，请选择启用 TLS 终止。

      • 对于模式，选择要在侦听器上配置 TLS 的模式。

      • 对于 Conflict method（证书方法），选择下列选项之一。证书必须满足特定要求。有关更多信息，请参阅 证书要求：

        • Amazon Certificate Manager托管 — 选择现有证书。

        • E@@ nvoy Secret Discovery Service (SDS) 托管 — 输入 Envoy 使用秘密发现服务获取的密钥的名称。

        • 本地文件托管-指定部署了 Envo y 的文件系统上的证书链和私钥文件的路径。

      • （可选）选择 “需要客户端证书” 和以下选项之一，以便在客户端提供证书时启用双向 TLS 身份验证。要了解有关双向 TLS 的更多信息，请参阅 App Mesh 双向 TLS 身份验证文档。

        • E@@ nvoy Secret Discovery Service (SDS) 托管 — 输入 Envoy 使用秘密发现服务获取的密钥的名称。

        • 本地文件托管-指定部署 Envoy 的文件系统上证书链文件的路径。

      • （可选）输入主题 Subjec t（主题）。要添加其他 SAN，请选择添加 SAN。SAN 必须采用 FQDN 或 URI 格式。

      显示更多显示更少

9. 选择创建虚拟网关完成操作。

1. aws appmesh create-virtual-gateway \ 
   --mesh-name meshName \ 
   --virtual-gateway-name virtualGatewayName \ 
   --cli-input-json file://create-virtual-gateway.json

2. 示例 create-virtual-gateway .json 的内容：

   {
       "spec": {
         "listeners": [
           {
             "portMapping": {
               "port": 9080,
               "protocol": "http"
             }
           }
         ]
       }
   }

3. 输出示例：

   {
       "virtualGateway": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName",
               "createdAt": "2022-04-06T10:42:42.015000-05:00",
               "lastUpdatedAt": "2022-04-06T10:42:42.015000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "123456789012",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 1
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 9080,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "ACTIVE"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }
   

使用删除虚拟网关Amazon Web Services Management Console

1. 通过 https://console.aws.amazon.com/appmesh/ 打开 App Mesh 控制台。

2. 选择要从中删除虚拟网关的网关。列出了您拥有和与您共享的所有网格。

3. 在左侧导航栏中选择虚拟网关。

4. 选择要删除的虚拟网关，然后选择 Delete（删除）。如果虚拟网关有任何关联的网关路由，则无法将其删除。必须先删除所有关联的网关路由。您只能删除您的账户被列为资源所有者的虚拟网关。

5. 在确认框中，键入，delete然后选择 “删除”。

使用删除虚拟网关Amazon CLI

1. 使用以下命令删除您的虚拟网关（用您自己的值替换红色值）：

   aws appmesh delete-virtual-gateway \
        --mesh-name meshName \
        --virtual-gateway-name virtualGatewayName

2. 输出示例：

   {
       "virtualGateway": {
           "meshName": "meshName",
           "metadata": {
               "arn": "arn:aws:appmesh:us-west-2:123456789012:mesh/meshName/virtualGateway/virtualGatewayName",
               "createdAt": "2022-04-06T10:42:42.015000-05:00",
               "lastUpdatedAt": "2022-04-07T10:57:22.638000-05:00",
               "meshOwner": "123456789012",
               "resourceOwner": "123456789012",
               "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
               "version": 2
           },
           "spec": {
               "listeners": [
                   {
                       "portMapping": {
                           "port": 9080,
                           "protocol": "http"
                       }
                   }
               ]
           },
           "status": {
               "status": "DELETED"
           },
           "virtualGatewayName": "virtualGatewayName"
       }
   }