에 대한 Amazon Elastic File System 샘플 AWS CodeBuild

Amazon EC2 인스턴스용 확장 가능한 공유 파일 서비스인 Amazon Elastic File System에서 AWS CodeBuild 빌드를 생성할 수 있습니다. Amazon의 스토리지 EFS 용량은 탄력적이므로 파일이 추가되고 제거됨에 따라 용량이 늘어나거나 줄어듭니다. 또한 파일 시스템을 만들고 구성할 수 있는 간편한 웹 서비스 인터페이스를 제공합니다. 이 서비스는 모든 파일 스토리지 인프라를 관리하므로, 파일 시스템 구성을 배포하거나 패치를 적용하거나 유지 보수하는 데 신경을 쓸 필요가 없습니다. 자세한 내용은 Amazon Elastic File System 사용 설명서에서 Amazon Elastic File System이란?을 참조하세요.

이 샘플은 Java 애플리케이션을 Amazon EFS 파일 시스템에 마운트하고 빌드하도록 CodeBuild 프로젝트를 구성하는 방법을 보여줍니다. 시작하기 전에 S3 입력 버킷 또는, AWS CodeCommit GitHub, GitHub 엔터프라이즈 서버 또는 Bitbucket 리포지토리에 업로드된 Java 애플리케이션을 빌드할 준비가 되어 있어야 합니다.

파일 시스템에 전송되는 데이터는 암호화됩니다. 다른 이미지를 사용하여 전송 중인 데이터를 암호화하려면 전송 중 데이터 암호화를 참조하십시오.

주제

Amazon Elastic File AWS CodeBuild System과 함께 사용
Amazon EFS 연동 문제 해결

Amazon Elastic File AWS CodeBuild System과 함께 사용

이 샘플은 EFS Amazon을 사용하는 데 필요한 상위 4단계를 다룹니다. AWS CodeBuild스크립트는 다음과 같습니다.

AWS 계정에 가상 사설 클라우드 (VPC) 를 생성하십시오.
이를 사용하는 파일 시스템을 만드세요VPC.
를 사용하는 CodeBuild 프로젝트를 만들고 빌드합니다VPC. CodeBuild 프로젝트는 다음을 사용하여 파일 시스템을 식별합니다.
- 고유한 파일 시스템 식별자. 식별자는 빌드 프로젝트에서 파일 시스템을 지정할 때 선택합니다.
- 파일 시스템 ID. Amazon EFS 콘솔에서 파일 시스템을 볼 때 ID가 표시됩니다.
- 탑재 지점. 파일 시스템을 탑재하는 Docker 컨테이너에 있는 디렉터리입니다.
- 탑재 옵션. 여기에는 파일 시스템을 탑재하는 방법에 대한 세부 정보가 포함됩니다.
빌드 프로젝트를 검토하여 올바른 프로젝트 파일 및 변수가 생성되었는지 확인하십시오.

참고

EFSAmazon에서 만든 파일 시스템은 Linux 플랫폼에서만 지원됩니다.

주제

1단계: 사용자 생성 VPC AWS CloudFormation
2단계: 다음을 사용하여 Amazon Elastic File System 파일 시스템을 생성합니다. VPC
3단계: Amazon에서 사용할 CodeBuild 프로젝트 생성 EFS
4단계: 빌드 프로젝트 검토

1단계: 사용자 생성 VPC AWS CloudFormation

VPC AWS CloudFormation 템플릿으로 제작하세요.

AWS CloudFormation VPC 템플릿에 나와 있는 지침에 따라 VPC 생성하십시오. AWS CloudFormation

참고
이 AWS CloudFormation 템플릿으로 VPC 만든 템플릿에는 두 개의 프라이빗 서브넷과 두 개의 퍼블릭 서브넷이 있습니다. EFSAmazon에서 생성한 파일 시스템을 AWS CodeBuild 마운트하는 데 사용할 때는 프라이빗 서브넷만 사용해야 합니다. 퍼블릭 서브넷 중 하나를 사용할 경우 빌드가 실패합니다.
에서 Amazon VPC 콘솔에 AWS Management Console 로그인하고 엽니다 https://console.aws.amazon.com/vpc/.
VPC만들 때 사용한 것을 선택합니다 AWS CloudFormation.
설명 탭에서 사용자 VPC 이름과 ID를 기록해 둡니다. VPC 이름과 ID 모두 이 예제 뒷부분에서 AWS CodeBuild 프로젝트를 만들 때 필요합니다.

2단계: 다음을 사용하여 Amazon Elastic File System 파일 시스템을 생성합니다. VPC

이전에 만든 EFS 파일을 사용하여 이 샘플에 대한 간단한 Amazon 파일 시스템을 생성합니다. VPC

에서 Amazon EFS 콘솔에 AWS Management Console 로그인하고 엽니다 https://console.aws.amazon.com/efs/.
파일 시스템 생성을 선택합니다.
이 샘플에서 VPC앞부분에서 기록해 둔 VPC 이름을 선택합니다.
가용 영역은 선택한 서브넷과 연결된 채로 둡니다.
다음 단계를 선택합니다.
태그 추가에서 기본 이름 키의 경우 Value에 Amazon EFS 파일 시스템의 이름을 입력합니다.
기본 성능 및 처리량 모드로 선택한 Bursting(버스팅) 및 범용 모드를 그대로 두고 다음 단계를 선택합니다.
클라이언트 액세스 구성에서 다음 단계를 선택합니다.
파일 시스템 생성을 선택합니다.
(선택 사항) 전송 데이터를 암호화하는 정책을 Amazon EFS 파일 시스템에 추가하는 것이 좋습니다. Amazon EFS 콘솔에서 파일 시스템 정책을 선택하고 편집을 선택한 다음 모든 클라이언트에 대해 전송 중 암호화 적용이라고 표시된 상자를 선택한 다음 [Save] 를 선택합니다.

3단계: Amazon에서 사용할 CodeBuild 프로젝트 생성 EFS

이 샘플의 VPC 앞부분에서 만든 AWS CodeBuild 프로젝트를 사용하여 프로젝트를 생성하십시오. 빌드가 실행되면 이전에 만든 Amazon EFS 파일 시스템이 마운트됩니다. 그런 다음 Java 애플리케이션에서 생성된 .jar 파일을 파일 시스템의 탑재 지점 디렉터리에 저장합니다.

https://console.aws.amazon.com/codesuite/코드빌드/홈에서 AWS CodeBuild 콘솔을 엽니다.
탐색 창에서 빌드 프로젝트를 선택한 후 빌드 프로젝트 생성을 선택합니다.
프로젝트 이름에 프로젝트의 이름을 입력합니다.
소스 공급자에서 빌드하려는 Java 애플리케이션을 포함하는 리포지토리를 선택합니다.
애플리케이션을 찾는 데 CodeBuild 사용되는 정보 (예: 리포지토리URL) 를 입력합니다. 옵션은 소스 공급자마다 다릅니다. 자세한 내용은 Choose source provider 단원을 참조하십시오.
환경 이미지에서 관리형 이미지를 선택합니다.
운영 체제에서 Amazon Linux 2를 선택합니다.
런타임에서 표준을 선택합니다.
이미지에서 aws/codebuild/amazonlinux2-x86_64-standard:4.0을 선택합니다.
환경 유형에서 Linux를 선택합니다.
서비스 역할에서 새 서비스 역할을 선택합니다. 역할 이름에 사용자를 위해 CodeBuild 생성한 역할의 이름을 입력합니다.
추가 구성을 확장합니다.
Docker 이미지를 빌드하거나 빌드에서 승격된 권한을 얻으려는 경우 이 플래그 활성화를 선택합니다.

참고
기본적으로 Docker 데몬은 빌드가 아닌 경우 활성화됩니다. VPC Docker 컨테이너를 VPC 빌드에 사용하려면 Docker Docs 웹 사이트의 런타임 권한 및 Linux 기능을 참조하고 권한 모드를 활성화하세요. 또한 Windows는 권한 모드를 지원하지 않습니다.
에서 ID를 선택합니다. VPCVPC
서브넷에서 해당 서브넷과 연결된 하나 이상의 프라이빗 서브넷을 선택합니다. VPC Amazon EFS 파일 시스템을 마운트하는 빌드에서는 프라이빗 서브넷을 사용해야 합니다. 퍼블릭 서브넷을 사용할 경우 빌드가 실패합니다.
보안 그룹에서 기본 보안 그룹을 선택합니다.
파일 시스템에 다음 정보를 입력합니다.
- 식별자에 고유한 파일 시스템 식별자를 입력합니다. 길이는 129자 미만이어야 하고 영숫자 문자와 밑줄만 사용할 수 있습니다. CodeBuild 이 식별자를 사용하여 엘라스틱 파일 시스템을 식별하는 환경 변수를 생성합니다. 환경 변수 형식은 CODEBUILD_<file_system_identifier>(대문자)입니다. 예를 들어 my_efs을 입력하면 환경 변수는 CODEBUILD_MY_EFS입니다.
- ID에서 파일 시스템 ID를 선택합니다.
- (선택 사항) 파일 시스템의 디렉토리를 입력합니다. CodeBuild 이 디렉토리를 마운트합니다. 디렉토리 경로를 비워 두면 전체 파일 CodeBuild 시스템을 마운트합니다. 경로는 파일 시스템의 루트와 관련이 있습니다.
- 탑재 지점에 파일 시스템을 탑재하는 빌드 컨테이너의 디렉터리 절대 경로를 입력합니다. 이 디렉토리가 없는 경우 빌드 중에 디렉토리를 CodeBuild 생성합니다.
- (선택 사항) 탑재 옵션을 입력합니다. 마운트 옵션을 비워 두면 기본 마운트 옵션을 CodeBuild 사용합니다.
```
nfsvers=4.1
rsize=1048576
wsize=1048576
hard
timeo=600
retrans=2
```
  자세한 내용은 Amazon Elastic File System 사용 설명서의 권장 NFS 마운트 옵션을 참조하십시오.
빌드 사양에서 빌드 명령 삽입을 선택한 후 편집기로 전환을 선택합니다.

편집기에 다음 buildspec 명령을 입력합니다. 17단계에서 입력한 식별자로 <file_system_identifier>를 바꿉니다. 대문자(예: CODEBUILD_MY_EFS)를 사용합니다.


version: 0.2
phases:
  install:
    runtime-versions:
      java: corretto11    
  build:
    commands:
      - mvn compile -Dgpg.skip=true -Dmaven.repo.local=$CODEBUILD_<file_system_identifier>

기타 모든 설정에 대해 기본값을 사용하고 빌드 프로젝트 생성을 선택합니다. 빌드가 완료되면 프로젝트의 콘솔 페이지가 표시됩니다.
빌드 시작를 선택합니다.

4단계: 빌드 프로젝트 검토

AWS CodeBuild 프로젝트가 빌드된 후:

Java 애플리케이션에서 생성된.jar 파일은 마운트 포인트 디렉토리 아래의 Amazon EFS 파일 시스템에 빌드됩니다.
파일 시스템을 식별하는 환경 변수는 프로젝트를 만들 때 입력한 파일 시스템 식별자를 사용하여 생성됩니다.

자세한 내용은 Amazon Elastic File System 사용 설명서에서 파일 시스템 탑재를 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

아마존 ECR 샘플

Amazon EFS 연동 문제 해결