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

# 啟動 Amazon EKS 整合的 AWS AppConfig 代理程式
<a name="appconfig-integration-containers-agent-starting-eks"></a>

 AWS AppConfig 代理程式附屬容器會自動在您的 Amazon EKS 環境中提供。若要使用它，您必須啟動它。下列程序說明如何使用 Amazon EKS `kubectl`命令列工具來啟動代理程式。

**注意**  
繼續之前，請確定您的`kubeconfig`檔案是最新的。如需建立或編輯`kubeconfig`檔案的詳細資訊，請參閱《[Amazon EKS 使用者指南》中的為 Amazon EKS 叢集建立或更新 kubeconfig 檔案](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html)。 ****

**啟動 AWS AppConfig 代理程式 (kubectl 命令列工具）**

1. 開啟您應用程式的資訊清單，並確認 Amazon EKS 應用程式是以單一容器部署的方式執行。檔案的內容看起來應該類似以下內容。

   ```
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-app
     namespace: my-namespace
     labels:
       app: my-application-label
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: my-application-label
     template:
       metadata:
         labels:
           app: my-application-label
       spec:
         containers:
         - name: my-app
           image: my-repo/my-image
           imagePullPolicy: IfNotPresent
   ```

1. 將 AWS AppConfig 客服人員容器定義詳細資訊新增至部署資訊清單。

   ```
   - name: appconfig-agent
           image: public.ecr.aws/aws-appconfig/aws-appconfig-agent:2.x
           ports:
           - name: http
             containerPort: 2772
             protocol: TCP
           env:
           - name: SERVICE_REGION
             value: AWS 區域
           imagePullPolicy: IfNotPresent
   ```
**注意**  
記下以下資訊。  
AWS AppConfig 根據預設，代理程式會在連接埠 2772 上執行。您可以指定不同的連接埠。
您可以輸入環境變數來調整 AWS AppConfig 代理程式的預設行為。如需詳細資訊，請參閱[（選用） 使用環境變數來設定 AWS AppConfig Agent for Amazon ECS 和 Amazon EKS](appconfig-integration-containers-agent-configuring.md)。
針對 *AWS 區域*，指定 AWS AppConfig 代理程式擷取組態資料的 AWS 區域 程式碼 （例如 `us-west-1`)。

1. 執行下列`kubectl`命令，將變更套用至您的叢集。將 *my-deployment* 取代為您的部署資訊清單名稱。

   ```
   kubectl apply -f my-deployment.yml
   ```

1. 部署完成後，請確認 AWS AppConfig 代理程式正在執行。使用下列命令來檢視應用程式 Pod 日誌檔案。

   ```
   kubectl logs -n my-namespace -c appconfig-agent my-pod
   ```

   找出 AWS AppConfig 代理程式容器的陳述式，如下所示： `[appconfig agent] 1970/01/01 00:00:00 INFO serving on localhost:2772`

**注意**  
您可以輸入或變更環境變數來調整 AWS AppConfig 代理程式的預設行為。如需可用環境變數的相關資訊，請參閱 [（選用） 使用環境變數來設定 AWS AppConfig Agent for Amazon ECS 和 Amazon EKS](appconfig-integration-containers-agent-configuring.md)。