AWS CodeBuild
사용 설명서 (API 버전 2016-10-06)

AWS CodeBuild용 빌드 계획

CodeBuild로 빌드를 실행하기 전에 다음 질문에 답해야 합니다.

  1. 소스 코드가 어디에 있습니까? CodeBuild는 현재 다음 소스 코드 리포지토리 공급자로부터의 빌드를 지원합니다. 소스 코드에 빌드 사양이 포함되어 있거나, 빌드 프로젝트 정의의 일부로 빌드 사양이 선언되어 있어야 합니다. 빌드 사양은 CodeBuild가 빌드를 실행하는 데 사용하는 YAML 형식의 빌드 명령 및 관련 설정의 모음입니다.

    리포지토리 공급자 필수 설명서
    CodeCommit

    리포지토리 이름.

    (선택 사항) 소스 코드와 연결된 커밋 ID.

    CodeCommit 사용 설명서에서 다음 주제를 참조하십시오.

    CodeCommit 리포지토리 생성

    CodeCommit에 커밋 생성

    Amazon S3

    입력 버킷 이름.

    소스 코드가 포함된 빌드 입력 ZIP 파일에 해당하는 객체 이름.

    (선택 사항) 빌드 입력 ZIP 파일에 연결된 버전 ID.

    Amazon S3 시작 안내서에서 다음 주제를 참조하십시오.

    버킷 만들기

    버킷에 객체 추가

    GitHub

    리포지토리 이름.

    (선택 사항) 소스 코드와 연결된 커밋 ID.

    GitHub Help 웹 사이트에서 다음 주제를 참조하십시오.

    리포지토리 생성

    Bitbucket

    리포지토리 이름.

    (선택 사항) 소스 코드와 연결된 커밋 ID.

    Bitbucket Cloud 설명서 웹 사이트에서 다음 주제를 참조하십시오.

    리포지토리 생성

  2. 어떤 빌드 명령을 실행해야 하며 어떤 순서로 실행해야 합니까? 기본적으로 CodeBuild는 사용자가 지정한 공급자로부터 빌드 입력을 다운로드하고 사용자가 지정한 버킷에 빌드 출력을 업로드합니다. 빌드 사양을 사용하면 다운로드된 빌드 입력을 원하는 빌드 출력으로 전환하는 방법을 지시할 수 있습니다. 자세한 정보는 빌드 사양 참조 단원을 참조하십시오.

  3. 빌드를 실행하는 데 어떤 런타임 및 도구가 필요합니까? 예를 들어 Java, Ruby, Python 또는 Node.js 중 어떤 용도로 빌드하고 있습니까? 빌드에 Maven이나 Ant 또는 Java, Ruby, Python용 컴파일러가 필요합니까? 빌드에 Git, AWS CLI 또는 다른 도구가 필요합니까?

    CodeBuild는 Docker 이미지를 사용하는 빌드 환경에서 빌드를 실행합니다. 이러한 Docker 이미지는 CodeBuild가 지원하는 리포지토리 유형에 저장되어 있어야 합니다. 여기에는 CodeBuild Docker 이미지 리포지토리, Docker Hub 및 Amazon Elastic Container Registry(Amazon ECR)가 포함됩니다. CodeBuild Docker 이미지 리포지토리에 대한 자세한 내용은 CodeBuild가 제공하는 Docker 이미지 단원을 참조하십시오.

    중요

    Ubuntu 표준 이미지 2.0 이상 또는 Amazon Linux 2(AL2) 표준 이미지 1.0 이상을 사용하는 경우 buildspec 파일에서 runtime-versions을 지정해야 합니다. 자세한 내용은 Buildspec 파일의 런타임 버전 지정 단원을 참조하십시오.

  4. CodeBuild가 자동으로 제공하지 않는 AWS 리소스가 필요합니까? 그렇다면 해당 리소스에는 어떤 보안 정책이 필요합니까? 예를 들어, CodeBuild가 해당 리소스와 함께 작동하는 것을 허용하도록 CodeBuild 서비스 역할을 수정해야 할 수 있습니다.

  5. CodeBuild를 사용하여 VPC에서 작업을 수행하려고 하십니까? 그렇다면 VPC 구성에 대한 VPC ID, 서브넷 ID 및 보안 그룹 ID가 필요합니다. 자세한 내용은 CodeBuild을 Amazon Virtual Private Cloud와 함께 사용 단원을 참조하십시오.

위의 질문에 답을 했다면 빌드를 성공적으로 실행하는 데 필요한 설정 및 리소스가 확인되었을 것입니다. 빌드를 실행하려면 다음을 수행하면 됩니다.

  • CodeBuild 콘솔, AWS CLI 또는 AWS SDK를 사용합니다. 자세한 내용은 AWS CodeBuild 직접 실행 단원을 참조하십시오.

  • AWS CodePipeline에 파이프라인을 생성하거나 지정한 다음 CodeBuild에게 코드 테스트나 빌드 실행 또는 둘 다를 자동으로 수행하도록 지시하는 빌드 또는 테스트 작업을 추가합니다. 자세한 내용은 AWS CodePipeline을 CodeBuild와 함께 사용 단원을 참조하십시오.