View a markdown version of this page

AWS AppConfig 에이전트를 사용하여 구성 데이터를 검색하는 방법 - AWS AppConfig

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

AWS AppConfig 에이전트를 사용하여 구성 데이터를 검색하는 방법

AWS AppConfig 에이전트는 AWS AppConfig 기능 플래그 또는 자유 형식 구성 데이터를 검색하는 데 권장되는 방법입니다. 에이전트는 Amazon EC2, Amazon ECS, Amazon EKS 및 Lambda를 포함한 모든 형식의 AWS 컴퓨팅에서 지원됩니다. 초기 에이전트 설정을 완료한 후 에이전트를 사용하여 구성 데이터를 검색하는 것이 AWS AppConfig APIs. 에이전트는 모범 사례를 자동으로 구현하며 구성을 검색하기 위한 API 호출이 적 AWS AppConfig 기 때문에 사용 비용을 낮출 수 있습니다.

참고

별도의에서 구성 데이터를 검색하는 AWS 계정 것은 지원되지 않습니다.

사용자 또는 개체 기반 점진적 배포에 AWS AppConfig 에이전트 사용

AWS AppConfig 에이전트는 점진적 롤아웃 중에 특정 세그먼트 또는 개별 사용자에게 기능 플래그 또는 자유 형식 구성 데이터 배포를 지원합니다. 개체 기반 점진적 배포를 사용하면 사용자 또는 세그먼트가 구성 버전을 받으면 요청을 처리하는 컴퓨팅 리소스에 관계없이 배포 기간 동안 동일한 버전을 계속 받을 수 있습니다.

개체 기반 점진적 배포를 통해 AWS AppConfig 에이전트는 각 HTTP 요청과 함께 제공된 고유 식별자(Entity-Id)를 평가합니다. 이 식별자를 기반으로 에이전트는 배포 기간 동안 지속적으로 새 구성 버전 또는 이전 구성 버전을 제공합니다. 이 프로세스는 사용자가 업데이트된 구성을 받으면 계속 수신하도록 합니다. 또한 롤백 경보에 충분한 시간과 데이터가 있어 문제를 감지할 수 있습니다.

구성이 사용자 대면 동작을 직접 변경하고 블래스트 반경의 변경(모든 사용자가 부분적으로 영향을 받는 것이 아니라 특정 사용자에게 완전히 영향을 미치는)이 애플리케이션에 적합한 경우 엔터티 기반 점진적 배포를 고려하세요.

중요

개체 기반 점진적 배포에 대한 다음 중요 정보에 유의하세요.

  • 개체 기반 점진적 배포에는 AWS AppConfig 에이전트 버전 2.0.136060 이상이 필요합니다.

  • Entity-Id는 최대 문자열 크기 2KB를 허용합니다.

  • 고유 식별자는 하드 코딩되거나 카디널리티가 낮아서는 안 됩니다.

  • 식별자는 AWS AppConfig 서비스로 전송되지 않습니다. AWS AppConfig 에이전트는 클라이언트 측에서 고유 식별자를 평가합니다.

  • 배포 중에 AWS AppConfig 에이전트는 엔터티 및 배포된 구성을 추적합니다. 이 추적은 배포 기간 동안에만 유지됩니다. 배포가 완료되면 추적이 종료됩니다.

  • 배포 상태에 대한 AWS AppConfig 폴링의 각 인스턴스는 독립적으로 수행되므로 에이전트는 배포 비율이 변경될 때 동일한 개체의 다른 버전을 잠시 제공할 수 있습니다. 이 기간은 폴링 간격과 짧은 동기화 기간에 따라 결정됩니다. StartConfigurationSession API 작업RequiredMinimumPollIntervalInSeconds에서를 설정하여 이를 줄일 수 있습니다. 그러나 간격이 짧을수록 API 호출 속도가 증가하여 비용과 위험 제한이 증가할 수 있습니다. 요구 사항에 맞는 폴링 간격을 선택합니다. 자세한 내용은 참조의 StartConfigurationSession을 AWS CLI 참조하세요.

개체 기반 점진적 배포 활성화

개체 기반 점진적 배포를 활성화하려면:

  1. AWS AppConfig 에이전트 버전 2.0.136060 이상으로 업데이트합니다.

  2. 구성 데이터를 검색할 때 Entity-Id HTTP 헤더에 고유 식별자를 제공합니다.

다음 예제 요청은에 대한 이메일 주소를 사용합니다. Entity-Id

GET /applications/myapp/environments/prod/configurations/featureflags HTTP/1.1 Host: localhost:2772 Entity-Id: example@AWS-example-email.com

다음에 대한 요청에 Entity-Id 헤더를 포함할 수 있습니다.

/applications/{Application}/environments/{Environment}/configurations/{Configuration}

를 사용하여 코드 샘플을 보려면 섹션을 Entity-Id참조하세요AWS AppConfig 에이전트를 사용하여 자유 형식 구성 프로필 읽기.

Entity-Id 값은 다음과 같이 시스템의 개체를 고유하게 식별하는 모든 문자열일 수 있습니다.

  • 고객 ID

  • 이메일 주소

  • 계정 ID

  • 백엔드 작업 ID

  • 세션 범위 식별자(해당하는 경우)