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

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

sudo systemctl stop aws-appconfig-agent

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

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

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

CloudWatch 에이전트를 시작하려면 Amazon 사용 설명서의 CloudWatch 에이전트를 사용하여 Amazon EC2 인스턴스 및 온프레미스 서버에서 지표 및 로그 수집을 참조하세요. CloudWatch Systems Manager의 기능인 Quick Setup을 사용하여 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
        },
        ...
      ]
    },
    ...
  },
  ...
}

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

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

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

드롭인 단위 파일에서 다음 환경 변수를 지정EC2하여 AWS AppConfig Agent for Amazon을 구성할 수 있습니다.

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

"header: value"

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

HTTP localhost 호출을 사용하여 AWS AppConfig Agent에서 구성 데이터를 검색할 수 있습니다. 다음 예제에서는 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 Agent를 실행하려면 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