

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

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

 AWS AppConfig Agent sidecar 容器将在您的 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 Agent 的默认行为。有关更多信息，请参阅 [（可选）使用环境变量为 Amazon ECS 和 Amazon EKS 配置 AWS AppConfig 代理](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
   ```

   在 A AWS AppConfig gent 容器中找到如下语句：`[appconfig agent] 1970/01/01 00:00:00 INFO serving on localhost:2772`

**注意**  
您可以通过输入或更改环境变量来调整 AWS AppConfig Agent 的默认行为。有关可用环境变量的更多信息，请参阅 [（可选）使用环境变量为 Amazon ECS 和 Amazon EKS 配置 AWS AppConfig 代理](appconfig-integration-containers-agent-configuring.md)。