

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS App Mesh 和 Kubernetes 入門
<a name="getting-started-kubernetes"></a>

**重要**  
支援終止通知：在 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)。

當您使用適用於 Kubernetes 的 App Mesh 控制器 AWS App Mesh 與 Kubernetes 整合時，您可以管理 App Mesh 資源，例如網格、虛擬服務、虛擬節點、虛擬路由器，以及透過 Kubernetes 的路由。您也可以自動將 App Mesh 附屬容器映像新增至 Kubernetes Pod 規格。本教學課程會逐步引導您安裝適用於 Kubernetes 的 App Mesh 控制器，以啟用此整合。

控制器隨附下列 Kubernetes 自訂資源定義的部署：`meshes`、`virtual services`、`virtual nodes` 和 `virtual routers`。控制器會監控自訂資源的建立、修改和刪除，並透過 App Mesh API 變更對應的 App Mesh [服務網格](meshes.md)、[虛擬服務](virtual_services.md)[虛擬節點](virtual_nodes.md)[虛擬閘道](virtual_gateways.md)[閘道路由](gateway-routes.md)、、 [虛擬路由器](virtual_routers.md)（包括 [路由](routes.md)) 資源。若要進一步了解或為控制器提供貢獻，請參閱 [GitHub 專案](https://github.com/aws/aws-app-mesh-controller-for-k8s)。

控制器也會安裝 webhook，將下列容器注入到標示為您指定名稱的 Kubernetes Pod 中。
+ **App Mesh Envoy 代理** – Envoy 使用 App Mesh 控制平面中定義的組態來判斷傳送應用程式流量的位置。
+ **App Mesh 代理路由管理器 **– 更新 Pod 網路命名空間中的`iptables`規則，以透過 Envoy 路由傳入和傳出流量。此容器會在 Pod 內以 Kubernetes 初始化容器執行。

## 先決條件
<a name="mesh-k8s-integration-prerequisites"></a>
+ 對 App Mesh 概念的現有了解。如需詳細資訊，請參閱[什麼是 AWS App Mesh？](what-is-app-mesh.md)。
+ Kubernetes 概念的現有理解。如需詳細資訊，請參閱 [Kubernetes 文件中的什麼是](https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/) Kubernetes。
+ 現有 Kubernetes 叢集。如果您沒有現有的叢集，請參閱《[Amazon EKS 使用者指南](https://docs.aws.amazon.com/eks/latest/userguide/getting-started.html)*》中的 Amazon EKS *入門。如果您在 Amazon EC2 上執行自己的 Kubernetes 叢集，請確保 Docker 已向 Envoy 映像所在的 Amazon ECR 儲存庫進行身分驗證。如需詳細資訊，請參閱《Amazon Elastic Container Registry 使用者指南》中的 [Envoy 映像](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy.html)、[登錄檔身分驗證](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth)，以及《Kubernetes 文件》中的[從私有登錄檔提取映像](https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/)。
+ App Mesh 支援向 DNS AWS Cloud Map或兩者註冊的 Linux 服務。若要使用此入門指南，建議您擁有三個已向 DNS 註冊的現有服務。本主題中的程序假設現有服務名為 `serviceA`、 和 `serviceB`，`serviceBv2`並且所有服務都可以透過名為 的命名空間探索`apps.local`。

  即使服務不存在，您也可以建立服務網格及其資源，但在部署實際服務之前，您無法使用網格。
+  AWS CLI 已安裝 1.18.116 版或更新版本，或 2.0.38 版或更新版本。若要安裝或升級 AWS CLI，請參閱[安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)。
+ 已設定為與您的 Kubernetes 叢集通訊的 `kubectl` 用戶端。如果您使用的是 Amazon Elastic Kubernetes Service，您可以使用安裝`[kubectl](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html)`和設定`[kubeconfig](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html)`檔案的指示。
+ 已安裝 Helm 3.0 版或更新版本。如果您尚未安裝 Helm，請參閱《[Amazon EKS 使用者指南》中的搭配使用 Helm 與](https://docs.aws.amazon.com/eks/latest/userguide/helm.html) *Amazon EKS*。
+ Amazon EKS 目前僅支援 `IPv4_ONLY`和 `IPv6_ONLY` IP 偏好設定，因為 Amazon EKS 目前僅支援能夠僅提供`IPv4`流量或僅提供`IPv6`流量的 Pod。

其餘步驟假設實際服務名稱為 `serviceA`、`serviceB` 和 `serviceBv2`，而且所有服務皆可透過名稱為 `apps.local` 的命名空間探索。

## 步驟 1：安裝整合元件
<a name="install-controller"></a>

將整合元件安裝到託管您要與 App Mesh 搭配使用之 Pod 的每個叢集中一次。

**安裝整合元件**

1. 此程序的其餘步驟需有已安裝預先發行版本控制器的叢集。如果您已安裝發行前版本，或不確定您是否擁有 ，您可以下載並執行指令碼，檢查叢集上是否已安裝發行前版本。

   ```
   curl -o pre_upgrade_check.sh https://raw.githubusercontent.com/aws/eks-charts/master/stable/appmesh-controller/upgrade/pre_upgrade_check.sh
   sh ./pre_upgrade_check.sh
   ```

   如果指令碼傳回 `Your cluster is ready for upgrade. Please proceed to the installation instructions`，您可以繼續進行下個步驟。如果傳回不同的訊息，則您必須先完成升級步驟，才能繼續進行。如需升級發行前版本的詳細資訊，請參閱在 GitHub 上的 [Upgrade (升級)](https://github.com/aws/eks-charts/blob/master/stable/appmesh-controller/README.md#upgrade)。

1. 將 `eks-charts` 儲存庫新增到 Helm。

   ```
   helm repo add eks https://aws.github.io/eks-charts
   ```

1. 安裝 App Mesh Kubernetes 自訂資源定義 (CRD)。

   ```
   kubectl apply -k "https://github.com/aws/eks-charts/stable/appmesh-controller/crds?ref=master"
   ```

1. 為控制器建立 Kubernetes 命名空間。

   ```
   kubectl create ns appmesh-system
   ```

1. 設定下列變數，以便在稍後步驟中使用。以現有叢集的數值取代 `{{cluster-name}}` 和 `{{Region-code}}`。

   ```
   export CLUSTER_NAME={{cluster-name}}
   export AWS_REGION={{Region-code}}
   ```

1. (選用) 如果您要在 Fargate 上執行控制器，則必須建立 Fargate 設定檔。如果您尚未`eksctl`安裝 ，請參閱《*Amazon EKS 使用者指南*》中的[安裝或升級`eksctl`](https://docs.aws.amazon.com/eks/latest/userguide/eksctl.html#installing-eksctl)。如果您想要使用主控台建立設定檔，請參閱《*Amazon EKS 使用者指南*》中的[建立 Fargate 設定檔](https://docs.aws.amazon.com/eks/latest/userguide/fargate-profile.html#create-fargate-profile)。

   ```
   eksctl create fargateprofile --cluster $CLUSTER_NAME --name {{appmesh-system}} --namespace {{appmesh-system}}
   ```

1. 為您的叢集建立 OpenID Connect (OIDC) 身分識別提供者。如果您尚未`eksctl`安裝 ，您可以使用《*Amazon EKS 使用者指南*》中的[安裝或升級`eksctl`](https://docs.aws.amazon.com/eks/latest/userguide/eksctl.html#installing-eksctl)說明進行安裝。如果您想要使用主控台建立提供者，請參閱《*Amazon EKS 使用者指南*》中的[為叢集上的服務帳戶啟用 IAM 角色](https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html)。

   ```
   eksctl utils associate-iam-oidc-provider \
       --region=$AWS_REGION \
       --cluster $CLUSTER_NAME \
       --approve
   ```

1. 建立 IAM 角色，將 [https://console.aws.amazon.com/iam/home?#policies/arn:aws:iam::aws:policy/AWSAppMeshFullAccess$jsonEditor](https://console.aws.amazon.com/iam/home?#policies/arn:aws:iam::aws:policy/AWSAppMeshFullAccess$jsonEditor)和 [https://console.aws.amazon.com/iam/home?#policies/arn:aws:iam::aws:policy/AWSCloudMapFullAccess$jsonEditor](https://console.aws.amazon.com/iam/home?#policies/arn:aws:iam::aws:policy/AWSCloudMapFullAccess$jsonEditor) AWS 受管政策連接至該角色，並將其繫結至 Kubernetes `appmesh-controller` 服務帳戶。該角色可讓控制器新增、移除和變更 App Mesh 資源。
**注意**  
命令會建立具有自動產生名稱的 AWS IAM 角色。您無法指定所建立的 IAM 角色名稱。

   ```
   eksctl create iamserviceaccount \
       --cluster $CLUSTER_NAME \
       --namespace appmesh-system \
       --name appmesh-controller \
       --attach-policy-arn  arn:aws:iam::aws:policy/AWSCloudMapFullAccess,arn:aws:iam::aws:policy/AWSAppMeshFullAccess \
       --override-existing-serviceaccounts \
       --approve
   ```

   如果您想要使用 AWS 管理主控台 或 建立服務帳戶 AWS CLI，請參閱《*Amazon EKS 使用者指南*》中的[為您的服務帳戶建立 IAM 角色和政策](https://docs.aws.amazon.com/eks/latest/userguide/create-service-account-iam-policy-and-role.html#create-service-account-iam-role)。如果您使用 AWS 管理主控台 或 AWS CLI 來建立帳戶，您也需要將角色對應至 Kubernetes 服務帳戶。如需詳細資訊，請參閱《*Amazon EKS 使用者指南*》中的[為您的服務帳戶指定 IAM 角色](https://docs.aws.amazon.com/eks/latest/userguide/specify-service-account-role.html)。

1. 

**部署 App Mesh 控制器。如需所有組態選項的清單，請參閱 GitHub 上的[組態](https://github.com/aws/eks-charts/blob/master/stable/appmesh-controller/README.md#configuration) 。**

   1. 若要部署私有叢集的 App Mesh 控制器，您必須先將 App Mesh 和服務探索 Amazon VPC 端點啟用至連結的私有子網路。您也需要設定 `accountId`。

      ```
      --set accountId=$AWS_ACCOUNT_ID
      ```

      若要在私有叢集中啟用 X-Ray 追蹤，請啟用 X-Ray 和 Amazon ECR Amazon VPC 端點。根據`public.ecr.aws/xray/aws-xray-daemon:latest`預設，控制器會使用 ，因此請將此映像提取至本機，並將其[推送至您的個人 ECR 儲存庫](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html)。
**注意**  
[Amazon VPC 端點](https://docs.aws.amazon.com/AmazonECR/latest/userguide/vpc-endpoints.html)目前不支援 Amazon ECR 公有儲存庫。

      下列範例顯示使用 X-Ray 組態部署控制器。

      ```
      helm upgrade -i appmesh-controller eks/appmesh-controller \
          --namespace appmesh-system \
          --set region={{$AWS_REGION}} \
          --set serviceAccount.create=false \
          --set serviceAccount.name=appmesh-controller \
          --set accountId={{$AWS_ACCOUNT_ID}} \
          --set log.level=debug \
          --set tracing.enabled=true \
          --set tracing.provider=x-ray \
          --set xray.image.repository={{your-account-id}}.dkr.ecr.{{your-region}}.amazonaws.com/{{your-repository}} \
          --set xray.image.tag={{your-xray-daemon-image-tag}}
      ```

      使用虛擬節點或閘道繫結應用程式部署時，請確認 X-Ray 協助程式是否已成功注入。

      如需詳細資訊，請參閱《*Amazon EKS 使用者指南*[》中的私有叢集](https://docs.aws.amazon.com/eks/latest/userguide/private-clusters.html)。

   1. 部署其他叢集的 App Mesh 控制器。如需所有組態選項的清單，請參閱 GitHub 上的[組態](https://github.com/aws/eks-charts/blob/master/stable/appmesh-controller/README.md#configuration) 。

      ```
      helm upgrade -i appmesh-controller eks/appmesh-controller \
          --namespace appmesh-system \
          --set region=$AWS_REGION \
          --set serviceAccount.create=false \
          --set serviceAccount.name=appmesh-controller
      ```
**注意**  
如果您的 Amazon EKS 叢集系列是 `IPv6`，請在部署 App Mesh 控制器時將下列選項新增至先前的命令 ，以設定叢集名稱`--set clusterName=$CLUSTER_NAME`。
**重要**  
如果您的叢集位於 `me-south-1`、`ap-east-1`、`il-central-1`、、 `ap-southeast-3` `eu-south-1`或 `af-south-1`區域，則需要將下列選項新增至先前的命令：  
將 {{account-id}} 和 {{region-code}} 取代為一組適當的值。  

       ```
        --set image.repository={{account-id}}.dkr.ecr.{{Region-code}}.amazonaws.com/amazon/appmesh-controller
       ```
772975370895.dkr.ecr.me-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
856666278305.dkr.ecr.ap-east-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
909464085924.dkr.ecr.ap-southeast-3.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
422531588944.dkr.ecr.eu-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
564877687649.dkr.ecr.il-central-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
924023996002.dkr.ecr.af-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
您可以在 GitHub 的變更[日誌](https://github.com/aws/aws-app-mesh-controller-for-k8s/releases)中找到較舊的影像 URIs。版本 中影像所在的 AWS 帳戶已變更`v1.5.0`。舊版映像託管在 AWS Amazon Elastic Kubernetes Service [Amazon 容器映像登錄檔](https://docs.aws.amazon.com/eks/latest/userguide/add-ons-images.html)中找到的帳戶上。

       ```
       --set sidecar.image.repository={{account-id}}.dkr.ecr.{{Region-code}}.amazonaws.com/aws-appmesh-envoy
       ```
772975370895.dkr.ecr.me-south-1.amazonaws.com/amazon/appmesh-controller:v1.13.1
856666278305.dkr.ecr.ap-east-1.amazonaws.com/amazon/appmesh-controller:v1.13.1
909464085924.dkr.ecr.ap-southeast-3.amazonaws.com/amazon/appmesh-controller:v1.13.1
422531588944.dkr.ecr.eu-south-1.amazonaws.com/amazon/appmesh-controller:v1.13.1
564877687649.dkr.ecr.il-central-1.amazonaws.com/amazon/appmesh-controller:v1.13.1
924023996002.dkr.ecr.af-south-1.amazonaws.com/amazon/appmesh-controller:v1.13.1

       ```
       --set sidecar.image.repository={{account-id}}.dkr.ecr.{{Region-code}}.amazonaws.com/aws-appmesh-envoy
       ```
772975370895.dkr.ecr.me-south-1.amazonaws.com/aws-appmesh-proxy-route-manager:v7-prod
856666278305.dkr.ecr.ap-east-1.amazonaws.com/aws-appmesh-proxy-route-manager:v7-prod
909464085924.dkr.ecr.ap-southeast-3.amazonaws.com/aws-appmesh-proxy-route-manager:v7-prod
422531588944.dkr.ecr.eu-south-1.amazonaws.com/aws-appmesh-proxy-route-manager:v7-prod
564877687649.dkr.ecr.il-central-1.amazonaws.com/aws-appmesh-proxy-route-manager:v7-prod
924023996002.dkr.ecr.af-south-1.amazonaws.com/aws-appmesh-proxy-route-manager:v7-prod
**重要**  
只有 v1.9.0.0 版或更新版本支援與 App Mesh 搭配使用。

1. 確認控制器版本為 `v1.4.0` 或更新版本。您可以在 GitHub 上查看 [change log (變更日誌)](https://github.com/aws/aws-app-mesh-controller-for-k8s/releases)。

   ```
   kubectl get deployment appmesh-controller \
       -n appmesh-system \
       -o json  | jq -r ".spec.template.spec.containers[].image" | cut -f2 -d ':'
   ```
**注意**  
如果您檢視執行中容器的日誌，您應該會看到一行文字，其中包含下列文字，而您可以放心忽略此內容。  

   ```
   Neither -kubeconfig nor -master was specified. Using the inClusterConfig. This might not work.
   ```

## 步驟 2：部署 App Mesh 資源
<a name="configure-app-mesh"></a>

在 Kubernetes 中部署應用程式時，您也可以建立 Kubernetes 自訂資源，讓控制器可以建立對應的 App Mesh 資源。下列程序可協助您部署 App Mesh 資源及其部分功能。您可以在 GitHub 上 App Mesh 演練中列出的許多功能資料夾的`v1beta2`子資料夾中，找到部署其他 App Mesh 資源功能的範例資訊清單。 [https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs)

**重要**  
控制器建立 App Mesh 資源後，建議您只使用控制器變更或刪除 App Mesh 資源。如果您使用 App Mesh 變更或刪除資源，控制器預設不會在十小時內變更或重新建立變更或刪除的 App Mesh 資源。您可以將此持續時間設定為較短。如需詳細資訊，請參閱 GitHub 上的 [Configuration (組態)](https://github.com/aws/eks-charts/blob/master/stable/appmesh-controller/README.md#configuration)。

**部署 App Mesh 資源**

1. 建立 Kubernetes 命名空間以部署 App Mesh 資源。

   1. 將下列內容儲存到電腦上名為 `namespace.yaml` 的檔案中。

      ```
      apiVersion: v1
      kind: Namespace
      metadata:
        name: {{my-apps
      }}  labels:
          mesh: {{my-mesh}}
          appmesh.k8s.aws/sidecarInjectorWebhook: enabled
      ```

   1. 建立命名空間。

      ```
      kubectl apply -f namespace.yaml
      ```

1. 建立 App Mesh 服務網格。

   1. 將下列內容儲存到電腦上名為 `mesh.yaml` 的檔案中。檔案用於建立名為 的網格資源`{{my-mesh}}`。服務網格是在它之內各服務之間網路流量的邏輯邊界。

      ```
      apiVersion: appmesh.k8s.aws/v1beta2
      kind: Mesh
      metadata:
        name: {{my-mesh}}
      spec:
        namespaceSelector:
          matchLabels:
            mesh: {{my-mesh}}
      ```

   1. 建立網格。

      ```
      kubectl apply -f mesh.yaml
      ```

   1. 檢視已建立 Kubernetes 網格資源的詳細資料。

      ```
      kubectl describe mesh {{my-mesh}}
      ```

      Output

      ```
      Name:         my-mesh
      Namespace:
      Labels:       <none>
      Annotations:  kubectl.kubernetes.io/last-applied-configuration:
                      {"apiVersion":"appmesh.k8s.aws/v1beta2","kind":"Mesh","metadata":{"annotations":{},"name":"my-mesh"},"spec":{"namespaceSelector":{"matchLa...
      API Version:  appmesh.k8s.aws/v1beta2
      Kind:         Mesh
      Metadata:
        Creation Timestamp:  2020-06-17T14:51:37Z
        Finalizers:
          finalizers.appmesh.k8s.aws/mesh-members
          finalizers.appmesh.k8s.aws/aws-appmesh-resources
        Generation:        1
        Resource Version:  6295
        Self Link:         /apis/appmesh.k8s.aws/v1beta2/meshes/my-mesh
        UID:               111a11b1-c11d-1e1f-gh1i-j11k1l111m711
      Spec:
        Aws Name:  my-mesh
        Namespace Selector:
          Match Labels:
            Mesh:  my-mesh
      Status:
        Conditions:
          Last Transition Time:  2020-06-17T14:51:37Z
          Status:                True
          Type:                  MeshActive
        Mesh ARN:                arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh
        Observed Generation:     1
      Events:                    <none>
      ```

   1. 檢視控制器建立之 App Mesh 服務網格的詳細資訊。

      ```
      aws appmesh describe-mesh --mesh-name {{my-mesh}}
      ```

      Output

      ```
      {
          "mesh": {
              "meshName": "my-mesh",
              "metadata": {
                  "arn": "arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh",
                  "createdAt": "2020-06-17T09:51:37.920000-05:00",
                  "lastUpdatedAt": "2020-06-17T09:51:37.920000-05:00",
                  "meshOwner": "111122223333",
                  "resourceOwner": "111122223333",
                  "uid": "111a11b1-c11d-1e1f-gh1i-j11k1l111m711",
                  "version": 1
              },
              "spec": {},
              "status": {
                  "status": "ACTIVE"
              }
          }
      }
      ```

1. 建立 App Mesh 虛擬節點。虛擬節點會充當 Kubernetes 部署的邏輯指標。

   1. 將下列內容儲存到電腦上名為 `virtual-node.yaml` 的檔案中。檔案用於在 {{`my-apps`}} 命名空間`{{my-service-a}}`中建立名為 的 App Mesh 虛擬節點。該虛擬節點代表在稍後的步驟中建立的 Kubernetes 服務。`hostname` 的值是此虛擬節點所代表之實際服務的完整 DNS 主機名稱。

      ```
      apiVersion: appmesh.k8s.aws/v1beta2
      kind: VirtualNode
      metadata:
        name: {{my-service-a}}
        namespace: {{my-apps}}
      spec:
        podSelector:
          matchLabels:
            app: {{my-app-1}}
        listeners:
          - portMapping:
              port: {{80}}
              protocol: {{http}}
        serviceDiscovery:
          dns:
            hostname: {{my-service-a.my-apps.svc.cluster.local}}
      ```

      虛擬節點具有本教學未涵蓋的功能，例如端對端加密和運作狀態檢查。如需詳細資訊，請參閱[虛擬節點](virtual_nodes.md)。若要查看您可以為上述規格中的虛擬節點設定的所有可用設定，請執行下列命令。

      ```
      aws appmesh create-virtual-node --generate-cli-skeleton yaml-input
      ```

   1. 部署虛擬節點。

      ```
      kubectl apply -f virtual-node.yaml
      ```

   1. 檢視所建立之 Kubernetes 虛擬節點資源的詳細資料。

      ```
      kubectl describe virtualnode {{my-service-a}} -n {{my-apps}}
      ```

      Output

      ```
      Name:         my-service-a
      Namespace:    my-apps
      Labels:       <none>
      Annotations:  kubectl.kubernetes.io/last-applied-configuration:
                      {"apiVersion":"appmesh.k8s.aws/v1beta2","kind":"VirtualNode","metadata":{"annotations":{},"name":"my-service-a","namespace":"my-apps"},"s...
      API Version:  appmesh.k8s.aws/v1beta2
      Kind:         VirtualNode
      Metadata:
        Creation Timestamp:  2020-06-17T14:57:29Z
        Finalizers:
          finalizers.appmesh.k8s.aws/aws-appmesh-resources
        Generation:        2
        Resource Version:  22545
        Self Link:         /apis/appmesh.k8s.aws/v1beta2/namespaces/my-apps/virtualnodes/my-service-a
        UID:               111a11b1-c11d-1e1f-gh1i-j11k1l111m711
      Spec:
        Aws Name:  my-service-a_my-apps
        Listeners:
          Port Mapping:
            Port:      80
            Protocol:  http
        Mesh Ref:
          Name:  my-mesh
          UID:   111a11b1-c11d-1e1f-gh1i-j11k1l111m711
        Pod Selector:
          Match Labels:
            App:  nginx
        Service Discovery:
          Dns:
            Hostname:  my-service-a.my-apps.svc.cluster.local
      Status:
        Conditions:
          Last Transition Time:  2020-06-17T14:57:29Z
          Status:                True
          Type:                  VirtualNodeActive
        Observed Generation:     2
        Virtual Node ARN:        arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh/virtualNode/my-service-a_my-apps
      Events:                    <none>
      ```

   1. 檢視控制器在 App Mesh 中建立之虛擬節點的詳細資訊。
**注意**  
即使在 Kubernetes 中建立的虛擬節點名稱是 `{{my-service-a}}`，但在 App Mesh 中建立的虛擬節點名稱為 `{{my-service-a_my-apps}}`。控制器會在建立 App Mesh 資源時，將 Kubernetes 命名空間名稱附加至 App Mesh 虛擬節點名稱。命名空間名稱會新增，因為在 Kubernetes 中，您可以在不同的命名空間中建立具有相同名稱的虛擬節點，但在 App Mesh 中，虛擬節點名稱在網格中必須是唯一的。

      ```
      aws appmesh describe-virtual-node --mesh-name {{my-mesh}} --virtual-node-name {{my-service-a_my-apps}}
      ```

      Output

      ```
      {
          "virtualNode": {
              "meshName": "my-mesh",
              "metadata": {
                  "arn": "arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh/virtualNode/my-service-a_my-apps",
                  "createdAt": "2020-06-17T09:57:29.840000-05:00",
                  "lastUpdatedAt": "2020-06-17T09:57:29.840000-05:00",
                  "meshOwner": "111122223333",
                  "resourceOwner": "111122223333",
                  "uid": "111a11b1-c11d-1e1f-gh1i-j11k1l111m711",
                  "version": 1
              },
              "spec": {
                  "backends": [],
                  "listeners": [
                      {
                          "portMapping": {
                              "port": 80,
                              "protocol": "http"
                          }
                      }
                  ],
                  "serviceDiscovery": {
                      "dns": {
                          "hostname": "my-service-a.my-apps.svc.cluster.local"
                      }
                  }
              },
              "status": {
                  "status": "ACTIVE"
              },
              "virtualNodeName": "my-service-a_my-apps"
          }
      }
      ```

1. 建立 App Mesh 虛擬路由器。虛擬路由器會處理網格內一或多個虛擬服務的流量。

   1. 將下列內容儲存到電腦上名為 `virtual-router.yaml` 的檔案中。檔案用於建立虛擬路由器，將流量路由到上一個步驟中建立且名為 `my-service-a` 的虛擬節點。控制器會建立 App Mesh 虛擬路由器和路由資源。您可以為路由指定更多功能，並使用除 `http` 以外的通訊協定。如需詳細資訊，請參閱[虛擬路由器](virtual_routers.md)及[路由](routes.md)。請注意，參考的虛擬節點名稱是 Kubernetes 虛擬節點名稱，而不是控制器在 App Mesh 中建立的 App Mesh 虛擬節點名稱。

      ```
      apiVersion: appmesh.k8s.aws/v1beta2
      kind: VirtualRouter
      metadata:
        namespace: {{my-apps}}
        name: {{my-service-a-virtual-router}}
      spec:
        listeners:
          - portMapping:
              port: {{80
      }}        protocol: {{http}}
        routes:
          - name: {{my-service-a-route}}
            httpRoute:
              match:
                prefix: {{/}}
              action:
                weightedTargets:
                  - virtualNodeRef:
                      name: {{my-service-a}}
                    weight: {{1}}
      ```

      （選用） 若要查看您可以在上述規格中設定的虛擬路由器的所有可用設定，請執行下列命令。

      ```
      aws appmesh create-virtual-router --generate-cli-skeleton yaml-input
      ```

      若要查看您可以在上述規格中設定的路由的所有可用設定，請執行下列命令。

      ```
      aws appmesh create-route --generate-cli-skeleton yaml-input
      ```

   1. 部署虛擬路由器。

      ```
      kubectl apply -f virtual-router.yaml
      ```

   1. 檢視已建立的 Kubernetes 的虛擬路由器資源。

      ```
      kubectl describe virtualrouter {{my-service-a-virtual-router}} -n {{my-apps}}
      ```

      縮寫輸出

      ```
      Name:         my-service-a-virtual-router
      Namespace:    my-apps
      Labels:       <none>
      Annotations:  kubectl.kubernetes.io/last-applied-configuration:
                      {"apiVersion":"appmesh.k8s.aws/v1beta2","kind":"VirtualRouter","metadata":{"annotations":{},"name":"my-service-a-virtual-router","namespac...
      API Version:  appmesh.k8s.aws/v1beta2
      Kind:         VirtualRouter
      ...
      Spec:
        Aws Name:  my-service-a-virtual-router_my-apps
        Listeners:
          Port Mapping:
            Port:      80
            Protocol:  http
        Mesh Ref:
          Name:  my-mesh
          UID:   111a11b1-c11d-1e1f-gh1i-j11k1l111m711
        Routes:
          Http Route:
            Action:
              Weighted Targets:
                Virtual Node Ref:
                  Name:  my-service-a
                Weight:  1
            Match:
              Prefix:  /
          Name:        my-service-a-route
      Status:
        Conditions:
          Last Transition Time:  2020-06-17T15:14:01Z
          Status:                True
          Type:                  VirtualRouterActive
        Observed Generation:     1
        Route AR Ns:
          My - Service - A - Route:  arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh/virtualRouter/my-service-a-virtual-router_my-apps/route/my-service-a-route
        Virtual Router ARN:          arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh/virtualRouter/my-service-a-virtual-router_my-apps
      Events:                        <none>
      ```

   1. 檢視控制器在 App Mesh 中建立的虛擬路由器資源。您`my-service-a-virtual-router_my-apps`為 指定 `name`，因為當控制器在 App Mesh 中建立虛擬路由器時，會將 Kubernetes 命名空間名稱附加至虛擬路由器的名稱。

      ```
      aws appmesh describe-virtual-router --virtual-router-name {{my-service-a-virtual-router_my-apps}} --mesh-name {{my-mesh}}
      ```

      Output

      ```
      {
          "virtualRouter": {
              "meshName": "my-mesh",
              "metadata": {
                  "arn": "arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh/virtualRouter/my-service-a-virtual-router_my-apps",
                  "createdAt": "2020-06-17T10:14:01.547000-05:00",
                  "lastUpdatedAt": "2020-06-17T10:14:01.547000-05:00",
                  "meshOwner": "111122223333",
                  "resourceOwner": "111122223333",
                  "uid": "111a11b1-c11d-1e1f-gh1i-j11k1l111m711",
                  "version": 1
              },
              "spec": {
                  "listeners": [
                      {
                          "portMapping": {
                              "port": 80,
                              "protocol": "http"
                          }
                      }
                  ]
              },
              "status": {
                  "status": "ACTIVE"
              },
              "virtualRouterName": "my-service-a-virtual-router_my-apps"
          }
      }
      ```

   1. 檢視控制器在 App Mesh 中建立的路由資源。因為路由是 Kubernetes 中虛擬路由器組態的一部分，所以並未在 Kubernetes 中建立路由資源。路由資訊會顯示在 Kubernetes 資源詳情的子步驟 `c` 中。控制器在 App Mesh 中建立路由時，並未將 Kubernetes 命名空間名稱附加至 App Mesh 路由名稱，因為路由名稱對虛擬路由器是唯一的。

      ```
      aws appmesh {{describe-route}} \
          --route-name {{my-service-a-route}} \
          --virtual-router-name {{my-service-a-virtual-router_my-apps}} \
          --mesh-name {{my-mesh}}
      ```

      Output

      ```
      {
          "route": {
              "meshName": "my-mesh",
              "metadata": {
                  "arn": "arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh/virtualRouter/my-service-a-virtual-router_my-apps/route/my-service-a-route",
                  "createdAt": "2020-06-17T10:14:01.577000-05:00",
                  "lastUpdatedAt": "2020-06-17T10:14:01.577000-05:00",
                  "meshOwner": "111122223333",
                  "resourceOwner": "111122223333",
                  "uid": "111a11b1-c11d-1e1f-gh1i-j11k1l111m711",
                  "version": 1
              },
              "routeName": "my-service-a-route",
              "spec": {
                  "httpRoute": {
                      "action": {
                          "weightedTargets": [
                              {
                                  "virtualNode": "my-service-a_my-apps",
                                  "weight": 1
                              }
                          ]
                      },
                      "match": {
                          "prefix": "/"
                      }
                  }
              },
              "status": {
                  "status": "ACTIVE"
              },
              "virtualRouterName": "my-service-a-virtual-router_my-apps"
          }
      }
      ```

1. 建立 App Mesh 虛擬服務。虛擬服務是實際服務的抽象化，由虛擬節點直接提供，或透過虛擬路由器間接提供。相依服務會依其名稱呼叫您的虛擬服務。雖然名稱與 App Mesh 無關，但我們建議將虛擬服務命名為虛擬服務所代表之實際服務的完整網域名稱。透過這種方式命名您的虛擬服務，您不需要變更應用程式程式碼來參考不同的名稱。請求會路由傳送到指定為虛擬服務之提供者的虛擬節點或虛擬路由器。

   1. 將下列內容儲存到電腦上名為 `virtual-service.yaml` 的檔案中。檔案用於建立虛擬服務，該服務使用虛擬路由器供應商將流量路由到在上一個步驟中建立的名為 `my-service-a` 的虛擬節點。`spec` 中的 `awsName` 數值是此虛擬服務所抽象之實際 Kubernetes 服務的完整格式網域名稱 (FQDN)。在 [步驟 3：建立或更新服務](#create-update-services) 中建立 Kubernetes 服務。如需詳細資訊，請參閱[虛擬服務](virtual_services.md)。

      ```
      apiVersion: appmesh.k8s.aws/v1beta2
      kind: VirtualService
      metadata:
        name: {{my-service-a}}
        namespace: {{my-apps}}
      spec:
        awsName: {{my-service-a.my-apps.svc.cluster.local}}
        provider:
          virtualRouter:
            virtualRouterRef:
              name: {{my-service-a-virtual-router}}
      ```

      若要查看您可以為上述規格中的虛擬服務設定的所有可用設定，請執行下列命令。

      ```
      aws appmesh create-virtual-service --generate-cli-skeleton yaml-input
      ```

   1. 建立虛擬服務。

      ```
      kubectl apply -f virtual-service.yaml
      ```

   1. 檢視所建立之 Kubernetes 虛擬服務資源的詳細資料。

      ```
      kubectl describe virtualservice {{my-service-a}} -n {{my-apps}}
      ```

      Output

      ```
      Name:         my-service-a
      Namespace:    my-apps
      Labels:       <none>
      Annotations:  kubectl.kubernetes.io/last-applied-configuration:
                      {"apiVersion":"appmesh.k8s.aws/v1beta2","kind":"VirtualService","metadata":{"annotations":{},"name":"my-service-a","namespace":"my-apps"}...
      API Version:  appmesh.k8s.aws/v1beta2
      Kind:         VirtualService
      Metadata:
        Creation Timestamp:  2020-06-17T15:48:40Z
        Finalizers:
          finalizers.appmesh.k8s.aws/aws-appmesh-resources
        Generation:        1
        Resource Version:  13598
        Self Link:         /apis/appmesh.k8s.aws/v1beta2/namespaces/my-apps/virtualservices/my-service-a
        UID:               111a11b1-c11d-1e1f-gh1i-j11k1l111m711
      Spec:
        Aws Name:  my-service-a.my-apps.svc.cluster.local
        Mesh Ref:
          Name:  my-mesh
          UID:   111a11b1-c11d-1e1f-gh1i-j11k1l111m711
        Provider:
          Virtual Router:
            Virtual Router Ref:
              Name:  my-service-a-virtual-router
      Status:
        Conditions:
          Last Transition Time:  2020-06-17T15:48:40Z
          Status:                True
          Type:                  VirtualServiceActive
        Observed Generation:     1
        Virtual Service ARN:     arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh/virtualService/my-service-a.my-apps.svc.cluster.local
      Events:                    <none>
      ```

   1. 檢視控制器在 App Mesh 中建立的虛擬服務資源詳細資訊。Kubernetes 控制器在 App Mesh 中建立虛擬服務時，並未將 Kubernetes 命名空間名稱附加至 App Mesh 虛擬服務名稱，因為虛擬服務的名稱是唯一的 FQDN。

      ```
      aws appmesh describe-virtual-service --virtual-service-name {{my-service-a.my-apps.svc.cluster.local}} --mesh-name {{my-mesh}}
      ```

      Output

      ```
      {
          "virtualService": {
              "meshName": "my-mesh",
              "metadata": {
                  "arn": "arn:aws:appmesh:us-west-2:111122223333:mesh/my-mesh/virtualService/my-service-a.my-apps.svc.cluster.local",
                  "createdAt": "2020-06-17T10:48:40.182000-05:00",
                  "lastUpdatedAt": "2020-06-17T10:48:40.182000-05:00",
                  "meshOwner": "111122223333",
                  "resourceOwner": "111122223333",
                  "uid": "111a11b1-c11d-1e1f-gh1i-j11k1l111m711",
                  "version": 1
              },
              "spec": {
                  "provider": {
                      "virtualRouter": {
                          "virtualRouterName": "my-service-a-virtual-router_my-apps"
                      }
                  }
              },
              "status": {
                  "status": "ACTIVE"
              },
              "virtualServiceName": "my-service-a.my-apps.svc.cluster.local"
          }
      }
      ```

雖然本教學未涵蓋，但控制器也可以部署 App Mesh [虛擬閘道](virtual_gateways.md)和 [閘道路由](gateway-routes.md)。如需使用控制器部署這些資源的逐步解說，請參閱[設定傳入閘道](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/howto-k8s-ingress-gateway)，或包含 GitHub 上資源[的範例資訊](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/howto-k8s-ingress-gateway/v1beta2/manifest.yaml.template)清單。

## 步驟 3：建立或更新服務
<a name="create-update-services"></a>

您想要與 App Mesh 搭配使用的任何 Pod 都必須新增 App Mesh 附屬容器。注入器會自動將附屬容器新增至部署您指定命名空間的任何 Pod 中。

1. 啟用代理伺服器授權。我們建議您讓每個 Kubernetes 部署僅串流其 App Mesh 虛擬節點的組態。

   1. 將下列內容儲存到電腦上名為 `proxy-auth.json` 的檔案中。請務必用您自己的{{替代顏色值}}取代。

------
#### [ JSON ]

****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": "appmesh:StreamAggregatedResources",
                  "Resource": [
                      "arn:aws:appmesh:{{us-east-1}}:{{111122223333}}:mesh/my-mesh/virtualNode/my-service-a_my-apps"
                  ]
              }
          ]
      }
      ```

------

   1. 建立政策。

      ```
      aws iam create-policy --policy-name {{my-policy}} --policy-document file://proxy-auth.json
      ```

   1. 建立 IAM 角色、將您在上一個步驟中建立的政策連接至該角色、建立 Kubernetes 服務帳戶，並將政策繫結至 Kubernetes 服務帳戶。該角色可讓控制器新增、移除和變更 App Mesh 資源。

      ```
      eksctl create iamserviceaccount \
          --cluster $CLUSTER_NAME \
          --namespace {{my-apps}} \
          --name {{my-service-a}} \
          --attach-policy-arn  arn:aws:iam::{{111122223333}}:policy/{{my-policy}} \
          --override-existing-serviceaccounts \
          --approve
      ```

      如果您想要使用 AWS 管理主控台 或 建立服務帳戶 AWS CLI，請參閱《*Amazon EKS 使用者指南*》中的[為您的服務帳戶建立 IAM 角色和政策](https://docs.aws.amazon.com/eks/latest/userguide/create-service-account-iam-policy-and-role.html#create-service-account-iam-role)。如果您使用 AWS 管理主控台 或 AWS CLI 來建立帳戶，您也需要將角色對應至 Kubernetes 服務帳戶。如需詳細資訊，請參閱《*Amazon EKS 使用者指南*》中的[為您的服務帳戶指定 IAM 角色](https://docs.aws.amazon.com/eks/latest/userguide/specify-service-account-role.html)。

1. (選用) 如果您要將您的部署內容部署到 Fargate Pod，則需要建立 Fargate 設定檔。如果您尚未`eksctl`安裝 ，您可以使用 *Amazon EKS 使用者指南*中的[安裝或升級`eksctl`](https://docs.aws.amazon.com/eks/latest/userguide/eksctl.html#installing-eksctl)中的指示進行安裝。如果您想要使用主控台建立設定檔，請參閱《*Amazon EKS 使用者指南*》中的[建立 Fargate 設定檔](https://docs.aws.amazon.com/eks/latest/userguide/fargate-profile.html#create-fargate-profile)。

   ```
   eksctl create fargateprofile --cluster {{my-cluster}} --region {{Region-code}} --name {{my-service-a}} --namespace {{my-apps}}
   ```

1. 建立 Kubernetes 服務和部署。如果您有要與 App Mesh 搭配使用的現有部署，則需要部署虛擬節點，就像在 `3`的子步驟一樣[步驟 2：部署 App Mesh 資源](#configure-app-mesh)。更新您的部署，以確保其標籤符合您在虛擬節點上設定的標籤，以便附屬容器自動新增至 Pod，並重新部署 Pod。

   1. 將下列內容儲存到電腦上名為 `example-service.yaml` 的檔案中。如果您變更命名空間名稱並使用 Fargate Pod，請確定命名空間名稱符合您在 Fargate 設定檔中定義的命名空間名稱。

      ```
      apiVersion: v1
      kind: Service
      metadata:
        name: {{my-service-a}}
        namespace: {{my-apps}}
        labels:
          app: {{my-app-1}}
      spec:
        selector:
          app: {{my-app-1}}
        ports:
          - protocol: {{TCP}}
            port: {{80}}
            targetPort: {{80}}
      ---
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: {{my-service-a}}
        namespace: {{my-apps}}
        labels:
          app: {{my-app-1}}
      spec:
        replicas: {{3}}
        selector:
          matchLabels:
            app: {{my-app-1}}
        template:
          metadata:
            labels:
              app: {{my-app-1}}
          spec:
            serviceAccountName: {{my-service-a}}
            containers:
            - name: {{nginx}}
              image: {{nginx:1.19.0}}
              ports:
              - containerPort: {{80}}
      ```
**重要**  
規範中的 `app` `matchLabels` `selector` 值必須與您在 [步驟 2：部署 App Mesh 資源](#configure-app-mesh) 的子步驟 `3` 中建立虛擬節點時指定的值相符，否則附屬容器將不會注入到 Pod 中。在上一個範例中，標籤的值為 `my-app-1`。如果您部署虛擬閘道，而不是虛擬節點，則`Deployment`資訊清單應該只包含 Envoy 容器。如需要使用之映像的詳細資訊，請參閱 [Envoy 影像](envoy.md)。如需範例 Manfest，請參閱 GitHub 上的[部署範例](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/howto-k8s-ingress-gateway/v1beta2/manifest.yaml.template#L585)。

   1. 部署服務。

      ```
      kubectl apply -f {{example-service.yaml}}
      ```

   1. 檢視服務和部署。

      ```
      kubectl -n {{my-apps}} get pods
      ```

      Output

      ```
      NAME                            READY   STATUS    RESTARTS   AGE
      my-service-a-54776556f6-2cxd9   2/2     Running   0          10s
      my-service-a-54776556f6-w26kf   2/2     Running   0          18s
      my-service-a-54776556f6-zw5kt   2/2     Running   0          26s
      ```

   1. 檢視已部署之其中一個 pod 的詳細資訊。

      ```
      kubectl -n {{my-apps}} describe pod {{my-service-a-54776556f6-2cxd9}}
      ```

      縮寫輸出

      ```
      Name:         my-service-a-54776556f6-2cxd9
      Namespace:    my-app-1
      Priority:     0
      Node:         ip-192-168-44-157.us-west-2.compute.internal/192.168.44.157
      Start Time:   Wed, 17 Jun 2020 11:08:59 -0500
      Labels:       app=nginx
                    pod-template-hash=54776556f6
      Annotations:  kubernetes.io/psp: eks.privileged
      Status:       Running
      IP:           192.168.57.134
      IPs:
        IP:           192.168.57.134
      Controlled By:  ReplicaSet/my-service-a-54776556f6
      Init Containers:
        proxyinit:
          Container ID:   docker://e0c4810d584c21ae0cb6e40f6119d2508f029094d0e01c9411c6cf2a32d77a59
          Image:          111345817488.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-proxy-route-manager:v2
          Image ID:       docker-pullable://111345817488.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-proxy-route-manager
          Port:           <none>
          Host Port:      <none>
          State:          Terminated
            Reason:       Completed
            Exit Code:    0
            Started:      Fri, 26 Jun 2020 08:36:22 -0500
            Finished:     Fri, 26 Jun 2020 08:36:22 -0500
          Ready:          True
          Restart Count:  0
          Requests:
            cpu:     10m
            memory:  32Mi
          Environment:
            APPMESH_START_ENABLED:         1
            APPMESH_IGNORE_UID:            1337
            APPMESH_ENVOY_INGRESS_PORT:    15000
            APPMESH_ENVOY_EGRESS_PORT:     15001
            APPMESH_APP_PORTS:             80
            APPMESH_EGRESS_IGNORED_IP:     169.254.169.254
            APPMESH_EGRESS_IGNORED_PORTS:  22
            AWS_ROLE_ARN:                  arn:aws:iam::111122223333:role/eksctl-app-mesh-addon-iamserviceaccount-my-a-Role1-NMNCVWB6PL0N
            AWS_WEB_IDENTITY_TOKEN_FILE:   /var/run/secrets/eks.amazonaws.com/serviceaccount/token
          ...
      Containers:
        nginx:
          Container ID:   docker://be6359dc6ecd3f18a1c87df7b57c2093e1f9db17d5b3a77f22585ce3bcab137a
          Image:          nginx:1.19.0
          Image ID:       docker-pullable://nginx
          Port:           80/TCP
          Host Port:      0/TCP
          State:          Running
            Started:      Fri, 26 Jun 2020 08:36:28 -0500
          Ready:          True
          Restart Count:  0
          Environment:
            AWS_ROLE_ARN:                 arn:aws:iam::111122223333:role/eksctl-app-mesh-addon-iamserviceaccount-my-a-Role1-NMNCVWB6PL0N
            AWS_WEB_IDENTITY_TOKEN_FILE:  /var/run/secrets/eks.amazonaws.com/serviceaccount/token
          ...
        envoy:
          Container ID:   docker://905b55cbf33ef3b3debc51cb448401d24e2e7c2dbfc6a9754a2c49dd55a216b6
          Image:          840364872350.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy:v1.12.4.0-prod
          Image ID:       docker-pullable://840364872350.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy
          Port:           9901/TCP
          Host Port:      0/TCP
          State:          Running
            Started:      Fri, 26 Jun 2020 08:36:36 -0500
          Ready:          True
          Restart Count:  0
          Requests:
            cpu:     10m
            memory:  32Mi
          Environment:
            APPMESH_RESOURCE_ARN:         arn:aws:iam::111122223333:mesh/my-mesh/virtualNode/my-service-a_my-apps
            APPMESH_PREVIEW:              0
            ENVOY_LOG_LEVEL:              info
            AWS_REGION:                   us-west-2
            AWS_ROLE_ARN:                 arn:aws:iam::111122223333:role/eksctl-app-mesh-addon-iamserviceaccount-my-a-Role1-NMNCVWB6PL0N
            AWS_WEB_IDENTITY_TOKEN_FILE:  /var/run/secrets/eks.amazonaws.com/serviceaccount/token
      ...
      Events:
        Type    Reason     Age   From                                                   Message
        ----    ------     ----  ----                                                   -------
        Normal  Pulling    30s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Pulling image "111345817488.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-proxy-route-manager:v2"
        Normal  Pulled     23s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Successfully pulled image "111345817488.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-proxy-route-manager:v2"
        Normal  Created    21s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Created container proxyinit
        Normal  Started    21s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Started container proxyinit
        Normal  Pulling    20s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Pulling image "nginx:1.19.0"
        Normal  Pulled     16s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Successfully pulled image "nginx:1.19.0"
        Normal  Created    15s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Created container nginx
        Normal  Started    15s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Started container nginx
        Normal  Pulling    15s   kubelet, ip-192-168-44-157.us-west-2.compute.internal  Pulling image "840364872350.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy:v1.12.4.0-prod"
        Normal  Pulled     8s    kubelet, ip-192-168-44-157.us-west-2.compute.internal  Successfully pulled image "840364872350.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy:v1.12.4.0-prod"
        Normal  Created    7s    kubelet, ip-192-168-44-157.us-west-2.compute.internal  Created container envoy
        Normal  Started    7s    kubelet, ip-192-168-44-157.us-west-2.compute.internal  Started container envoy
      ```

      在前面的輸出中，您可以看到 `proxyinit` 和 `envoy` 容器已新增至 pod 中。如果您已將範例服務部署至 Fargate，則控制器會將`envoy`容器新增至 Pod，但容器`proxyinit`並未如此。

1. （選用） 安裝附加元件，例如 Prometheus、Grafana AWS X-Ray、Jaeger 和 Datadog。如需詳細資訊，請參閱 GitHub 上的 [App Mesh 附加元件](https://github.com/aws/eks-charts#app-mesh-add-ons)和《App Mesh 使用者指南》中的[可觀測性](https://docs.aws.amazon.com/app-mesh/latest/userguide/observability.html)一節。

**注意**  
如需 App Mesh 的更多範例和逐步解說，請參閱 [App Mesh 範例儲存庫](https://github.com/aws/aws-app-mesh-examples)。

## 步驟 4：清理
<a name="remove-integration"></a>

移除本教學中建立的所有範例資源。控制器也會移除在 `my-mesh` App Mesh 服務網格中建立的資源。

```
kubectl delete namespace {{my-apps}}
```

如果您已為範例服務建立 Fargate 設定檔，請將其移除。

```
eksctl delete fargateprofile --name {{my-service-a}} --cluster {{my-cluster}} --region {{Region-code}}
```

刪除網格。

```
kubectl delete mesh {{my-mesh}}
```

(選擇性) 您可以移除 Kubernetes 整合元件。

```
helm delete appmesh-controller -n appmesh-system
```

（選用） 如果您將 Kubernetes 整合元件部署至 Fargate，請刪除 Fargate 設定檔。

```
eksctl delete fargateprofile --name {{appmesh-system}} --cluster {{my-cluster}} --region {{Region-code}}
```