AWS CodePipeline
- GitLab 16.5에 도입되었습니다.
GitLab 프로젝트를 사용하여 AWS CodePipeline을 사용하여 코드 변경 사항을 빌드, 테스트 및 배포할 수 있습니다. 이를 위해서 다음을 사용합니다:
- AWS CodeStar Connections를 사용하여 GitLab.com 계정을 AWS에 연결합니다.
- 그 연결을 사용하여 코드 변경에 따라 파이프라인을 자동으로 시작합니다.
AWS CodePipeline에서 GitLab으로 연결 생성
전제 조건:
- AWS CodePipeline과 연결할 GitLab 프로젝트에서 소유자 역할이 있어야 합니다.
- AWS에서 연결을 생성할 적절한 권한이 있어야 합니다.
- 지원되는 AWS 지역을 사용해야 합니다. 지원되지 않는 지역은 다음과 같습니다 (또한 AWS 문서에 나열됨):
- 아시아 태평양 (홍콩)
- 아프리카 (케이프타운)
- 중동 (바레인)
- 유럽 (취리히)
- AWS GovCloud (미국 서부 및 미국 동부)
GitLab.com의 프로젝트에 연결 생성하려면 AWS Management Console 또는 AWS Command Line Interface (AWS CLI)을 사용할 수 있습니다.
AWS Management Console 사용
AWS CodePipeline에서 새로운 또는 기존의 파이프라인을 GitLab.com과 연결하려면 먼저 AWS 연결을 GitLab 계정에서 사용하도록 허용하십시오.
- AWS Management Console에 로그인하고 AWS Developer Tools 콘솔을 엽니다.
- Settings > Connections > Create connection을 선택합니다.
- Select a provider에서 GitLab을 선택합니다.
- Connection name에 생성하려는 연결의 이름을 입력하고 Connect to GitLab을 선택합니다.
- GitLab 로그인 페이지에서 자격 증명을 입력하고 로그인을 선택합니다.
- 연결이 GitLab 계정에 액세스를 요청하는 메시지가 포함된 승인 페이지가 표시됩니다. 승인을 선택합니다.
- 브라우저는 연결 설정 화면으로 돌아갑니다. Create GitLab connection 섹션에서 새로운 연결이 Connection name에 표시됩니다.
- Connect to GitLab을 선택합니다. 연결이 성공적으로 생성되면 성공 배너가 표시됩니다. 연결 세부 정보는 Connection settings 페이지에 표시됩니다.
AWS CodeSuite를 GitLab.com에 연결했으므로 GitLab 프로젝트를 활용하는 AWS CodePipeline 파이프라인을 생성하거나 편집할 수 있습니다.
- AWS CodePipeline 콘솔에 로그인합니다.
- 파이프라인을 생성하거나 편집합니다:
- 파이프라인을 생성하는 경우:
- 첫 번째 화면의 필드를 작성하고 Next를 선택합니다.
- Source 페이지에서 Source Provider 섹션에서 GitLab을 선택합니다.
- 기존의 파이프라인을 편집하는 경우:
- Edit > Edit stage를 선택하여 소스 액션을 추가하거나 편집합니다.
- Edit action 페이지에서 Action name 섹션에 작업 이름을 입력합니다.
- Action provider에서 GitLab을 선택합니다.
- 파이프라인을 생성하는 경우:
- Connection에서 이전에 생성한 연결을 선택합니다.
- Repository name에서 GitLab 프로젝트의 이름을 선택하여 소스 변경을 감지할 브랜치를 지정합니다.
-
Output artifact format에서 아티팩트의 형식을 선택합니다. 다음을 저장합니다:
- 기본 방법을 사용하여 GitLab 액션에서 출력 아티팩트를 저장하려면 CodePipeline default를 선택합니다. 액션은 GitLab 리포지터리의 파일을 액세스하고 파이프라인 아티팩트 스토어에 ZIP 파일로 아티팩트를 저장합니다.
- 리포지터리를 URL 참조를 포함하는 JSON 파일로 저장하여 하위 작업이 Git 명령을 직접 실행할 수 있도록 하려면 Full clone을 선택합니다. 이 옵션은 CodeBuild 하위 작업에서만 사용할 수 있습니다. 이 옵션을 선택하려면 다음을 수행합니다:
- 소스 액션을 저장하고 계속합니다.
AWS CLI 사용
AWS CLI를 사용하여 연결을 생성하려면:
-
create-connection
명령을 사용하십시오. - AWS 콘솔에서 GitLab.com 계정을 인증하십시오.
- GitLab 프로젝트를 AWS CodePipeline에 연결하십시오.
create-connection
명령을 사용하려면:
-
터미널(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 엽니다. AWS CLI를 사용하여
create-connection
명령을 실행하여--provider-type
및--connection-name
을 지정합니다. 이 예에서는 제 3자 제공자 이름이GitLab
이고 지정된 연결 이름은MyConnection
입니다.aws codestar-connections create-connection --provider-type GitLab --connection-name MyConnection
성공하면 이 명령은 연결의 Amazon 리소스 이름 (ARN) 정보를 반환합니다. 예를 들면 다음과 같습니다:
{ "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f" }
-
새로운 연결은 기본적으로
PENDING
상태로 생성됩니다. 연결의 상태를AVAILABLE
로 변경하려면 콘솔을 사용하십시오. -
AWS 콘솔을 사용하여 연결을 완료하십시오. 보류 중인 GitLab 연결을 선택하십시오. Create connection을 선택하지 마십시오.