AWS CodeBuild 에이전트를 사용하여 로컬에서 빌드 실행 - AWS CodeBuild
필수 조건빌드 이미지 설정CodeBuild 에이전트 실행새 CodeBuild 에이전트 버전에 대한 알림 받기

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS CodeBuild 에이전트를 사용하여 로컬에서 빌드 실행

로컬 시스템에서 AWS CodeBuild 에이전트를 사용하여 CodeBuild 빌드를 실행할 수 있습니다. x86_64 및 ARM 플랫폼에 사용할 수 있는 에이전트가 있습니다.

새 버전의 에이전트가 게시되는 시기를 알 수 있도록 알림을 구독할 수도 있습니다.

필수 조건

시작하려면 다음을 수행해야 합니다.

  • 로컬 시스템에 Git를 설치합니다.

  • 로컬 컴퓨터에 Docker를 설치하고 설정합니다.

빌드 이미지 설정

에이전트를 처음 실행할 때 또는 이미지가 변경된 경우에만 빌드 이미지를 설정해야 합니다.

빌드 이미지를 설정하려면

  1. 큐레이트된 Amazon Linux 2 이미지를 사용하려면 다음 명령을 사용하여 CodeBuild 퍼블릭 Amazon ECR 리포지토리 https://gallery.ecr.aws/codebuild/amazonlinux2-x86_64-standard에서 이미지를 끌어올 수 있습니다.

    $ docker pull public.ecr.aws/codebuild/amazonlinux2-x86_64-standard:4.0

    다른 Linux 이미지를 사용하려면 다음 단계를 수행합니다.

    1. CodeBuild 이미지 리포지토리를 복제합니다.

      $ git clone https://github.com/aws/aws-codebuild-docker-images.git

    2. image 디렉터리로 변경합니다. 이 예에서는 aws/codebuild/standard:5.0 이미지를 사용합니다.

      $ cd aws-codebuild-docker-images/ubuntu/standard/5.0

    3. 이미지를 빌드합니다. 이 작업은 몇 분 정도 걸릴 수 있습니다.

      $ docker build -t aws/codebuild/standard:5.0 .

  2. CodeBuild 에이전트를 다운로드합니다.

    x86_64 버전의 에이전트를 다운로드하려면 다음 명령을 실행합니다.

    $ docker pull public.ecr.aws/codebuild/local-builds:latest

    ARM 버전의 에이전트를 다운로드하려면 다음 명령을 실행합니다.

    $ docker pull public.ecr.aws/codebuild/local-builds:aarch64

  3. CodeBuild 에이전트는 https://gallery.ecr.aws/codebuild/local-builds에서 사용할 수 있습니다.

    에이전트의 x86_64 버전에 대한 보안 해시 알고리즘(SHA) 서명은 다음과 같습니다.

    sha256:fac17c6d6c3cb500f6e7975887de1e41d29a9e70a86d6f49f76a2beacfcf967e

    에이전트의 ARM 버전에 대한 SHA 서명은 다음과 같습니다.

    sha256:57a5dfda63be50edce13dea16dcd5e73e8d8559029658ba08b793c9a7adc68c7

    SHA를 사용하여 에이전트 버전을 확인할 수 있습니다. 에이전트의 SHA 서명을 보려면 다음 명령을 실행하고 RepoDigests에서 SHA를 찾습니다.

    $ docker inspect public.ecr.aws/codebuild/local-builds:latest

CodeBuild 에이전트 실행

CodeBuild 에이전트를 실행하려면

  1. 빌드 프로젝트 소스가 들어 있는 디렉터리로 변경합니다.

  2. codebuild_build.sh 스크립트를 다운로드합니다.

    $ curl -O  https://raw.githubusercontent.com/aws/aws-codebuild-docker-images/master/local_builds/codebuild_build.sh
$ chmod +x codebuild_build.sh

  3. codebuild_build.sh 스크립트를 실행하고 컨테이너 이미지와 출력 디렉터리를 지정합니다.

    x86_64 빌드를 실행하려면 다음 명령을 실행합니다.

    $ ./codebuild_build.sh -i <container-image> -a <output directory>

    ARM 빌드를 실행하려면 다음 명령을 실행합니다.

    $ ./codebuild_build.sh -i <container-image> -a <output directory> -l public.ecr.aws/codebuild/local-builds:aarch64

    <container-image>를 컨테이너 이미지의 이름(예: aws/codebuild/standard:5.0 또는 public.ecr.aws/codebuild/amazonlinux2-x86_64-standard:4.0)으로 바꿉니다.

    스크립트는 빌드 이미지를 시작하고 현재 디렉터리의 프로젝트에서 빌드를 실행합니다. 빌드 프로젝트의 위치를 지정하려면 스크립트 명령에 -s <build project directory> 옵션을 추가합니다.

새 CodeBuild 에이전트 버전에 대한 알림 받기

새 버전의 AWS CodeBuild 에이전트가 릴리스되는 시기를 알 수 있도록 Amazon SNS 알림을 구독할 수 있습니다.

CodeBuild 에이전트 알림을 구독하려면

  1. https://console.aws.amazon.com/sns/v3/home에서 Amazon SNS 콘솔을 엽니다.

  2. 탐색 모음에서 아직 선택되지 않은 경우 AWS 리전을 미국 동부(버지니아 북부)로 변경합니다. 구독을 신청하는 Amazon SNS 알림이 AWS 리전에 생성되기 때문에 이 리전을 선택해야 합니다.

  3. 탐색 창에서 구독을 선택합니다.

  4. Create subscription을 선택합니다.

  5. 구독 생성에서 다음을 수행합니다.

    1. 주제 ARN에 다음 Amazon 리소스 이름(ARN)을 사용합니다.

      arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates

    2. 프로토콜의 경우 이메일 또는 SMS를 선택합니다.

    3. 엔드포인트의 경우 알림을 수신할 위치(이메일 또는 SMS)를 선택합니다. 지역 번호를 포함한 이메일 주소, 우편 주소 또는 전화번호를 입력합니다.

    4. 구독 생성을 선택합니다.

    5. 구독 사실을 확인하는 이메일을 받으려면 이메일을 선택합니다. 이메일의 지침에 따라 구독을 완료합니다.

      이런 알림을 더 이상 받지 않기를 원하는 경우, 다음 절차를 수행해서 구독을 해제하세요.

CodeBuild 에이전트 알림을 구독 해제하려면

  1. https://console.aws.amazon.com/sns/v3/home에서 Amazon SNS 콘솔을 엽니다.

  2. 탐색 창에서 구독을 선택합니다.

  3. 구독을 선택한 후 작업에서 구독 삭제를 선택합니다. 확인 메시지가 표시되면 [Delete]를 선택합니다.