AWS CodePipeline

Tier: Free, Premium, Ultimate Offering: GitLab.com

당신은 AWS CodePipeline을 사용하여 GitLab 프로젝트를 사용하여 코드 변경 사항을 빌드, 테스트 및 배포할 수 있습니다. 이를 위해 다음을 사용합니다:

  • AWS CodeStar Connections를 사용하여 GitLab.com 계정을 AWS에 연결합니다.
  • 해당 연결을 사용하여 코드 변경에 따라 파이프라인을 자동으로 시작합니다.

AWS CodePipeline에서 GitLab으로 연결 생성하기

필수 사항:

  • AWS CodePipeline과 연결할 GitLab 프로젝트에 Owner 역할이 있어야 합니다.
  • AWS에서 연결을 생성할 적절한 권한이 있어야 합니다.
  • 지원되는 AWS 지역을 사용하여야 합니다. 비지원되는 지역들(또한 AWS 문서에 나와 있음)은:
    • Asia Pacific (홍콩)
    • 아프리카 (케이프타운)
    • 중동 (바레인)
    • 유럽 (취리히)
    • AWS GovCloud (미국 서부 및 미국 동부)

GitLab.com의 프로젝트에 연결을 생성하려면 AWS Management Console 또는 AWS Command Line Interface (AWS CLI) 중 하나를 사용할 수 있습니다.

AWS Management Console 사용

AWS CodePipeline에서 GitLab.com과 새로운 또는 기존의 파이프라인을 연결하려면 먼저 AWS 연결에 GitLab 계정을 허용하세요.

  1. AWS Management Console에 로그인하고 AWS 개발자 도구 콘솔을 엽니다.
  2. Settings > Connections > Create connection을 선택합니다.
  3. Select a provider에서 GitLab을 선택합니다.
  4. Connection name에 생성할 연결의 이름을 입력하고 Connect to GitLab을 선택합니다.
  5. GitLab 로그인 페이지에서 자격 증명을 입력하고 로그인을 선택합니다.
  6. 연결이 권한을 부여할 메시지를 포함한 승인 페이지가 표시됩니다. Authorize를 선택합니다.
  7. 브라우저가 연결 콘솔 페이지로 돌아갑니다. Create GitLab connection 섹션에서 새로운 연결이 Connection name에 표시됩니다.
  8. Connect to GitLab을 선택합니다. 연결이 성공적으로 생성되면 성공 배너가 표시됩니다. 연결 세부 정보는 Connection settings 페이지에 표시됩니다.

이제 AWS CodeSuite를 GitLab.com에 연결했으므로, GitLab 프로젝트를 활용하는 AWS CodePipeline의 파이프라인을 생성하거나 편집할 수 있습니다.

  1. AWS CodePipeline 콘솔에 로그인합니다.
  2. 파이프라인을 생성하거나 편집합니다:
    • 파이프라인을 생성하는 경우:
      • 첫 번째 화면의 필드를 완료한 후 다음을 선택합니다.
      • Source 페이지에서 Source Provider 섹션에서 GitLab을 선택합니다.
    • 기존 파이프라인을 편집하는 경우:
      • Edit > Edit stage를 선택하여 소스 작업을 추가하거나 편집합니다.
      • Edit action 페이지에서 Action name 섹션에 작업 이름을 입력합니다.
      • Action provider에서 GitLab을 선택합니다.
  3. Connection에서 이전에 생성한 연결을 선택합니다.
  4. Repository name에서 GitLab 프로젝트의 이름을 선택하여 코드 변경을 감지할 파이프라인 브랜치를 지정합니다. 브랜치 이름이 자동으로 채워지지 않는 경우, 다음 중 하나 때문일 수 있습니다:
    • 프로젝트에 Owner 역할이 없음.
    • 프로젝트 이름이 잘못되었음.
    • 사용된 연결이 프로젝트에 액세스 권한이 없음.
  5. Output artifact format에서 아티팩트의 형식을 선택합니다. 다음을 저장합니다:
  6. 소스 작업을 저장하고 계속합니다.

AWS CLI 사용하기

AWS CLI를 사용하여 연결을 생성하려면 다음 단계를 따르세요:

  • create-connection 명령을 사용합니다.
  • AWS 콘솔로 이동하여 GitLab.com 계정으로 인증합니다.
  • GitLab 프로젝트를 AWS CodePipeline에 연결합니다.

create-connection 명령을 사용하려면:

  1. 터미널 (Linux, macOS 또는 Unix) 또는 명령 프롬프트 (Windows)를 엽니다. AWS CLI를 사용하여 create-connection 명령을 실행하고, 연결에 대한 --provider-type 및 --connection-name을 지정합니다. 이 예에서, 써드파티 제공업체 이름은 GitLab이고 지정된 연결 이름은 MyConnection입니다. 

    aws codestar-connections create-connection --provider-type GitLab --connection-name MyConnection

    성공적으로 실행되면, 이 명령은 연결의 아마존 리소스 이름 (ARN) 정보를 반환합니다. 예를 들어: 

    {
"ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}

  2. 새로운 연결은 기본적으로 PENDING 상태로 생성됩니다. 연결의 상태를 AVAILABLE로 변경하려면 콘솔을 사용하세요.

  3. AWS 콘솔을 사용하여 연결을 완료합니다. 보류 중인 GitLab 연결을 선택해야 합니다. 연결 생성을 선택하지 마세요.

관련 주제