` | 개발자 |
### 마이크로서비스를 위한 새 파이프라인 추가
| 작업 | 설명 | 필요한 기술 |
| --- | --- | --- |
| 애플리케이션 디렉터리에 샘플 코드를 추가합니다. | 샘플 애플리케이션 코드가 들어 있는 디렉터리를 복제된 GitHub [AWS CodeCommit 모노리포지토리 다중 파이프라인 트리거](https://github.com/aws-samples/monorepo-multi-pipeline-trigger) 리포지토리의 `monorepo-sample` 디렉터리에 추가합니다. | 개발자 |
| `monorepo-main.json` 파일을 편집합니다. | 애플리케이션 코드의 디렉터리 이름과 파이프라인 이름을 복제된 리포지토리의 `monorepo-main.json` 파일에 추가합니다. | 개발자 |
| 파이프라인을 생성하십시오. | 리포지토리의 `Pipelines` 디렉터리에 애플리케이션의 `class` 파이프라인을 추가합니다. 디렉터리에는 `pipeline_hotsite.py` 및 라는 두 개의 샘플 파일이 포함되어 있습니다`pipeline_demo.py`. 각 파일에는 소스, 빌드 및 배포라는 세 단계가 있습니다.
애플리케이션 요구 사항에 따라 파일 중 하나를 복사하고 변경할 수 있습니다. | 개발자 |
| `monorepo_config.py` 파일을 편집합니다. | `service_map`에서 애플리케이션의 디렉터리 이름과 파이프라인용으로 만든 클래스를 추가합니다.
예를 들어, 다음 코드는 `MySamplePipeline` 클래스로 이름이 `pipeline_mysample.py`로 지정된 파일을 사용하는 `Pipelines` 디렉터리의 파이프라인 정의를 보여줍니다....
# Pipeline definition imports
from pipelines.pipeline_demo import DemoPipeline
from pipelines.pipeline_hotsite import HotsitePipeline
from pipelines.pipeline_mysample import MySamplePipeline
### Add your pipeline configuration here
service_map: Dict[str, ServicePipeline] = {
# folder-name -> pipeline-class
'demo': DemoPipeline(),
'hotsite': HotsitePipeline(),
'mysample': MySamplePipeline()
}
| 개발자 |
### MonoRepoStack 스택 배포
| 작업 | 설명 | 필요한 기술 |
| --- | --- | --- |
| AWS CloudFormation 스택을 배포합니다. | `make deploy-core` 명령을 실행하여 복제된 AWS CloudFormation `MonoRepoStack`리포지토리의 루트 디렉터리에 기본 파라미터 값을 사용하여 스택을 배포합니다.
`make deploy-core monorepo-name=` 명령을 실행하여 리포지토리 이름을 변경할 수 있습니다.`make deploy monorepo-name=` 명령을 사용하여 두 파이프라인을 동시에 배포할 수 있습니다. | 개발자 |
| CodeCommit 리포지토리를 확인합니다. | `aws codecommit get-repository --repository-name ` 명령을 실행하여 리소스가 생성되었는지 확인합니다. CloudFormation 스택은 모노 리포지토리가 저장되는 CodeCommit 리포지토리를 생성하기 때문에 수정 내용을 푸시하기 시작한 경우 `cdk destroy MonoRepoStack `명령을 실행하지 마십시오. | 개발자 |
| CloudFormation 스택 결과를 검증합니다. | 다음 명령을 실행하여 스택이 CloudFormation `MonoRepoStack` 올바르게 생성되고 구성되었는지 확인합니다.aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE --query 'StackSummaries[?StackName == 'MonoRepoStack']'
| 개발자 |
### PipelinesStack 스택 배포
| 작업 | 설명 | 필요한 기술 |
| --- | --- | --- |
| CloudFormation 스택을 배포합니다. | 스택을 AWS CloudFormation `PipelinesStack` 배포한 후에는 `MonoRepoStack` 스택을 배포해야 합니다. 새 마이크로서비스가 모노리포지토리의 코드 베이스에 추가되면 스택의 크기가 증가하고 새 마이크로서비스가 온보딩되면 재배포됩니다.
`make deploy-pipelines` 명령을 실행하여 PipelinesStack 스택을 배포합니다.`make deploy monorepo-name=` 명령을 실행하여 두 파이프라인을 동시에 배포할 수도 있습니다.
다음 샘플 출력은 구현 종료 시 `PipelinesStacks` 배포가 마이크로서비스의 URL을 인쇄하는 방법을 보여줍니다.Outputs:
PipelinesStack.demourl = .cloudfront.net
PipelinesStack.hotsiteurl = .cloudfront.net
| 개발자 |
| AWS CloudFormation 스택 결과를 검증합니다. | 다음 명령을 실행하여 스택이 AWS CloudFormation `PipelinesStacks` 올바르게 생성되고 구성되었는지 확인합니다.aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE UPDATE_COMPLETE --query 'StackSummaries[?StackName == 'PipelinesStack']'
| 개발자 |
### 리소스 정리
| 작업 | 설명 | 필요한 기술 |
| --- | --- | --- |
| AWS CloudFormation 스택을 삭제합니다. | `make destroy` 명령을 실행합니다. | 개발자 |
| 파이프라인의 S3 버킷을 삭제하십시오. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html) | 개발자 |
## 문제 해결
| 문제 | Solution |
| --- | --- |
| AWS CDK 문제가 발생했습니다. | AWS CDK 설명서의 [일반적인 AWS CDK 문제 해결을](https://docs.aws.amazon.com/cdk/v2/guide/troubleshooting.html) 참조하세요. |
| 마이크로서비스 코드를 푸시했지만 마이크로서비스 파이프라인이 실행되지 않았습니다. | **설정 검증**
*브랜치 구성을 확인합니다.*[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
*구성 파일 검증:*[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
**콘솔 문제 해결**
*AWS CodePipeline 검사:*[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
*AWS Lambda 문제 해결:*[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html) |
| 모든 마이크로서비스를 재배포해야 합니다. | 모든 마이크로서비스를 강제로 재배포하려면 두 가지 접근 방식이 있습니다. 요구 사항에 맞는 옵션을 선택합니다.
**접근 방식 1: 파라미터 스토어에서 파라미터 삭제**
이 방법에는 배포에 사용된 마지막 커밋 ID를 추적하는 Systems Manager Parameter Store 내에서 특정 파라미터를 삭제하는 작업이 포함됩니다. 이 파라미터를 제거하면 시스템은 새 상태로 인식되므로 다음 트리거 시 모든 마이크로서비스를 다시 배포해야 합니다.
단계:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
장점:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
단점:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
**접근 방식 2: 각 모노 리포지토리 하위 폴더에서 커밋 푸시**
이 방법에는 사소한 변경을 수행하고 모노레포 내의 각 마이크로서비스 하위 폴더에 푸시하여 개별 파이프라인을 시작하는 작업이 포함됩니다.
단계:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
장점:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
단점:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html) |
## 관련 리소스
+ [CDK Pipelines을 사용한 지속적 통합 및 전송(CI/CD)](https://docs.aws.amazon.com/cdk/latest/guide/cdk_pipeline.html)(AWS CDK 문서화)
+ [aws-cdk/pipelines 모듈](https://docs.aws.amazon.com/cdk/api/latest/docs/pipelines-readme.html)(AWS CDK API 참조)