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

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

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

사전 조건

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

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

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

빌드 이미지 설정

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

빌드 이미지를 설정하려면

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

   $ 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:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940

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

   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192

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

   $ 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

   Replace <container-image> 컨테이너 이미지 이름 (예: aws/codebuild/standard:5.0 또는) 을 사용합니다public.ecr.aws/codebuild/amazonlinux2-x86_64-standard:4.0.

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

새 CodeBuild 에이전트 버전에 대한 알림을 받습니다.

Amazon SNS 알림을 구독하면 AWS CodeBuild 에이전트의 새 버전이 출시될 때 알림을 받을 수 있습니다.

CodeBuild 상담원 알림을 구독하려면

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

2. 탐색 표시줄에서 아직 선택하지 않은 경우 AWS 지역을 미국 동부 (버지니아 북부) 로 변경합니다. 구독 중인 Amazon SNS 알림이 이 AWS 지역에서 생성되므로 이 지역을 선택해야 합니다.

3. 탐색 창에서 Subscriptions를 선택합니다.

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

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

   1. ARN주제에는 다음 Amazon 리소스 이름 (ARN) 을 사용하십시오.

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

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

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

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

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

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

CodeBuild 상담원 알림 수신을 취소하려면

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

2. 탐색 창에서 Subscriptions를 선택합니다.

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