기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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 에이전트의 기본 동작을 조정할 수 있습니다. 자세한 내용은 [(선택 사항) 환경 변수를 사용하여 Amazon ECS 및 Amazon EKS용 AWS AppConfig 에이전트 구성](appconfig-integration-containers-agent-configuring.md) 단원을 참조하십시오.
의 경우 AWS AppConfig 에이전트가 구성 데이터를 검색하는 AWS 리전 코드(예: `us-west-1`)를 *AWS 리전*지정합니다.

1. 다음 `kubectl` 명령을 실행하여 클러스터에 변경 내용을 적용합니다. *my-deployment*는 배포 매니페스트의 이름으로 바꿉니다.

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

1. 배포가 완료되면 AWS AppConfig 에이전트가 실행 중인지 확인합니다. 다음 명령을 사용하여 Application 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 에이전트의 기본 동작을 조정할 수 있습니다. 사용할 수 있는 환경 변수에 대한 자세한 내용은 [(선택 사항) 환경 변수를 사용하여 Amazon ECS 및 Amazon EKS용 AWS AppConfig 에이전트 구성](appconfig-integration-containers-agent-configuring.md) 섹션을 참조하십시오.