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 계정에 액세스 권한을 요청하는 메시지가 있는 승인 페이지가 표시됩니다. Authorize를 선택합니다.
- 브라우저가 연결 콘솔 페이지로 돌아갑니다. 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 명령을 수행할 수 있도록 하는 경우 전체 클론을 선택합니다. 이 옵션은 CodeBuild 하향식 작업에서만 사용할 수 있습니다. 이 옵션을 선택하려면:
- 소스 액션을 저장하고 계속합니다.
AWS CLI 사용
AWS CLI를 사용하여 연결을 생성하려면:
-
create-connection
명령어를 사용합니다. - AWS 콘솔로 이동하여 GitLab.com 계정으로 인증합니다.
- GitLab 프로젝트를 AWS CodePipeline에 연결합니다.
create-connection
명령을 사용하려면:
-
터미널(Linux, macOS 또는 Unix)이나 명령 프롬프트(Windows)를 엽니다.
create-connection
명령을 사용하여--provider-type
및--connection-name
을 지정합니다. 이 예에서는 타사 공급자 이름이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을 선택하지 마십시오.