Amazon EC2 및 온프레미스 시스템에서 AWS AppConfig Agent 사용

AWS AppConfig 에이전트를 사용하여 Amazon Elastic Compute Cloud(Amazon EC2) Linux 인스턴스에서 실행되는 애플리케이션과 AWS AppConfig를 통합할 수 있습니다. 에이전트는 다음과 같은 방법으로 애플리케이션 처리 및 관리를 개선합니다.

*AWS AppConfig 에이전트는 서비스가 구성 데이터를 처음 검색할 때 데이터를 캐시합니다. 이러한 이유로 데이터를 검색하기 위한 첫 번째 호출은 후속 호출보다 느립니다.

1단계: (필수) 리소스 생성 및 권한 구성

Amazon EC2 인스턴스에서 실행되는 애플리케이션과 AWS AppConfig가 통합되려면 기능 플래그 또는 자유 형식 구성 데이터를 비롯한 AWS AppConfig 아티팩트와 구성 데이터를 생성해야 합니다. 자세한 내용은 AWS AppConfig에서 기능 플래그 및 자유 형식 구성 데이터 생성 섹션을 참조하십시오.

AWS AppConfig에서 호스팅되는 구성 데이터를 검색하려면 애플리케이션이 AWS AppConfig 데이터 영역에 액세스할 수 있도록 구성되어 있어야 합니다. 애플리케이션에 액세스 권한을 부여하려면 Amazon EC2 인스턴스 역할에 할당된 IAM 권한 정책을 업데이트하십시오. 특히, 정책에 appconfig:StartConfigurationSession 및 appconfig:GetLatestConfiguration 액션을 추가해야 합니다. 예:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "appconfig:StartConfigurationSession",
                "appconfig:GetLatestConfiguration"
            ],
            "Resource": "*"
        }
    ]
}

정책에 권한을 추가하는 것에 대한 자세한 내용은 IAM 사용 설명서의 IAM 자격 증명 권한 추가 및 제거를 참조하십시오.

2단계: (필수) Amazon EC2 인스턴스에 AWS AppConfig 에이전트 설치 및 시작

AWS에서 관리하는 Amazon Simple Storage Service(S3) 버킷에서 AWS AppConfig 에이전트를 호스팅합니다. 다음 절차를 사용하여 Linux 인스턴스에 최신 버전의 에이전트를 설치합니다. 애플리케이션이 여러 인스턴스에 분산되어 있는 경우 애플리케이션을 호스팅하는 각 인스턴스에서 이 절차를 수행해야 합니다.

sudo systemctl stop aws-appconfig-agent

3단계: (선택 사항이지만 권장됨) CloudWatch Logs에 로그 파일 전송

기본적으로 AWS AppConfig 에이전트는 STDERR에 로그를 게시합니다. Systemd는 Linux 인스턴스에서 실행되는 모든 서비스의 STDOUT 및 STDERR을 시스템 저널로 리디렉션합니다. 하나 또는 두 개의 인스턴스에서만 AWS AppConfig 에이전트를 실행하는 경우 systemd 저널에서 로그 데이터를 보고 관리할 수 있습니다. 분산 애플리케이션에 강력히 권장하는 더 나은 솔루션은 디스크에 로그 파일을 기록한 다음 Amazon CloudWatch 에이전트를 사용하여 로그 데이터를 AWS 클라우드에 업로드하는 것입니다. 또한 인스턴스에서 오래된 로그 파일을 삭제하도록 CloudWatch 에이전트를 구성하여 인스턴스의 디스크 공간이 부족해지는 것을 방지할 수 있습니다.

디스크 로깅을 활성화하려면 4단계: (선택 사항) 환경 변수를 사용하여 Amazon EC2용 AWS AppConfig 에이전트 구성에 설명된 대로 LOG_PATH 환경 변수를 설정해야 합니다.

CloudWatch 에이전트로 시작하려면 Amazon CloudWatch 사용 설명서의 CloudWatch 에이전트를 사용하여 Amazon EC2 인스턴스 및 온프레미스 서버로부터 지표 및 로그 수집을 참조하십시오. Systems Manager의 기능인 빠른 설정을 사용하여 CloudWatch 에이전트를 빠르게 설치할 수 있습니다. 자세한 내용은 AWS Systems Manager 사용 설명서의 빠른 설정 호스트 관리를 참조하십시오.

인스턴스에 CloudWatch 에이전트를 설치한 후 CloudWatch 에이전트 구성 파일을 생성합니다. 구성 파일은 CloudWatch 에이전트에 AWS AppConfig 에이전트 로그 파일 사용 방법을 지시합니다. CloudWatch 에이전트 구성 파일을 구성하는 방법에 대한 자세한 내용은 CloudWatch 에이전트 구성 파일 생성 섹션을 참조하십시오.

인스턴스의 CloudWatch 에이전트 구성 파일에 다음 logs 섹션을 추가하고 변경 내용을 저장합니다.

"logs": {
  "logs_collected": {
    "files": {
      "collect_list": [
        {
          "file_path": "/path_you_specified_for_logging",
          "log_group_name": "${YOUR_LOG_GROUP_NAME}/aws-appconfig-agent.log",
          "auto_removal": true
        },
        ...
      ]
    },
    ...
  },
  ...
}

auto_removal 값이 true인 경우 CloudWatch 에이전트는 교체된 AWS AppConfig 에이전트 로그 파일을 자동으로 삭제합니다.

4단계: (선택 사항) 환경 변수를 사용하여 Amazon EC2용 AWS AppConfig 에이전트 구성

환경 변수를 사용하여 Amazon EC2용 AWS AppConfig 에이전트를 구성할 수 있습니다. systemd 서비스의 환경 변수를 설정하려면 드롭인 단위 파일을 생성합니다. 다음 예제는 드롭인 단위 파일을 생성하여 AWS AppConfig 에이전트 로깅 수준을 DEBUG로 설정하는 방법을 보여줍니다.

드롭인 단위 파일에 다음 환경 변수를 지정하여 Amazon EC2용 AWS AppConfig 에이전트를 구성할 수 있습니다.

GET /applications/my_app/...
                  Host: localhost:2772
                  Authorization: Bearer <token value>

"header: value"

5단계: (필수) 구성 데이터 검색

HTTP localhost 호출을 사용하여 AWS AppConfig 에이전트에서 구성 데이터를 검색할 수 있습니다. 다음 예제는 HTTP 클라이언트와 curl을 함께 사용합니다. 애플리케이션 언어에서 지원하는 사용 가능한 모든 HTTP 클라이언트 또는 AWS SDK를 포함한 사용 가능한 라이브러리를 사용하여 에이전트를 호출할 수 있습니다.

배포된 구성의 전체 내용을 검색하려면

$ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name"

Feature Flag 유형의 AWS AppConfig 구성에서 단일 플래그와 해당 속성을 검색하려면

$ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name"

Feature Flag 유형의 AWS AppConfig 구성에서 여러 플래그와 해당 속성에 액세스하려면

$ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two"

6단계 (선택 사항이지만 권장됨): AWS AppConfig 에이전트 업데이트 자동화

AWS AppConfig 에이전트는 정기적으로 업데이트됩니다. 인스턴스에서 최신 버전의 AWS AppConfig 에이전트를 실행하려면 Amazon EC2 사용자 데이터에 다음 명령을 추가하는 것이 좋습니다. 인스턴스 또는 EC2 Auto Scaling 그룹의 사용자 데이터에 명령을 추가할 수 있습니다. 스크립트는 인스턴스가 시작되거나 재부팅될 때마다 에이전트의 최신 버전을 설치하고 시작합니다.

#!/bin/bash
# install the latest version of the agent
yum install -y https://s3.amazonaws.com/aws-appconfig-downloads/aws-appconfig-agent/linux/x86_64/latest/aws-appconfig-agent.rpm
# optional: configure the agent
mkdir /etc/systemd/system/aws-appconfig-agent.service.d
echo "${MY_AGENT_CONFIG}" > /etc/systemd/system/aws-appconfig-agent.service.d/overrides.conf 
systemctl daemon-reload
# start the agent
systemctl start aws-appconfig-agent