本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS App Mesh 和 Amazon ECS 入門
**重要**
支援終止通知：在 2026 年 9 月 30 日， AWS 將停止對 的支援 AWS App Mesh。2026 年 9 月 30 日之後，您將無法再存取 AWS App Mesh 主控台或 AWS App Mesh 資源。如需詳細資訊，請參閱此部落格文章[從 遷移 AWS App Mesh 至 Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)。
本主題可協助您將 AWS App Mesh 與在 Amazon ECS 上執行的實際服務搭配使用。本教學課程涵蓋數種 App Mesh 資源類型的基本功能。
## 案例
若要說明如何使用 App Mesh，請假設您擁有具有下列特性的應用程式：
+ 包含兩個名為 `serviceA`和 的服務`serviceB`。
+ 這兩個服務都註冊到名稱為 `apps.local` 的命名空間。
+ `ServiceA` 與 `serviceB` 透過 HTTP/2，連接埠 80 進行通訊。
+ 您已部署 `serviceB` 第 2 版，並在 `apps.local` 命名空間中將其註冊為名稱 `serviceBv2`。
您有以下要求：
+ 您想要將 75% 的流量從 `serviceA` 傳送到 ，`serviceB`並將 25% 的流量傳送到 `serviceBv2` 。透過僅將 25% 傳送到 `serviceBv2`，您可以在從 傳送 100% 的流量之前驗證其是否沒有錯誤`serviceA`。
+ 您希望能夠輕鬆地調整流量權重，以便證實流量可靠之後，能夠 100% 流入 `serviceBv2`。將所有流量傳送到 後`serviceBv2`，您想要停止 `serviceB`。
+ 您不想變更實際服務的任何現有應用程式碼或服務探索註冊，以符合先前的要求。
為了滿足您的需求，您決定建立具有虛擬服務、虛擬節點、虛擬路由器和路由的 App Mesh 服務網格。實作網格後，您會更新您的服務以使用 Envoy 代理。一旦更新，您的服務會透過 Envoy 代理彼此通訊，而非直接相互通訊。
## 先決條件
**重要**
支援終止通知：在 2026 年 9 月 30 日， AWS 將停止對 的支援 AWS App Mesh。2026 年 9 月 30 日之後，您將無法再存取 AWS App Mesh 主控台或 AWS App Mesh 資源。如需詳細資訊，請參閱此部落格文章[從 遷移 AWS App Mesh 至 Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)。
+ 對 App Mesh 概念的現有了解。如需詳細資訊，請參閱[什麼是 AWS App Mesh？](what-is-app-mesh.md)。
+ 對 Amazon ECSs概念的現有理解。如需詳細資訊，請參閱《[Amazon Elastic Container Service 開發人員指南》中的什麼是 Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html)。
+ App Mesh 支援向 DNS AWS Cloud Map或兩者註冊的 Linux 服務。若要使用此入門指南，建議您擁有三個已向 DNS 註冊的現有服務。本主題中的程序假設現有服務名為 `serviceA`、 和 `serviceB`，`serviceBv2`並且所有服務都可以透過名為 的命名空間探索`apps.local`。
即使服務不存在，您也可以建立服務網格及其資源，但在部署實際服務之前，您無法使用網格。如需 Amazon ECS 上服務探索的詳細資訊，請參閱[服務探索](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html)。若要使用服務探索建立 Amazon ECS 服務，請參閱[教學課程：使用服務探索建立服務](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-service-discovery.html)。如果您還沒有執行中的服務，則可以[使用服務探索建立 Amazon ECS 服務](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-service-discovery.html)。
## 步驟 1：建立網格和虛擬服務
服務網格是在它之內各服務之間網路流量的邏輯邊界。如需詳細資訊，請參閱[服務網格](meshes.md)。虛擬服務是實際服務的抽象化。如需詳細資訊，請參閱[虛擬服務](virtual_services.md)。
建立下列資源：
+ 名稱為 `apps` 的網格，因為案例中的所有服務皆註冊到 `apps.local` 命名空間。
+ 名稱為 `serviceb.apps.local` 的虛擬服務，因為虛擬服務代表可使用該名稱探索的服務，而且您不想將程式碼變更為參照其他名稱。稍後的步驟會新增名稱為 `servicea.apps.local` 的虛擬服務。
您可以使用 AWS 管理主控台 或 1.18.116 AWS CLI 版或更新版本，或 2.0.38 版或更新版本來完成下列步驟。如果使用 AWS CLI，請使用 `aws --version`命令來檢查已安裝的 AWS CLI 版本。如果您沒有安裝 1.18.116 或更新版本或 2.0.38 或更新版本，則必須[安裝或更新 AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/appmesh/cli-chap-install.html)。為您要使用的工具選取索引標籤。
------
#### [ AWS 管理主控台 ]
1. 在 https：//[https://console.aws.amazon.com/appmesh/get-started](https://console.aws.amazon.com/appmesh/get-started) 開啟 App Mesh 主控台初次執行精靈。
1. 對於 **Mesh name (網格名稱)**，輸入 **apps**。
1. 對於 **Virtual service name (虛擬服務名稱)**，輸入 **serviceb.apps.local**。
1. 若要繼續，請選擇 **Next (下一步)**。
------
#### [ AWS CLI ]
1. 使用 `[create-mesh](https://docs.aws.amazon.com/cli/latest/reference/appmesh/create-mesh.html)` 命令建立網格。
```
aws appmesh create-mesh --mesh-name apps
```
1. 使用 `[create-virtual-service](https://docs.aws.amazon.com/cli/latest/reference/appmesh/create-virtual-service.html)` 命令建立虛擬服務。
```
aws appmesh create-virtual-service --mesh-name apps --virtual-service-name serviceb.apps.local --spec {}
```
------
## 步驟 2：建立虛擬節點
虛擬節點可做為實際服務的邏輯指標。如需詳細資訊，請參閱[虛擬節點](virtual_nodes.md)。
建立名稱為 `serviceB` 的虛擬節點，因為其中一個虛擬節點代表名稱為 `serviceB` 的實際服務。虛擬節點代表的實際服務可透過 `DNS` (主機名稱為 `serviceb.apps.local`) 探索。或者，您可以使用 探索實際的服務 AWS Cloud Map。虛擬節點將會在連接埠 80 上使用 HTTP/2 通訊協定來接聽流量。也支援其他通訊協定，以及運作狀態檢查。您將在稍後的步驟中為 `serviceA` 和 `serviceBv2` 建立虛擬節點。
------
#### [ AWS 管理主控台 ]
1. 對於 **Virtual node name (虛擬節點名稱)**，輸入 **serviceB**。
1. 針對**服務探索方法**，選擇 **DNS**，然後輸入 **serviceb.apps.local** **DNS 主機名稱**。
1. 在**接聽程式組態**下，為**通訊協定**選擇 **http2**，並為**連接埠**輸入 **80** 。
1. 若要繼續，請選擇 **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"
}
```
1. 使用 JSON 檔案做為輸入，搭配 [create-virtual-node](https://docs.aws.amazon.com/cli/latest/reference/appmesh/create-virtual-node.html) 命令建立虛擬節點。
```
aws appmesh create-virtual-node --cli-input-json file://create-virtual-node-serviceb.json
```
------
## 步驟 3：建立虛擬路由器和路由
虛擬路由器會路由網格內一或多個虛擬服務的流量。如需詳細資訊，請參閱[虛擬路由器](virtual_routers.md)及[路由](routes.md)。
建立下列資源：
+ 名為 `serviceB` 的虛擬路由器，因為 `serviceB.apps.local` 虛擬服務不會啟動與任何其他服務的對外通訊。請記住，您先前建立的虛擬服務是實際 `serviceb.apps.local` 服務的抽象。虛擬服務會將流量傳送至虛擬路由器。虛擬路由器會使用連接埠 80 上的 HTTP/2 通訊協定接聽流量。也支援其他通訊協定。
+ 名為 `serviceB` 的路由。它將 100% 的流量路由到`serviceB`虛擬節點。新增`serviceBv2`虛擬節點後，權重會進入後續步驟。雖然未涵蓋在本指南中，但您可以為路由新增其他篩選條件，並新增重試政策，使 Envoy 代理在遇到通訊問題時多次嘗試將流量傳送至虛擬節點。
------
#### [ AWS 管理主控台 ]
1. 對於 **Virtual router name (虛擬路由器名稱)**，輸入 **serviceB**。
1. 在**接聽程式組態**下，為**通訊協定**選擇 **http2**，並為**連接埠**指定 **80** 。
1. 對於 **Route name (路由名稱)**，輸入 **serviceB**。
1. 對於 **Route type (路由類型)**，選擇 **http2**。
1. 針對**目標組態**下的**虛擬節點名稱**，選取 `serviceB`並輸入 **100**表示**權重**。
1. 在**相符組態**下，選擇**方法**。
1. 若要繼續，請選擇 **Next (下一步)**。
------
#### [ AWS CLI ]
1. 建立虛擬路由器。
1. 使用下列內容建立名為 `create-virtual-router.json` 的檔案：
```
{
"meshName": "apps",
"spec": {
"listeners": [
{
"portMapping": {
"port": 80,
"protocol": "http2"
}
}
]
},
"virtualRouterName": "serviceB"
}
```
1. 使用 JSON 檔案做為輸入，搭配 [create-virtual-router](https://docs.aws.amazon.com/cli/latest/reference/appmesh/create-virtual-router.html) 命令建立虛擬路由器。
```
aws appmesh create-virtual-router --cli-input-json file://create-virtual-router.json
```
1. 建立路由。
1. 使用下列內容建立名為 `create-route.json` 的檔案：
```
{
"meshName" : "apps",
"routeName" : "serviceB",
"spec" : {
"httpRoute" : {
"action" : {
"weightedTargets" : [
{
"virtualNode" : "serviceB",
"weight" : 100
}
]
},
"match" : {
"prefix" : "/"
}
}
},
"virtualRouterName" : "serviceB"
}
```
1. 使用 JSON 做為輸入，搭配 [create-route](https://docs.aws.amazon.com/cli/latest/reference/appmesh/create-route.html) 命令建立路由。
```
aws appmesh create-route --cli-input-json file://create-route.json
```
------
## 步驟 4：檢閱和建立
依照先前的指示檢閱設定。
------
#### [ AWS 管理主控台 ]
如果您需要在任何區段中進行變更，請選擇 **Edit (編輯)**。對這些設定感到滿意後，請選擇 **Create mesh (建立網格)**。
**Status (狀態)** 畫面會顯示所有已建立的網格資源。選取 **View mesh (檢視網格)** 即可在主控台中檢視建立的資源。
------
#### [ AWS CLI ]
檢閱您使用 [describe-mesh](https://docs.aws.amazon.com/cli/latest/reference/appmesh/describe-mesh.html) 命令建立的網格設定。
```
aws appmesh describe-mesh --mesh-name apps
```
檢閱您使用 [describe-virtual-service](https://docs.aws.amazon.com/cli/latest/reference/appmesh/describe-virtual-service.html) 命令建立的虛擬服務設定。
```
aws appmesh describe-virtual-service --mesh-name apps --virtual-service-name serviceb.apps.local
```
檢閱您使用 [describe-virtual-node](https://docs.aws.amazon.com/cli/latest/reference/appmesh/describe-virtual-node.html) 命令建立的虛擬節點設定。
```
aws appmesh describe-virtual-node --mesh-name apps --virtual-node-name serviceB
```
檢閱您使用 [describe-virtual-router](https://docs.aws.amazon.com/cli/latest/reference/appmesh/describe-virtual-router.html) 命令建立的虛擬路由器設定。
```
aws appmesh describe-virtual-router --mesh-name apps --virtual-router-name serviceB
```
檢閱您使用 [describe-route](https://docs.aws.amazon.com/cli/latest/reference/appmesh/describe-route.html) 命令建立的路由設定。
```
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 (網格)**。
1. 選取您在上一個步驟中建立的 `apps` 網格。
1. 在左側導覽窗格中，選取 **Virtual nodes (虛擬節點)**。
1. 選擇 **Create virtual node (建立虛擬節點)**。
1. 對於 **Virtual node name (虛擬節點名稱)** 輸入 **serviceBv2**、對於 **Service discovery method (服務探索方法)** 選擇 **DNS**，然後對於 **DNS hostname (DNS 主機名稱)** 輸入 **servicebv2.apps.local**。
1. 針對**接聽程式組態**，選取**通訊協定**的 **http2**，然後**80**針對**連接埠**輸入 。
1. 選擇 **Create virtual node (建立虛擬節點)**。
1. 再次選擇 **Create virtual node (建立虛擬節點)**。輸入 **serviceA** 做為**虛擬節點名稱**。對於 **Service discovery method (服務探索方法)**，選擇 **DNS**，並針對 **DNS hostname (DNS 主機名稱)** 輸入 **servicea.apps.local**。
1. 在**新增後端**下**輸入虛擬服務名稱**，輸入 **serviceb.apps.local**。
1. 在**接聽程式組態**下，針對**通訊協定**選擇 **http2**，**80**針對**連接埠**輸入 ，然後選擇**建立虛擬節點**。
1. 在左側導覽窗格中，選取 **Virtual routers (虛擬路由器)**，然後從清單中選取 `serviceB` 虛擬路由器。
1. 在 **Routes (路由)** 下方，選取您在上一個步驟中建立的路由 (名為 `ServiceB`)，然後選擇 **Edit (編輯)**。
1. 在**目標**、**虛擬節點名稱**下，將 的**權重**值`serviceB`變更為 **75**。
1. 選擇**新增目標**，`serviceBv2`從下拉式清單中選擇，並將**權重**的值設定為 **25**。
1. 選擇**儲存**。
1. 在左側瀏覽窗格中，選取 **Virtual services (虛擬服務)**，然後選擇 **Create virtual service (建立虛擬服務)**。
1. **servicea.apps.local** 為**虛擬服務名稱**輸入 ，為**提供者**選取**虛擬節點**，`serviceA`為**虛擬節點**選取 ，然後選擇**建立虛擬服務。**
------
#### [ 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"
}
```
1. 建立虛擬節點。
```
aws appmesh create-virtual-node --cli-input-json file://create-virtual-node-servicebv2.json
```
1. 建立 `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"
}
```
1. 建立虛擬節點。
```
aws appmesh create-virtual-node --cli-input-json file://create-virtual-node-servicea.json
```
1. 更新您在上一個步驟中建立的 `serviceb.apps.local` 虛擬服務，將其流量傳送至 `serviceB` 虛擬路由器。最初建立虛擬服務時，它不會傳送流量到任何地方，因為 `serviceB` 虛擬路由器尚未建立。
1. 使用下列內容建立名為 `update-virtual-service.json` 的檔案：
```
{
"meshName" : "apps",
"spec" : {
"provider" : {
"virtualRouter" : {
"virtualRouterName" : "serviceB"
}
}
},
"virtualServiceName" : "serviceb.apps.local"
}
```
1. 使用 [update-virtual-service](https://docs.aws.amazon.com/cli/latest/reference/appmesh/update-virtual-service.html) 命令更新虛擬服務。
```
aws appmesh update-virtual-service --cli-input-json file://update-virtual-service.json
```
1. 更新您在上一個步驟中建立的 `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"
}
```
1. 使用 [update-route](https://docs.aws.amazon.com/cli/latest/reference/appmesh/update-route.html) 命令更新路由。
```
aws appmesh update-route --cli-input-json file://update-route.json
```
1. 建立 `serviceA` 虛擬服務。
1. 使用下列內容建立名為 `create-virtual-servicea.json` 的檔案：
```
{
"meshName" : "apps",
"spec" : {
"provider" : {
"virtualNode" : {
"virtualNodeName" : "serviceA"
}
}
},
"virtualServiceName" : "servicea.apps.local"
}
```
1. 建立虛擬服務。
```
aws appmesh create-virtual-service --cli-input-json file://create-virtual-servicea.json
```
------
**網格摘要**
在您建立服務網格之前，您有三個名稱為 `servicea.apps.local`、`serviceb.apps.local` 和 `servicebv2.apps.local` 的實際服務。除了實際服務以外，您目前擁有包含代表實際服務之下列資源的服務網格：
+ 兩個虛擬服務。代理會透過虛擬路由器將 `servicea.apps.local` 虛擬服務的所有流量傳送至 `serviceb.apps.local` 虛擬服務。
+ 名稱為 `serviceA`、`serviceB` 和 `serviceBv2` 的三個虛擬節點。Envoy 代理會使用針對虛擬節點設定的服務探索資訊，來查詢實際服務的 IP 地址。
+ 具有單一路由的虛擬路由器，其指示 Envoy 代理將 75% 的傳入流量路由到 `serviceB` 虛擬節點，將 25% 的流量路由到 `serviceBv2` 虛擬節點。
## 步驟 6：更新服務
在建立網格之後，您需要完成下列任務：
+ 授權您使用每個 Amazon ECS 任務部署的 Envoy 代理程式，以讀取一或多個虛擬節點的組態。如需如何授權代理的詳細資訊，請參閱[代理授權](https://docs.aws.amazon.com/app-mesh/latest/userguide/proxy-authorization.html)。
+ 更新每個現有的 Amazon ECS 任務定義，以使用 Envoy 代理。
**憑證**
Envoy 容器需要 AWS Identity and Access Management 登入資料，才能簽署傳送到 App Mesh 服務的請求。對於使用 Amazon EC2 啟動類型部署的 Amazon ECS 任務，憑證可以來自[執行個體角色](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/instance_IAM_role.html)或[任務 IAM 角色](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html)。在 Linux 容器上使用 Fargate 部署的 Amazon ECS 任務無法存取提供執行個體 IAM 設定檔憑證的 Amazon EC2 中繼資料伺服器。若要提供登入資料，您必須將 IAM 任務角色連接至使用 Fargate on Linux 容器類型部署的任何任務。
如果使用 Amazon EC2 啟動類型部署任務，且 Amazon EC2 中繼資料伺服器的存取遭到封鎖，如[任務 IAM 角色](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html)中*的重要*註釋中所述，則任務 IAM 角色也必須連接至任務。您指派給執行個體或任務的角色必須連接 IAM 政策，如 [Proxy 授權](https://docs.aws.amazon.com/app-mesh/latest/userguide/proxy-authorization.html)中所述。
**使用 更新您的任務定義 AWS CLI**
您可以使用 Amazon ECS AWS CLI 命令 [https://docs.aws.amazon.com/cli/latest/reference/ecs/register-task-definition.html](https://docs.aws.amazon.com/cli/latest/reference/ecs/register-task-definition.html)。以下任務定義範例說明如何為您的服務設定 App Mesh。
**注意**
透過主控台設定 Amazon ECS 的 App Mesh 無法使用。
### 任務定義 json
**代理組態**
若要將 Amazon ECS 服務設定為使用 App Mesh，您服務的任務定義必須具有下列代理組態區段。將代理組態 `type` 設為 `APPMESH`，將 `containerName` 設為 `envoy`。相應地設定下列屬性值。
`IgnoredUID`
對於使用此使用者 ID 的程序，Envoy 代理不會路由來自這些程序的流量。您可以為此屬性值選擇您想要的任何使用者 ID，但此 ID 必須與任務定義中 Envoy 容器的 `user` ID 相同。這配對可讓 Envoy 忽略自己的流量，而不使用代理。我們的範例是基於歷史用途使用 `{{1337}}`。
`ProxyIngressPort`
這是 Envoy 代理容器的傳入連接埠。將此值設為 `15000`。
`ProxyEgressPort`
這是 Envoy 代理容器的傳出連接埠。將此值設為 `15001`。
`AppPorts`
指定應用程式容器接聽的任何傳入連接埠。在這個範例中，應用程式容器會接聽連接埠 `{{9080}}`。您指定的連接埠必須符合在虛擬節點接聽程式上設定的連接埠。
`EgressIgnoredIPs`
Envoy 不會代理將流量送往這些 IP 地址。將此值設定為 `169.254.170.2,169.254.169.254`，這會忽略 Amazon EC2 中繼資料伺服器和 Amazon ECS 任務中繼資料端點。中繼資料端點提供任務登入資料的 IAM 角色。您可以新增其他地址。
`EgressIgnoredPorts`
您可以新增以逗號分隔的連接埠清單。Envoy 不會代理將流量送往這些連接埠。即使您沒有列出連接埠，連接埠 22 也會被忽略。
可忽略的傳出連接埠數目上限為 15。
```
"proxyConfiguration": {
"type": "APPMESH",
"containerName": "envoy",
"properties": [{
"name": "IgnoredUID",
"value": "{{1337}}"
},
{
"name": "ProxyIngressPort",
"value": "15000"
},
{
"name": "ProxyEgressPort",
"value": "15001"
},
{
"name": "AppPorts",
"value": "{{9080}}"
},
{
"name": "EgressIgnoredIPs",
"value": "169.254.170.2,169.254.169.254"
},
{
"name": "EgressIgnoredPorts",
"value": "{{22}}"
}
]
}
```
**應用程式容器 Envoy 相依性**
任務定義中的應用程式容器必須等待 Envoy 代理引導並啟動之後才能啟動。為了確保發生這種情況，您可以在每個應用程式容器定義中設定一個`dependsOn`區段，以等待 Envoy 容器報告為 `HEALTHY`。以下程式碼顯示具有此相依性的應用程式容器定義範例。以下範例中的所有屬性都是必要的。某些屬性值也是必要的，但有些是{{可取代的}}。
```
{
"name": "{{appName}}",
"image": "{{appImage}}",
"portMappings": [{
"containerPort": {{9080}},
"hostPort": {{9080}},
"protocol": "tcp"
}],
"essential": true,
"dependsOn": [{
"containerName": "envoy",
"condition": "HEALTHY"
}]
}
```
**Envoy 容器定義**
您的 Amazon ECS 任務定義必須包含 App Mesh Envoy 容器映像。
所有[支援](https://docs.aws.amazon.com/general/latest/gr/appmesh.html)的區域都可以將{{區域碼}}取代為 `me-south-1`、`ap-east-1`、`ap-southeast-3`、`eu-south-1`、 `il-central-1`和 以外的任何區域`af-south-1`。
標準
```
840364872350.dkr.ecr.{{region-code}}.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```
符合 FIPS 規範
```
840364872350.dkr.ecr.{{region-code}}.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod-fips
```
`me-south-1`
標準
```
772975370895.dkr.ecr.me-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```
`ap-east-1`
標準
```
856666278305.dkr.ecr.ap-east-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```
`ap-southeast-3`
標準
```
909464085924.dkr.ecr.ap-southeast-3.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```
`eu-south-1`
標準
```
422531588944.dkr.ecr.eu-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```
`il-central-1`
標準
```
564877687649.dkr.ecr.il-central-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```
`af-south-1`
標準
```
924023996002.dkr.ecr.af-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```
`Public repository`
標準
```
public.ecr.aws/appmesh/aws-appmesh-envoy:v1.34.13.0-prod
```
符合 FIPS 規範
```
public.ecr.aws/appmesh/aws-appmesh-envoy:v1.34.13.0-prod-fips
```
**重要**
只有 v1.9.0.0 版或更新版本支援與 App Mesh 搭配使用。
您必須使用 App Mesh Envoy 容器映像，直到 Envoy 專案團隊合併支援 App Mesh 的變更。如需其他詳細資訊，請參閱 [GitHub 藍圖問題](https://github.com/aws/aws-app-mesh-roadmap/issues/10)。
以下範例中的所有屬性都是必要的。某些屬性值也是必要的，但有些是{{可取代的}}。
**注意**
Envoy 容器定義必須標示為 `essential`。
我們建議將 `512` CPU 單位和至少 `64` MiB 的記憶體配置到 Envoy 容器。在 Fargate 上，您可以設定的最低記憶體為 `1024` MiB。
Amazon ECS 服務的虛擬節點名稱必須設定為 `APPMESH_RESOURCE_ARN` 屬性的值。此屬性需要版本 `1.15.0`或更新版本的 Envoy 映像。如需詳細資訊，請參閱[Envoy 影像](envoy.md)。
`user` 設定的值必須與任務定義代理組態中的 `IgnoredUID` 值相符。在此範例中，我們使用 `{{1337}}`.
此處顯示的運作狀態檢查會等待 Envoy 容器正確引導，然後再向 Amazon ECS 報告 Envoy 容器運作狀態良好，並準備好啟動應用程式容器。
根據預設，當 Envoy 在指標和追蹤方面參照本身時，App Mesh 會使用您在 `APPMESH_RESOURCE_ARN` 中指定的資源名稱。您可以藉由使用自己的名稱設定 `APPMESH_RESOURCE_CLUSTER` 環境變數，以覆寫此行為。此屬性需要版本 `1.15.0`或更新版本的 Envoy 映像。如需詳細資訊，請參閱[Envoy 影像](envoy.md)。
下列程式碼顯示 Envoy 容器定義範例。
```
{
"name": "envoy",
"image": "{{840364872350}}.dkr.ecr.{{us-west-2}}.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod",
"essential": true,
"environment": [{
"name": "APPMESH_RESOURCE_ARN",
"value": "arn:aws:appmesh:{{us-west-2}}:{{111122223333}}:mesh/{{apps}}/virtualNode/{{serviceB}}"
}],
"healthCheck": {
"command": [
"CMD-SHELL",
"curl -s http://localhost:9901/server_info | grep state | grep -q LIVE"
],
"startPeriod": {{10}},
"interval": {{5}},
"timeout": {{2}},
"retries": {{3}}
},
"user": "{{1337}}"
}
```
**任務定義範例**
下列範例 Amazon ECS 任務定義示範如何將上述範例合併為 的任務定義`taskB`。提供使用 或不使用 為這兩種 Amazon ECS 啟動類型建立任務的範例 AWS X-Ray。視需要變更{{可取代}}值，以從案例中建立名為 `taskBv2` 和 `taskA` 的任務定義。以您的網格名稱和虛擬節點名稱代替 `APPMESH_RESOURCE_ARN` 值，以您的應用程式監聽的連接埠清單代替代理組態 `AppPorts` 值。根據預設，當 Envoy 在指標和追蹤方面參照本身時，App Mesh 會使用您在 `APPMESH_RESOURCE_ARN` 中指定的資源名稱。您可以藉由使用自己的名稱設定 `APPMESH_RESOURCE_CLUSTER` 環境變數，以覆寫此行為。下列範例中的所有屬性都是必要的。某些屬性值也是必要的，但有些是{{可取代的}}。
如果您依照登入資料章節所述執行 Amazon ECS 任務，則需要將現有的[任務 IAM 角色](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html)新增至範例。
**重要**
Fargate 必須使用大於 1024 的連接埠值。
**Example Amazon ECS 任務定義的 JSON - Linux 容器上的 Fargate**
```
{
"family" : "{{taskB}}",
"memory" : "{{1024}}",
"cpu" : "{{0.5 vCPU}}",
"proxyConfiguration" : {
"containerName" : "envoy",
"properties" : [
{
"name" : "ProxyIngressPort",
"value" : "15000"
},
{
"name" : "AppPorts",
"value" : "{{9080}}"
},
{
"name" : "EgressIgnoredIPs",
"value" : "169.254.170.2,169.254.169.254"
},
{
"name": "EgressIgnoredPorts",
"value": "{{22}}"
},
{
"name" : "IgnoredUID",
"value" : "{{1337}}"
},
{
"name" : "ProxyEgressPort",
"value" : "15001"
}
],
"type" : "APPMESH"
},
"containerDefinitions" : [
{
"name" : "{{appName}}",
"image" : "{{appImage}}",
"portMappings" : [
{
"containerPort" : {{9080}},
"protocol" : "tcp"
}
],
"essential" : true,
"dependsOn" : [
{
"containerName" : "envoy",
"condition" : "HEALTHY"
}
]
},
{
"name" : "envoy",
"image" : "{{840364872350}}.dkr.ecr.{{us-west-2}}.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod",
"essential" : true,
"environment" : [
{
"name" : "APPMESH_VIRTUAL_NODE_NAME",
"value" : "mesh/{{apps}}/virtualNode/{{serviceB}}"
}
],
"healthCheck" : {
"command" : [
"CMD-SHELL",
"curl -s http://localhost:9901/server_info | grep state | grep -q LIVE"
],
"interval" : {{5}},
"retries" : {{3}},
"startPeriod" : {{10}},
"timeout" : {{2}}
},
"memory" : {{500}},
"user" : "{{1337}}"
}
],
"requiresCompatibilities" : [ "FARGATE" ],
"taskRoleArn" : "arn:aws:iam::{{123456789012}}:role/{{ecsTaskRole}}",
"executionRoleArn" : "arn:aws:iam::{{123456789012}}:role/{{ecsTaskExecutionRole}}",
"networkMode" : "awsvpc"
}
```
**Example JSON for Amazon ECS 任務定義 AWS X-Ray - Linux 容器上的 Fargate**
X-Ray 可讓您收集應用程式提供的請求相關資料，並提供可用來視覺化流量的工具。使用適用於 Envoy 的 X-Ray 驅動程式可讓 Envoy 向 X-Ray 報告追蹤資訊。您可以使用 [Envoy 組態](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy.html)啟用 X-Ray 追蹤。根據組態，Envoy 會將追蹤資料傳送至做為[附屬](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon-ecs.html)容器執行的 X-Ray 協助程式，而協助程式會將追蹤轉送至 X-Ray 服務。一旦追蹤發佈到 X-Ray，您可以使用 X-Ray 主控台來視覺化服務呼叫圖表並請求追蹤詳細資訊。下列 JSON 代表啟用 X-Ray 整合的任務定義。
```
{
"family" : "{{taskB}}",
"memory" : "{{1024}}",
"cpu" : "{{512}}",
"proxyConfiguration" : {
"containerName" : "envoy",
"properties" : [
{
"name" : "ProxyIngressPort",
"value" : "15000"
},
{
"name" : "AppPorts",
"value" : "{{9080}}"
},
{
"name" : "EgressIgnoredIPs",
"value" : "169.254.170.2,169.254.169.254"
},
{
"name": "EgressIgnoredPorts",
"value": "{{22}}"
},
{
"name" : "IgnoredUID",
"value" : "{{1337}}"
},
{
"name" : "ProxyEgressPort",
"value" : "15001"
}
],
"type" : "APPMESH"
},
"containerDefinitions" : [
{
"name" : "{{appName}}",
"image" : "{{appImage}}",
"portMappings" : [
{
"containerPort" : {{9080}},
"protocol" : "tcp"
}
],
"essential" : true,
"dependsOn" : [
{
"containerName" : "envoy",
"condition" : "HEALTHY"
}
]
},
{
"name" : "envoy",
"image" : "{{840364872350}}.dkr.ecr.{{us-west-2}}.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod",
"essential" : true,
"environment" : [
{
"name" : "APPMESH_VIRTUAL_NODE_NAME",
"value" : "mesh/{{apps}}/virtualNode/{{serviceB}}"
},
{
"name": "ENABLE_ENVOY_XRAY_TRACING",
"value": "1"
}
],
"healthCheck" : {
"command" : [
"CMD-SHELL",
"curl -s http://localhost:9901/server_info | grep state | grep -q LIVE"
],
"interval" : {{5}},
"retries" : {{3}},
"startPeriod" : {{10}},
"timeout" : {{2}}
},
"memory" : {{500}},
"user" : "{{1337}}"
},
{
"name" : "xray-daemon",
"image" : "amazon/aws-xray-daemon",
"user" : "{{1337}}",
"essential" : true,
"cpu" : "{{32}}",
"memoryReservation" : "{{256}}",
"portMappings" : [
{
"containerPort" : 2000,
"protocol" : "udp"
}
]
}
],
"requiresCompatibilities" : [ "FARGATE" ],
"taskRoleArn" : "arn:aws:iam::{{123456789012}}:role/{{ecsTaskRole}}",
"executionRoleArn" : "arn:aws:iam::{{123456789012}}:role/{{ecsTaskExecutionRole}}",
"networkMode" : "awsvpc"
}
```
**Example Amazon ECS 任務定義的 JSON - EC2 啟動類型**
```
{
"family": "{{taskB}}",
"memory": "{{256}}",
"proxyConfiguration": {
"type": "APPMESH",
"containerName": "envoy",
"properties": [
{
"name": "IgnoredUID",
"value": "{{1337}}"
},
{
"name": "ProxyIngressPort",
"value": "15000"
},
{
"name": "ProxyEgressPort",
"value": "15001"
},
{
"name": "AppPorts",
"value": "{{9080}}"
},
{
"name": "EgressIgnoredIPs",
"value": "169.254.170.2,169.254.169.254"
},
{
"name": "EgressIgnoredPorts",
"value": "{{22}}"
}
]
},
"containerDefinitions": [
{
"name": "{{appName}}",
"image": "{{appImage}}",
"portMappings": [
{
"containerPort": {{9080}},
"hostPort": {{9080}},
"protocol": "tcp"
}
],
"essential": true,
"dependsOn": [
{
"containerName": "envoy",
"condition": "HEALTHY"
}
]
},
{
"name": "envoy",
"image": "{{840364872350}}.dkr.ecr.{{us-west-2}}.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod",
"essential": true,
"environment": [
{
"name": "APPMESH_VIRTUAL_NODE_NAME",
"value": "mesh/{{apps}}/virtualNode/{{serviceB}}"
}
],
"healthCheck": {
"command": [
"CMD-SHELL",
"curl -s http://localhost:9901/server_info | grep state | grep -q LIVE"
],
"startPeriod": {{10}},
"interval": {{5}},
"timeout": {{2}},
"retries": {{3}}
},
"user": "{{1337}}"
}
],
"requiresCompatibilities" : [ "EC2" ],
"taskRoleArn" : "arn:aws:iam::{{123456789012}}:role/{{ecsTaskRole}}",
"executionRoleArn" : "arn:aws:iam::{{123456789012}}:role/{{ecsTaskExecutionRole}}",
"networkMode": "awsvpc"
}
```
**Example JSON for Amazon ECS 任務定義搭配 AWS X-Ray EC2 啟動類型**
```
{
"family": "{{taskB}}",
"memory": "{{256}}",
"cpu" : "{{1024}}",
"proxyConfiguration": {
"type": "APPMESH",
"containerName": "envoy",
"properties": [
{
"name": "IgnoredUID",
"value": "{{1337}}"
},
{
"name": "ProxyIngressPort",
"value": "15000"
},
{
"name": "ProxyEgressPort",
"value": "15001"
},
{
"name": "AppPorts",
"value": "{{9080}}"
},
{
"name": "EgressIgnoredIPs",
"value": "169.254.170.2,169.254.169.254"
},
{
"name": "EgressIgnoredPorts",
"value": "{{22}}"
}
]
},
"containerDefinitions": [
{
"name": "{{appName}}",
"image": "{{appImage}}",
"portMappings": [
{
"containerPort": {{9080}},
"hostPort": {{9080}},
"protocol": "tcp"
}
],
"essential": true,
"dependsOn": [
{
"containerName": "envoy",
"condition": "HEALTHY"
}
]
},
{
"name": "envoy",
"image": "{{840364872350}}.dkr.ecr.{{us-west-2}}.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod",
"essential": true,
"environment": [
{
"name": "APPMESH_VIRTUAL_NODE_NAME",
"value": "mesh/{{apps}}/virtualNode/{{serviceB}}"
},
{
"name": "ENABLE_ENVOY_XRAY_TRACING",
"value": "1"
}
],
"healthCheck": {
"command": [
"CMD-SHELL",
"curl -s http://localhost:9901/server_info | grep state | grep -q LIVE"
],
"startPeriod": {{10}},
"interval": {{5}},
"timeout": {{2}},
"retries": {{3}}
},
"user": "{{1337}}"
},
{
"name": "xray-daemon",
"image": "amazon/aws-xray-daemon",
"user": "{{1337}}",
"essential": true,
"cpu": 32,
"memoryReservation": 256,
"portMappings": [
{
"containerPort": 2000,
"protocol": "udp"
}
]
}
],
"requiresCompatibilities" : [ "EC2" ],
"taskRoleArn" : "arn:aws:iam::{{123456789012}}:role/{{ecsTaskRole}}",
"executionRoleArn" : "arn:aws:iam::{{123456789012}}:role/{{ecsTaskExecutionRole}}",
"networkMode": "awsvpc"
}
```
## 進階主題
### 使用 App Mesh 的 Canary 部署
Canary 部署和版本可協助您在舊版本的應用程式與新部署的版本之間切換流量。它也會監控新部署版本的運作狀態。如果新版本有任何問題，Canary 部署可以自動將流量切換回舊版本。Canary 部署可讓您使用更多控制在應用程式版本之間切換流量。
如需如何使用 App Mesh 為 Amazon ECS 實作 Canary 部署的詳細資訊，請參閱[使用 App Mesh 為 Amazon ECS 建立具有 Canary 部署的管道](https://aws.amazon.com/blogs/containers/create-a-pipeline-with-canary-deployments-for-amazon-ecs-using-aws-app-mesh/)
**注意**
如需 App Mesh 的更多範例和逐步解說，請參閱 [App Mesh 範例儲存庫](https://github.com/aws/aws-app-mesh-examples)。