虚拟网关

要使用创建虚拟网关 AWS Management Console

1. 打开 App Mesh 控制台，网址为https://console.aws.amazon.com/appmesh/。

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

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

4. 选择创建虚拟网关。

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

6. （可选，但建议使用）配置客户端策略默认值。

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

   2. （可选）在 “端口” 中，指定要强制与虚拟服务TLS通信的一个或多个端口。

   3. 对于验证方法，选择下列选项之一。您指定的证书必须已经存在且符合特定要求。有关更多信息，请参阅 证书要求。

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

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

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

   4. （可选）输入主题备用名称。要添加其他内容SANs，请选择添加SAN。SANs必须是FQDN或URI格式化。

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

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

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

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

   注意

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

   显示更多显示更少

8. 配置侦听器。

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

   2. （可选）启用连接池

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

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

      注意

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

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

      • 对于最大请求数，指定可与虚拟网关 Envoy 建立的最大并行请求数。

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

      显示更多显示更少

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

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

      • 对于 运行状况检查协议，请选择一个协议。如果您选择 grpc，则您的服务必须符合 Healt GRPCh Checking 协议。

      • 对于运行状况检查端口，指定应对其运行状况检查的端口。

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

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

      • 对于路径，指定运行状况检查请求的目标路径。仅当运行状况检查协议为 http 或 http2 时才使用此值。对于其他协议，该值将被忽略。

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

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

      显示更多显示更少

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

      • 在 “模式” 中，选择TLS要在监听器上配置的模式。

      • 对于 Certificate method，执行下列操作之一：证书必须满足具体要求。有关更多信息，请参阅 证书要求。

        • AWS Certificate Manager 托管-选择现有证书。

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

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

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

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

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

      • （可选）输入主题备用名称。要添加其他内容SANs，请选择添加SAN。SANs必须是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"
       }
   }
   

要删除虚拟网关，请使用 AWS Management Console

1. 打开 App Mesh 控制台，网址为https://console.aws.amazon.com/appmesh/。

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

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

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

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

要删除虚拟网关，请使用 AWS CLI

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

   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"
       }
   }