자습서: AWS AppConfig를 배포 공급자로 사용하는 파이프라인 생성 - AWS CodePipeline

자습서: AWS AppConfig를 배포 공급자로 사용하는 파이프라인 생성

이 자습서에서는 배포 단계에서 배포 작업 공급자로 AWS AppConfig를 사용하여 구성 파일을 지속적으로 제공하는 파이프라인을 구성합니다.

중요

파이프라인 생성의 일환으로 CodePipeline은 고객이 제공하는 S3 아티팩트 버킷을 아티팩트에 사용합니다. (이는 S3 소스 작업에 사용되는 버킷과 다릅니다.) S3 아티팩트 버킷이 파이프라인의 계정과 다른 계정에 있는 경우 안전하고 신뢰할 수 있는 AWS 계정에서 S3 아티팩트 버킷을 소유해야 합니다.

사전 조건

시작하기 전에 다음을 완료해야 합니다.

1단계: AWS AppConfig 리소스 생성

이 섹션에서는 다음 리소스를 생성합니다.

  • AWS AppConfig의 애플리케이션은 고객에게 기능을 제공하는 논리적 코드 단위입니다.

  • AWS AppConfig의 환경은 베타 또는 프로덕션 환경의 애플리케이션과 같은 AppConfig 대상의 논리적 배포 그룹입니다.

  • 구성 프로필은 애플리케이션의 동작에 영향을 미치는 설정의 모음입니다. 구성 프로파일을 통해 AWS AppConfig에서 저장된 위치의 구성에 액세스할 수 있습니다.

  • (선택 사항) AWS AppConfig의 배포 전략은 배포 중 특정 시점에 새로 배포된 구성을 수신해야 하는 클라이언트의 비율과 같은 구성 배포의 동작을 정의합니다.

애플리케이션, 환경, 구성 프로필 및 배포 전략을 생성하려면
  1. AWS Management Console에 로그인합니다.

  2. AWS AppConfig에서 리소스를 생성하려면 다음 주제의 단계를 사용합니다.

2단계: S3 소스 버킷에 파일 업로드

이 섹션에서 구성 파일을 생성합니다. 그런 다음 소스 파일을 압축하여 파이프라인이 소스 단계에 대해 사용하는 버킷으로 푸시합니다.

구성 파일을 생성하려면
  1. 각 리전의 각 구성에 대한 configuration.json 파일을 생성합니다. 다음 콘텐츠를 포함합니다.

    Hello World!
  2. 다음 단계를 사용하여 구성 파일을 압축하고 업로드하세요.

소스 파일을 압축하고 업로드하려면
  1. 파일이 포함된 .zip 파일을 생성하고 .zip 파일의 이름을 configuration-files.zip으로 지정합니다. 예를 들어 .zip 파일은 다음과 같은 구조를 사용할 수 있습니다.

    . └── appconfig-configurations └── MyConfigurations ├── us-east-1 │ └── configuration.json └── us-west-2 └── configuration.json
  2. 버킷의 Amazon S3 콘솔에서 업로드를 선택하고 지침을 따라 .zip 파일을 업로드합니다.

3단계: 파이프라인 생성

이 단원에서는 다음 작업을 통해 파이프라인을 생성합니다.

  • 소스 아티팩트가 구성용 파일인 Amazon S3 작업이 있는 소스 단계.

  • AppConfig 배포 작업이 적용된 배포 단계.

마법사를 사용하여 파이프라인을 생성하려면
  1. AWS Management Console에 로그인하여 http://console.aws.amazon.com/codesuite/codepipeline/home에서 CodePipeline 콘솔을 여세요.

  2. [Welcome] 페이지, [Getting started] 페이지 또는 [Pipelines] 페이지에서 Create pipeline(파이프라인 생성)을 선택합니다.

  3. 1단계: 생성 옵션 선택 페이지의 생성 옵션에서 사용자 지정 파이프라인 빌드 옵션을 선택합니다. Next(다음)를 선택합니다.

  4. 2단계: 파이프라인 설정 선택파이프라인 이름MyAppConfigPipeline을 입력합니다.

  5. CodePipeline은 특성과 가격이 다른 V1 및 V2 유형 파이프라인을 제공합니다. V2 유형은 콘솔에서 선택할 수 있는 유일한 유형입니다. 자세한 내용은 파이프라인 유형을 참조하세요. CodePipeline에 대한 요금 정보는 요금을 참조하세요.

  6. 서비스 역할에서 새 서비스 역할을 선택하여CodePipeline이 IAM에 서비스 역할을 생성하도록 허용합니다.

  7. [Advanced settings]의 설정은 기본값 그대로 두고, [Next]를 선택합니다.

  8. 3단계: 소스 스테이지 추가소스 공급자에서 Amazon S3를 선택합니다. 버킷에서 S3 소스 버킷의 이름을 선택합니다.

    S3 객체 키에 .zip 파일: configuration-files.zip의 이름을 입력합니다.

    Next(다음)를 선택합니다.

  9. 4단계: 빌드 스테이지 추가에서 빌드 스테이지 건너뛰기를 선택하고 건너뛰기를 다시 선택하여 경고 메시지를 수락합니다.

    Next(다음)를 선택합니다.

  10. 5단계: 배포 스테이지 추가에서 다음과 같이 합니다.

    1. 배포 공급자에서 AWS AppConfig를 선택합니다.

    2. 애플리케이션에서 AWS AppConfig에서 만든 애플리케이션의 이름을 선택합니다. 필드에 애플리케이션의 ID가 표시됩니다.

    3. 환경에서 AWS AppConfig에서 만든 환경의 이름을 선택합니다. 필드에 환경의 ID가 표시됩니다.

    4. 구성 프로필에서 AWS AppConfig에서 만든 구성 프로필의 이름을 선택합니다. 필드에 구성 프로필의 ID가 표시됩니다.

    5. 배포 전략에서 배포 전략의 이름을 선택합니다. 이것은 AppConfig에서 만든 배포 전략이거나 AppConfig에서 미리 정의된 배포 전략 중에서 선택한 전략일 수 있습니다. 필드에는 배포 전략의 ID가 표시됩니다.

    6. 입력 아티팩트 구성 경로에 파일 경로를 입력합니다. 입력 아티팩트 구성 경로가 S3 버킷 .zip 파일의 디렉터리 구조와 일치하는지 확인하세요. 이 예제에서는 파일 경로(appconfig-configurations/MyConfigurations/us-west-2/configuration.json)를 입력합니다.

    7. Next(다음)를 선택합니다.

  11. 6단계: 검토에서 정보를 검토한 다음, 파이프라인 생성을 선택합니다.

4단계: 모든 소스 파일을 변경하고 배포 확인

소스 파일을 변경하고 변경 사항을 버킷에 업로드합니다. 이렇게 하면 파이프라인이 실행됩니다. 버전을 확인하여 구성을 사용할 수 있는지 확인하세요.