AWS Service Catalog 및를 사용하여 Gitflow 환경에 핫픽스 솔루션을 배포하기 위한 동적 파이프라인 관리 자동화 AWS CodePipeline

각 워크로드 계정(스테이지, 프로덕션 및 선택적 QA)에 CloudFormation 템플릿을 패키징하려면 다음 명령을 사용합니다. 다음 명령에서 S3bucketpackage를 패키징에 사용할 Amazon S3 버킷 이름으로 바꿉니다.

#InStageAccount
aws cloudformation package \
    --template-file pre-requisites/infrastack.yaml \
    --s3-bucket <S3bucketpackage> \
    --s3-prefix infraStack \
    --region ${DepRegion} \
    --output-template-file pre-requisites/infrastructure_stage.template

#InProdAccount
aws cloudformation package \
    --template-file pre-requisites/infrastack.yaml \
    --s3-bucket <S3bucketpackage> \
    --s3-prefix infraStack \
    --region ${DepRegion} \
    --output-template-file pre-requisites/infrastructure_prod.template

각 워크로드 계정에 CloudFormation 템플릿을 배포하려면 다음 명령을 사용합니다.

#InStageAccount
aws cloudformation deploy --stack-name inframainstack \
--parameter-overrides  ApplicationName=${ApplicationName} ToolsAccount=${ToolsAccount} DepRegion=${DepRegion} \
--template-file pre-requisites/infrastructure_stage.template  --region ${DepRegion} --capabilities CAPABILITY_NAMED_IAM

#InProdAccount
aws cloudformation deploy --stack-name inframainstack \
--parameter-overrides  ApplicationName=${ApplicationName} ToolsAccount=${ToolsAccount} DepRegion=${DepRegion} \
--template-file pre-requisites/infrastructure_prod.template  --region ${DepRegion} --capabilities CAPABILITY_NAMED_IAM

템플릿 pipeline-main.yaml 및 pipeline-hotfix.yaml을 CodePipeline 디렉터리의 리포지토리에서 (Bucketname)에 배포하려는 리전의 기존 Amazon S3 버킷()으로 업로드합니다DepRegion.

#InToolsAccount
aws s3 cp ./codepipeline/pipeline-main.yaml s3://<Bucketname>/pipeline-main.yaml
aws s3 cp ./codepipeline/pipeline-hotfix.yaml s3://<Bucketname>/pipeline-hotfix.yaml

및 hotfix브랜치의 파이프라인을 관리할 Service Catalog 포트폴리오 main 및 제품을 설정합니다. 다음 스택의 MainProductId 및에 대한 Outputs 섹션의 세부 정보를 기록MainProductArtifactId해 둡니다. 이 정보는 main브랜치에 대한 파이프라인 설정 중 이후 단계에서 필요합니다.

#InToolsAccount
aws cloudformation deploy \
    --template-file pre-requisites/servicecatalogsetup.yaml \
    --stack-name servicecatalogsetup \
    --parameter-overrides TemplateBucket=<Bucketname> \
    --capabilities CAPABILITY_IAM CAPABILITY_NAMED_IAM --region ${DepRegion}

도구 계정의 리소스를 Service Catalog 포트폴리오 기본 파이프라인 포트폴리오에 배포하는 IAM 역할에 대한 액세스 권한을 제공합니다. 이 포트폴리오를 사용하여 main브랜치를 사용하여 애플리케이션을 배포합니다. 액세스를 제공하는 방법에 대한 자세한 내용은 Service Catalog 설명서의 사용자에게 액세스 권한 부여를 참조하세요.

Lambda 함수에 대한 IAM 역할 및 권한을 생성하려면 다음 명령을 사용하여 CloudFormation 스택을 배포합니다.

#InToolsAccount aws cloudformation deploy \ --template-file pre-requisites/lambdasetup.yaml \ --stack-name prsclambdasetup \ --capabilities CAPABILITY_IAM CAPABILITY_NAMED_IAM --region ${DepRegion}

스택 배포 후를 사용하여 Service Catalog 포트폴리오 핫픽스 파이프라인 포트폴리오에 대한 hotfix-lambda-execution-role 액세스 권한을 부여합니다AWS Management Console. 이 액세스를 통해 Lambda 함수는 핫픽스 브랜치에 대한 Service Catalog 제품을 시작하거나 종료할 수 있습니다.

사전 요구 사항에서 생성된 CodeCommit 리포지토리를 복제하려면 git clone 명령을 사용합니다. 자세한 내용은 CodeCommit 설명서에 설명된 대로 리포지토리를 복제하여 CodeCommit 리포지토리에 연결을 참조하세요. CodeCommit

리포지토리에서 사용할 수 있는 repotemplates 디렉터리의 모든 애플리케이션 파일을 로컬 리포지토리 복제본(${ApplicationName}-repository)에 복사합니다. 다음 파일을 수정하여 ToolsAccount ID를 업데이트합니다. 각 파일에서 RegistryAccountid 파라미터를 찾고 해당 값을 ToolsAccount ID로 설정합니다. 변경 사항을 CodeCommit 리포지토리에 커밋하고 파일을 main 및 develop브랜치 모두에 푸시합니다.

애플리케이션 배포를 확인하려면를 사용하여 CodePipeline 실행을 모니터링합니다 AWS Management Console. 배포가 완료되면 스테이지 환경에서 Application Load Balancer FQDN을 사용하여 애플리케이션에 액세스합니다. 애플리케이션이 예상대로 작동하는지 확인합니다.

프로덕션에 대한 배포를 승인하려면 CodePipeline 콘솔을 사용하여 애플리케이션의 파이프라인을 찾습니다. ApprovalToStart 스테이지를 찾습니다. 변경 사항을 검토하고 만족스러우면 프로덕션 배포를 진행하기 위한 수동 승인을 제공합니다.

키워드 로 시작하는 이름을 사용하여 브랜치를 생성합니다hotfix. 예를 들어이 패턴은 CodeCommit 애플리케이션 리포지토리()의 hotfix-check1브랜치를 사용합니다${ApplicationName}-repository. 자세한 단계는 CodeCommit 설명서의 AWS CodeCommit 리포지토리에 연결 및 Basic Git 명령을 참조하세요.

Service Catalog 제품이 hotfix-check1브랜치에 대해 동적으로 성공적으로 프로비저닝Hotfix CICD Pipeline되었는지 확인합니다. 프로비저닝된 제품 이름은이 핫픽스 브랜치 이름과 애플리케이션의 CodeCommit 리포지토리 이름의 이름을 따릅니다.

index.html 파일에서 일부 사소한 변경 사항을 커밋하고 CodeCommit 리포지토리로 푸시합니다.

스테이지 환경에서 CodePipeline 실행이 성공했는지 확인합니다. 프로덕션 환경에 배포하려면 CodePipeline에서 수동 승인을 제공합니다.

Application Load Balancer FQDN(정규화된 도메인 이름)을 사용하여 애플리케이션 홈 페이지에 변경 사항이 표시되는지 확인합니다. FQDN은의 Outputs 섹션에서 사용할 수 있습니다inframainstack-ALBStack-*.

CodeCommit 애플리케이션 리포지토리에 있는 hotfix-check1브랜치를 삭제합니다.

hotfix-check1 브랜치에 프로비저닝된 Service Catalog 제품이 성공적으로 종료되었는지 확인합니다.

워크로드 계정에서 Amazon ECS 서비스를 0개의 복제본으로 축소하려면 다음 명령을 사용합니다.

aws ecs update-service --cluster ${ApplicationName}-Cluster --service ${ApplicationName}-Service-stage --desired-count 0 --region ${DepRegion}
aws ecs update-service --cluster ${ApplicationName}-Cluster --service ${ApplicationName}-Service-prod --desired-count 0 --region ${DepRegion}

main 브랜치에 프로비저닝된 Service Catalog 제품을 종료합니다.

도구 계정의 Amazon S3 버킷에서 생성된 객체를 정리합니다. 레지스트리 자체를 삭제하기 전에 Amazon ECR에서 모든 Docker 이미지를 삭제합니다.

Service Catalog 포트폴리오를 삭제하기 전에 Service Catalog 포트폴리오의 액세스 권한 부여 섹션에서 IAM 역할을 제거합니다.

도구 계정 및 워크로드 계정에 배포된 CloudFormation 스택을 삭제합니다.