AWS App Mesh 入门 - Amazon ECS
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS App Mesh 入门

重要

App Mesh 在此区域内不受支持。

本主题将帮助您配合使用 AWS App Mesh 和在 上运行的实际服务。

场景

为了说明如何配合使用 App Mesh,假定您有一个具有以下特征的应用程序:

  • 包括两个名为 serviceAserviceB 的服务。

  • 这两个服务均注册到名为 apps.local 的命名空间。

  • ServiceA 通过 HTTP/2 和端口 80 与 serviceB 通信。

  • 您已部署 serviceB 的第二个版本,并采用名称 serviceBv2apps.local 命名空间中注册了该服务。

您的要求如下:

  • 您希望将 75% 的流量从 serviceA 发送到 serviceB,并将 25% 的流量发送到 serviceBv2,以确保在将 100% 的流量从 serviceA 发送到 serviceBv2 之前,该服务没有错误。

  • 您希望能够轻松调整流量权重,以便一旦证明 serviceBv2 可靠便可将 100% 的流量发送到该服务。将所有流量发送到 serviceBv2 后,您希望弃用 serviceB

  • 您不希望必须更改实际服务的任何现有应用程序代码或服务发现注册,才能满足以前的要求。

为了满足您的要求,您决定创建包含虚拟服务、虚拟节点、虚拟路由器和路由的 App Mesh 服务网格。实现网格后,为 更新,以便让您的服务使用 Envoy 代理。更新后,您的服务将通过 Envoy 代理相互通信,而不是直接相互通信。

先决条件

App Mesh 支持已注册到 DNS 和/或 AWS Cloud Map 的 Linux 服务。要使用此入门指南,我们建议您提供三个已注册到 DNS 的现有服务。即使服务不存在,您也可以创建服务网格及其资源,但是在部署实际服务之前,您无法使用网格。

剩余步骤假定实际服务命名为 serviceAserviceBserviceBv2,并且可以在名为 apps.local 的命名空间中发现所有服务。

步骤 1:创建网格和虚拟服务

服务网格是一种用于驻留在其内的服务之间的网络流量的逻辑边界。有关更多信息,请参阅 中的服务网格。虚拟服务是实际服务的抽象。有关更多信息,请参阅 中的虚拟服务

创建以下资源:

  • 名为 apps 的网格,因为此场景中的所有服务均注册到 apps.local 命名空间。

  • 名为 serviceb.apps.local 的虚拟服务,因为虚拟服务表示可以使用该名称发现的服务,并且您不希望更改代码以引用其他名称。稍后的步骤中将添加名为 servicea.apps.local 的虚拟服务。

您可以使用 AWS 管理控制台或 AWS CLI 1.18.16 版或更高版本完成以下步骤。如果使用 AWS CLI,请使用 aws --version 命令检查已安装的 AWS CLI 版本。如果您没有安装 1.18.16 版或更高版本,则必须安装或更新 AWS CLI。选择要使用的工具所对应的选项卡。

AWS 管理控制台
  1. 打开 App Mesh 控制台首次运行向导,网址为 https://console.aws.amazon.com/appmesh/get-started

  2. 对于 Mesh name (网格名称),输入 apps

  3. 对于 Virtual service name (虚拟服务名称),输入 serviceb.apps.local

  4. 要继续,请选择 Next

AWS CLI
  1. 使用 create-mesh 命令创建网格。

    aws appmesh create-mesh --mesh-name apps
  2. 使用 create-virtual-service 命令创建虚拟服务。

    aws appmesh create-virtual-service --mesh-name apps --virtual-service-name serviceb.apps.local --spec {}

步骤 2:创建虚拟节点

虚拟节点充当实际服务的逻辑指针。有关更多信息,请参阅 中的虚拟节点

创建名为 serviceB 的虚拟节点,因为某个虚拟节点表示名为 serviceB 的实际服务。可使用主机名 serviceb.apps.local,通过 DNS 发现虚拟节点所表示的实际服务。或者,也可以使用 AWS Cloud Map 发现实际服务。虚拟节点将采用 HTTP/2 协议在端口 80 上侦听流量。此外,还支持其他协议和运行状况检查。您将在后面的步骤中为 serviceBv2serviceA 创建虚拟节点。

AWS 管理控制台
  1. 对于 Virtual node name (虚拟节点名称),输入 serviceB

  2. 对于 Service discovery method (服务发现方法),选择 DNS,并为 DNS hostname (DNS 主机名) 输入 serviceb.apps.local

  3. Listener (侦听器) 下,为 Port (端口) 输入 80,并为 Protocol (协议) 选择 http2

  4. 要继续,请选择 Next

AWS CLI
  1. 使用以下内容创建名为 create-virtual-node-serviceb.json 的文件:

    { "meshName": "apps", "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http2" } } ], "serviceDiscovery": { "dns": { "hostname": "serviceB.apps.local" } } }, "virtualNodeName": "serviceB" }
  2. 采用 JSON 文件作为输入,使用 create-virtual-node 命令创建虚拟节点。

    aws appmesh create-virtual-node --cli-input-json file://create-virtual-node-serviceb.json

步骤 3:创建虚拟路由器和路由

虚拟路由器路由网格中一个或多个虚拟服务的流量。有关更多信息,请参阅 中的虚拟路由器路由

创建以下资源:

  • 名为 serviceB 的虚拟路由器,因为 serviceB.apps.local 虚拟服务不会启动与任何其他服务的出站通信。请记住,您之前创建的虚拟服务是实际 serviceb.apps.local 服务的抽象。虚拟服务将流量发送到虚拟路由器。虚拟路由器将采用 HTTP/2 协议在端口 80 上侦听流量。此外,还支持其他协议。

  • 名为 serviceB 的路由。它将 100% 的流量路由到 serviceB 虚拟节点。添加 serviceBv2 虚拟节点后,您将在稍后的步骤中更改权重。虽然本指南中未作介绍,但您可以为路由添加额外的筛选条件,并添加重试策略,从而使 Envoy 代理在遇到通信问题时会多次尝试将流量发送到虚拟节点。

AWS 管理控制台
  1. 对于 Virtual router name (虚拟路由器名称),输入 serviceB

  2. Listener (侦听器) 下,为 Port (端口) 指定 80,并为 Protocol (协议) 选择 http2

  3. 对于 Route name (路由名称),输入 serviceB

  4. 对于 Route type (路由类型),选择 http2

  5. 对于 Virtual node name (虚拟节点名称),选择 serviceB,并为 Weight (权重) 输入 100

  6. 要继续,请选择 Next

AWS CLI
  1. 创建虚拟路由器。

    1. 使用以下内容创建名为 create-virtual-router.json 的文件:

      { "meshName": "apps", "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http2" } } ] }, "virtualRouterName": "serviceB" }
    2. 采用 JSON 文件作为输入,使用 create-virtual-router 命令创建虚拟路由器。

      aws appmesh create-virtual-router --cli-input-json file://create-virtual-router.json
  2. 创建路由。

    1. 使用以下内容创建名为 create-route.json 的文件:

      { "meshName" : "apps", "routeName" : "serviceB", "spec" : { "httpRoute" : { "action" : { "weightedTargets" : [ { "virtualNode" : "serviceB", "weight" : 100 } ] }, "match" : { "prefix" : "/" } } }, "virtualRouterName" : "serviceB" }
    2. 采用 JSON 文件作为输入,使用 create-route 命令创建路由。

      aws appmesh create-route --cli-input-json file://create-route.json

步骤 4:审核并创建

根据之前的说明审核设置。

AWS 管理控制台

如果需要对任何部分进行任何更改,可选择 Edit。对设置感到满意后,选择 Create mesh service

AWS CLI

使用 describe-mesh 命令查看所创建网格的设置。

aws appmesh describe-mesh --mesh-name apps

使用 describe-virtual-service 命令查看所创建的虚拟服务的设置。

aws appmesh describe-virtual-service --mesh-name apps --virtual-service-name serviceb.apps.local

使用 describe-virtual-node 命令查看所创建的虚拟节点的设置。

aws appmesh describe-virtual-node --mesh-name apps --virtual-node-name serviceB

使用 describe-virtual-router 命令查看所创建的虚拟路由器的设置。

aws appmesh describe-virtual-router --mesh-name apps --virtual-router-name serviceB

使用 describe-route 命令查看所创建路由的设置。

aws appmesh describe-route --mesh-name apps \ --virtual-router-name serviceB --route-name serviceB

步骤 5:创建其他资源

要完成此场景,您需要执行以下操作:

  • 创建名为 serviceBv2 的虚拟节点,以及名为 serviceA 的虚拟节点。这两个虚拟节点均通过 HTTP/2 和端口 80 侦听请求。对于 serviceA 虚拟节点,配置 serviceb.apps.local 的后端,因为来自 serviceA 虚拟节点的所有出站流量都会发送到名为 serviceb.apps.local 的虚拟服务。虽然本指南中未作介绍,但您还可以为虚拟节点指定用于写入访问日志的文件路径。

  • 另外创建一个名为 servicea.apps.local 的虚拟服务,该虚拟服务将所有流量直接发送到 serviceA 虚拟节点。

  • 更新在上一步中创建的 serviceB 路由,以将 75% 的流量发送到 serviceB 虚拟节点,将 25% 的流量发送到 serviceBv2 虚拟节点。随着时间的推移,您可以继续修改权重,直到 serviceBv2 收到 100% 的流量。将所有流量发送到 serviceBv2 后,您可以弃用 serviceB 虚拟节点和实际服务。在更改权重时,不需要对代码进行任何修改,因为 serviceb.apps.local 虚拟服务名称和实际服务名称没有改变。回想一下,serviceb.apps.local 虚拟服务将流量发送到虚拟路由器,该路由器将流量路由到虚拟节点。虚拟节点的服务发现名称可以随时更改。

AWS 管理控制台
  1. 在左侧导航窗格中,选择 Meshes (网格)

  2. 选择在上一步中创建的 apps 网格。

  3. 在左侧导航窗格中,选择 Virtual nodes (虚拟节点)

  4. 选择 Create virtual node

  5. Virtual node name (虚拟节点名称) 输入 serviceBv2,为 Service discovery method (服务发现方法) 选择 DNS,为 DNS hostname (DNS 主机名) 输入 servicebv2.apps.local

  6. 对于 Listener (侦听器),为 Port (端口) 输入 80,并为 Protocol (协议) 选择 http2

  7. 选择 Create virtual node

  8. 再次选择 Create virtual node,然后为 Virtual node name (虚拟节点名称) 输入 serviceA,为 Service discovery method (服务发现方法) 选择 DNS,为 DNS hostname (DNS 主机名) 输入 servicea.apps.local

  9. 展开 Additional configuration (其他配置)

  10. Select Add backend.输入 serviceb.apps.local

  11. Port (端口) 输入 80,为 Protocol (协议) 选择 http2,然后选择 Create virtual node

  12. 在左侧导航窗格中,选择 Virtual routers (虚拟路由器),然后从列表中选择 serviceB 虚拟路由器。

  13. Routes (路由) 下,选择在上一步中创建的名为 ServiceB 的路由,然后选择 Edit

  14. Virtual node name (虚拟节点名称) 下,将 serviceBWeight (权重) 值更改为 75

  15. 选择 Add target,从下拉列表中选择 serviceBv2,然后将 Weight (权重) 值设置为 25

  16. 选择 Save

  17. 在左侧导航窗格中,选择 Virtual services (虚拟服务),然后选择 Create virtual service

  18. Virtual service name (虚拟服务名称) 输入 servicea.apps.local,为 Provider (提供方) 选择 Virtual node,为 Virtual node (虚拟节点) 选择 serviceA,然后选择 Create virtual service.

AWS CLI
  1. 创建 serviceBv2 虚拟节点。

    1. 使用以下内容创建名为 create-virtual-node-servicebv2.json 的文件:

      { "meshName": "apps", "spec": { "listeners": [ { "portMapping": { "port": 80, "protocol": "http2" } } ], "serviceDiscovery": { "dns": { "hostname": "serviceBv2.apps.local" } } }, "virtualNodeName": "serviceBv2" }
    2. 创建虚拟节点。

      aws appmesh create-virtual-node --cli-input-json file://create-virtual-node-servicebv2.json
  2. 创建 serviceA 虚拟节点。

    1. 使用以下内容创建名为 create-virtual-node-servicea.json 的文件:

      { "meshName" : "apps", "spec" : { "backends" : [ { "virtualService" : { "virtualServiceName" : "serviceb.apps.local" } } ], "listeners" : [ { "portMapping" : { "port" : 80, "protocol" : "http2" } } ], "serviceDiscovery" : { "dns" : { "hostname" : "servicea.apps.local" } } }, "virtualNodeName" : "serviceA" }
    2. 创建虚拟节点。

      aws appmesh create-virtual-node --cli-input-json file://create-virtual-node-servicea.json
  3. 更新在上一步中创建的 serviceb.apps.local 虚拟服务,以将其流量发送到 serviceB 虚拟路由器。最初创建虚拟服务时,它不会向任何位置发送流量,因为 serviceB 虚拟路由器尚未创建。

    1. 使用以下内容创建名为 update-virtual-service.json 的文件:

      { "meshName" : "apps", "spec" : { "provider" : { "virtualRouter" : { "virtualRouterName" : "serviceB" } } }, "virtualServiceName" : "serviceb.apps.local" }
    2. 使用 update-virtual-service 命令更新虚拟服务。

      aws appmesh update-virtual-service --cli-input-json file://update-virtual-service.json
  4. 更新在上一步中创建的 serviceB 路径。

    1. 使用以下内容创建名为 update-route.json 的文件:

      { "meshName" : "apps", "routeName" : "serviceB", "spec" : { "http2Route" : { "action" : { "weightedTargets" : [ { "virtualNode" : "serviceB", "weight" : 75 }, { "virtualNode" : "serviceBv2", "weight" : 25 } ] }, "match" : { "prefix" : "/" } } }, "virtualRouterName" : "serviceB" }
    2. 使用 update-route 命令更新路由。

      aws appmesh update-route --cli-input-json file://update-route.json
  5. 创建 serviceA 虚拟服务。

    1. 使用以下内容创建名为 create-virtual-servicea.json 的文件:

      { "meshName" : "apps", "spec" : { "provider" : { "virtualNode" : { "virtualNodeName" : "serviceA" } } }, "virtualServiceName" : "servicea.apps.local" }
    2. 创建虚拟服务。

      aws appmesh create-virtual-service --cli-input-json file://create-virtual-servicea.json

网格摘要

在创建服务网格之前,您具有三个名为 servicea.apps.localserviceb.apps.localservicebv2.apps.local 的实际服务。除实际服务之外,现在您还具有一个服务网格,其中包含用以表示实际服务的以下资源:

  • 两个虚拟服务。代理通过虚拟路由器将所有流量从 servicea.apps.local 虚拟服务发送到 serviceb.apps.local 虚拟服务。

  • 三个名为 serviceAserviceBserviceBv2 的虚拟节点。Envoy 代理使用为虚拟节点配置的服务发现信息来查找实际服务的 IP 地址。

  • 一个虚拟路由器,其路由指示 Envoy 代理将 75% 的入站流量路由到 serviceB 虚拟节点,将 25% 的流量路由到 serviceBv2 虚拟节点。

步骤 6:更新服务

创建网格后,您需要完成以下任务:

  • 授予随每个 部署的 Envoy 代理读取一个或多个虚拟节点配置的权限。有关如何向代理授权的更多信息,请参阅代理授权

  • 更新每个现有 ,以使用 Envoy 代理。