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

# AWS CodeBuild 에이전트를 사용하여 로컬에서 빌드 실행
<a name="use-codebuild-agent"></a>

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

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

## 사전 조건
<a name="use-codebuild-agent.prerequisites"></a>

시작하려면 다음을 수행해야 합니다.
+ 로컬 시스템에 Git를 설치합니다.
+ 로컬 컴퓨터에 [Docker](https://www.docker.com/)를 설치하고 설정합니다.

## 빌드 이미지 설정
<a name="use-codebuild-agent.setup-image"></a>

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

**빌드 이미지를 설정하려면**

1. 큐레이션된 Amazon Linux 2 이미지를 사용하려면 다음 명령을 사용하여 [https://gallery.ecr.aws/codebuild/amazonlinux-x86\$164-standard](https://gallery.ecr.aws/codebuild/amazonlinux-x86_64-standard) CodeBuild 퍼블릭 Amazon ECR 리포지토리에서 가져올 수 있습니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

1. <a name="codebuild-agent-sha"></a>CodeBuild 에이전트는 [https://gallery.ecr.aws/codebuild/local-builds](https://gallery.ecr.aws/codebuild/local-builds)에서 사용할 수 있습니다.

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

   ```
   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940
   ```

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

   ```
   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192
   ```

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

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

## CodeBuild 에이전트 실행
<a name="use-codebuild-agent.run-agent"></a>

**CodeBuild 에이전트를 실행하려면**

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

1. [codebuild\$1build.sh](https://github.com/aws/aws-codebuild-docker-images/blob/master/local_builds/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
   ```

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

   x86\$164 빌드를 실행하려면 다음 명령을 실행합니다.

   ```
   $ ./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/amazonlinux-x86_64-standard:4.0`)으로 바꿉니다.

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

## 새 CodeBuild 에이전트 버전에 대한 알림 받기
<a name="receive-codebuild-agent-notifications"></a>

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

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

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

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

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

1. **구독 생성**을 선택합니다.

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

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

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

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

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

   1. **구독 생성**을 선택합니다.

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

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

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

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

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

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