AWS CodePipeline

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

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

  • 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 계정에 권한 부여해야 합니다.

  1. AWS Management Console에 로그인하고 AWS Developer Tools 콘솔을 엽니다.
  2. 설정 > 연결 > 연결 생성을 선택합니다.
  3. 공급업체 선택에서 GitLab을 선택합니다.
  4. 연결 이름에 생성하려는 연결의 이름을 입력하고 GitLab에 연결을 선택합니다.
  5. GitLab 로그인 페이지에서 자격 증명을 입력하고 로그인을 선택합니다.
  6. 연결이 GitLab 계정에 액세스 권한을 요청하는 메시지가 포함된 인증 페이지가 표시됩니다. 인증을 선택합니다.
  7. 브라우저가 연결 콘솔 페이지로 돌아갑니다. GitLab 연결 생성 섹션에서 새로운 연결이 연결 이름에 표시됩니다.
  8. GitLab에 연결을 선택합니다. 연결이 성공적으로 생성된 후에는 성공 배너가 표시됩니다. 연결 세부 정보는 연결 설정 페이지에 표시됩니다.

AWS CodeSuite를 GitLab.com에 연결했으므로 GitLab 프로젝트를 활용한 AWS CodePipeline을 생성하거나 편집할 수 있습니다.

  1. AWS CodePipeline 콘솔에 로그인합니다.
  2. 파이프라인을 생성하거나 편집합니다:
    • 파이프라인을 생성하는 경우:
      • 첫 번째 화면의 필드를 작성하고 다음을 선택합니다.
      • 소스 페이지에서 소스 제공자 섹션에서 GitLab을 선택합니다.
    • 기존 파이프라인을 편집하는 경우:
      • 편집 > 단계 편집을 선택하여 소스 작업을 추가하거나 편집합니다.
      • 작업 이름 섹션에서 작업 이름을 입력합니다.
      • 작업 제공자에서 GitLab을 선택합니다.
  3. 연결에서 이전에 생성한 연결을 선택합니다.
  4. 리포지터리 이름에서 GitLab 프로젝트의 이름을 선택하여 파이프라인이 소스 변경을 감지할 브랜치를 지정합니다. 브랜치 이름이 자동으로 표시되지 않는 경우 다음 사항 중 하나 때문일 수 있습니다:
    • 프로젝트의 소유자 역할이 없는 경우
    • 프로젝트 이름이 유효하지 않은 경우
    • 사용된 연결에 프로젝트에 액세스할 수 없는 경우
  5. 출력 아티팩트 형식에서 아티팩트의 형식을 선택합니다.:
  6. 소스 작업을 저장하고 계속합니다.

AWS CLI 사용

AWS CLI를 사용하여 연결을 생성하려면:

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

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

  1. 터미널(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"
    }
    
  2. 새 연결은 기본적으로 PENDING 상태로 생성됩니다. 연결의 상태를 AVAILABLE로 변경하려면 콘솔을 사용하십시오.

  3. 연결을 완료하기 위해 AWS Console를 사용합니다. 보류 중인 GitLab 연결을 선택해야 합니다. 연결 생성을 선택하지 마십시오.

관련 주제