

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 启动 AWS AppConfig 亚马逊 EKS 集成代理
<a name="appconfig-integration-containers-agent-starting-eks"></a>

 AWS AppConfig 代理边车容器在您的亚马逊 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 亚马逊 ECS 和亚马逊 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 亚马逊 ECS 和亚马逊 EKS 代理](appconfig-integration-containers-agent-configuring.md)。