AWS CodeBuild의 빌드 캐싱

프로젝트가 빌드될 때 캐시를 사용하여 시간을 절약할 수 있습니다. 캐시는 빌드 환경에서 재사용할 수 있는 정보를 저장하여 여러 빌드에 사용할 수 있습니다. 빌드 프로젝트는 Amazon S3 또는 로컬의 두 캐싱 유형 중 하나를 사용할 수 있습니다. 로컬 캐시를 사용하는 경우 다음 세 캐시 모드에서 하나 이상을 선택해야 합니다. 소스 캐시, Docker 계층 캐시 및 사용자 지정 캐시.

참고

Docker 계층 캐시 모드는 Linux 환경에서만 사용할 수 있습니다. 이 모드를 선택하는 경우 빌드를 권한 모드에서 실행해야 합니다. CodeBuild 권한 모드가 부여된 프로젝트는 컨테이너에 모든 기기에 대한 액세스 권한을 부여합니다. 자세한 내용은 Docker 문서 웹 사이트의 런타임 권한 및 Linux 기능을 참조하십시오.

Amazon S3 캐싱

Amazon S3 캐싱은 여러 빌드 호스트에 사용 가능한 캐시를 Amazon S3 버킷에 저장합니다. 이는 다운로드보다 빌드가 더 비용이 많이 드는 소형-중형 빌드 아티팩트에 적합한 옵션입니다. 대용량 빌드 아티팩트의 경우에는 네트워크를 통해 전송하는 데 오랜 시간이 걸릴 수 있고 따라서 빌드 성능에 영향을 미칠 수 있으므로 최선의 옵션은 아닙니다. Docker 계층을 사용하는 경우에는 최선의 옵션이 아닙니다.

로컬 캐싱

로컬 캐싱은 해당 빌드 호스트에만 사용할 수 있는 캐시를 빌드에 로컬로 저장합니다. 빌드 호스트에서 즉각적으로 캐시를 사용할 수 있으므로 중형-대형 빌드 아티팩트에 적합한 옵션입니다. 빌드가 드문 경우에는 최선의 옵션이 아닙니다. 이는 빌드 성능이 네트워크 전송 시간의 영향을 받지 않는다는 의미입니다.

로컬 캐싱을 선택할 경우 다음 캐시 모드 중 하나 이상을 선택해야 합니다.

소스 캐시 모드는 기본 및 보조 소스를 위해 Git 메타데이터를 캐싱합니다. 캐시가 생성되면 이후의 빌드는 커밋 사이의 변경 사항만 끌어옵니다. 이 모드는 클린 작업 디렉터리를 사용하고 소스가 대규모 Git 리포지토리인 프로젝트에 적합한 선택입니다. 프로젝트에서 Git 리포지토리 (AWS CodeCommit, GitHub, GitHub 엔터프라이즈 서버 또는 Bitbucket) 를 사용하지 않는 경우 이 옵션은 무시됩니다.
Docker 계층 캐시 모드는 기존 Docker 계층을 캐싱합니다. 이 모드는 대용량 도커 이미지를 빌드하거나 끌어오는 프로젝트에 적합한 선택입니다. 네트워크에서 대용량 도커 이미지를 끌어올 때 발생하는 성능 문제를 방지할 수 있습니다.
참고
- Docker 계층 캐시는 Linux 환경에서만 사용할 수 있습니다.
- 프로젝트가 필요한 Docker 권한을 가지도록 privileged 플래그를 설정해야 합니다.
  
  기본적으로 Docker 데몬은 VPC가 아닌 빌드에는 활성화되어 있습니다. VPC 빌드에 Docker 컨테이너를 사용하려면 Docker Docs 웹 사이트의 런타임 권한 및 Linux 기능을 참조하고 권한 모드를 활성화하세요. 또한 Windows는 권한 모드를 지원하지 않습니다.
- Docker 계층 캐시를 사용하기 전에 보안에 미치는 영향을 고려해야 합니다.

사용자 지정 캐시 모드는 buildspec 파일에 지정한 디렉터리를 캐싱합니다. 이 모드는 다른 두 로컬 캐시 모드에 적합하지 않은 빌드 시나리오에 적합한 선택입니다. 사용자 지정 캐시를 사용할 경우
- 캐싱을 위해 디렉터리만 지정할 수 있습니다. 개별 파일은 지정할 수 없습니다.
- Symlink를 사용하여 캐싱된 디렉터리를 참조합니다.
- 캐싱된 디렉터리는 프로젝트 소스를 다운로드하기 전에 빌드에 연결됩니다. 캐시된 항목은 이름이 같은 경우 소스 항목을 재정의합니다. 디렉터리는 buildspec 파일에서 경로를 사용하여 지정합니다. 자세한 설명은 buildspec 구문 섹션을 참조하세요.
- 소스와 캐시에서 동일한 디렉터리 이름은 사용하지 마십시오. 로컬로 캐시된 디렉터리는 소스 리포지토리에서 이름이 같은 디렉터리의 내용을 재정의하거나 삭제할 수 있습니다.

참고

LINUX_GPU_CONTAINER 환경 유형 및 BUILD_GENERAL1_2XLARGE 컴퓨팅 유형에서는 로컬 캐싱이 지원되지 않습니다. 자세한 설명은 빌드 환경 컴퓨팅 모드 및 유형 섹션을 참조하세요.

참고

VPC와 함께 CodeBuild 작동하도록 구성할 때는 로컬 캐싱이 지원되지 않습니다. 에서 VPC를 사용하는 방법에 대한 자세한 내용은 을 CodeBuild 참조하십시오. Amazon Virtual Private 클라우드와 AWS CodeBuild 함께 사용

주제

로컬 캐싱 지정(CLI)
로컬 캐싱 지정(콘솔)
로컬 캐싱 지정(AWS CloudFormation)

AWS CLI, 콘솔, SDK 또는 AWS CloudFormation을 사용하여 로컬 캐시를 지정할 수 있습니다.

로컬 캐싱 지정(CLI)

AWS CLI에서 --cache 파라미터를 사용하여 세 가지 로컬 캐시 유형을 각각 지정할 수 있습니다.

소스 캐시를 지정하려면


--cache type=LOCAL,mode=[LOCAL_SOURCE_CACHE]

Docker 계층 캐시를 지정하려면


--cache type=LOCAL,mode=[LOCAL_DOCKER_LAYER_CACHE]

사용자 지정 캐시를 지정하려면


--cache type=LOCAL,mode=[LOCAL_CUSTOM_CACHE]

자세한 설명은 빌드 프로젝트 생성(AWS CLI) 섹션을 참조하세요.

로컬 캐싱 지정(콘솔)

콘솔의 결과물 섹션에서 캐시를 지정합니다. 캐시 유형은 Amazon S3 또는 로컬을 선택합니다. 로컬을 선택한 경우 세 로컬 캐시 옵션 중 하나 이상을 선택합니다.

자세한 설명은 빌드 프로젝트 만들기(콘솔) 섹션을 참조하세요.

로컬 캐싱 지정(AWS CloudFormation)

AWS CloudFormation을 사용하여 로컬 캐시를 지정할 경우 Cache 속성에서 Type은 LOCAL을 지정합니다. 다음 샘플 YAML 형식 AWS CloudFormation 코드는 세 가지 로컬 캐시 유형을 모두 지정합니다. 각 유형을 임의로 조합하여 지정할 수 있습니다. Docker 계층 캐시를 사용하는 경우 Environment에서 PrivilegedMode를 true로 설정하고 Type을 LINUX_CONTAINER로 설정해야 합니다.


CodeBuildProject:
    Type: AWS::CodeBuild::Project
    Properties:
      Name: MyProject
      ServiceRole: <service-role>
      Artifacts:
        Type: S3
        Location: <bucket-name>
        Name: myArtifact
        EncryptionDisabled: true
        OverrideArtifactName: true
      Environment:
        Type: LINUX_CONTAINER
        ComputeType: BUILD_GENERAL1_SMALL
        Image: aws/codebuild/standard:5.0
        Certificate: <bucket/cert.zip>
        # PrivilegedMode must be true if you specify LOCAL_DOCKER_LAYER_CACHE
        PrivilegedMode: true
      Source:
        Type: GITHUB
        Location: <github-location>
        InsecureSsl: true
        GitCloneDepth: 1
        ReportBuildStatus: false
      TimeoutInMinutes: 10
      Cache:
        Type: LOCAL
        Modes: # You can specify one or more cache mode, 
          - LOCAL_CUSTOM_CACHE
          - LOCAL_DOCKER_LAYER_CACHE
          - LOCAL_SOURCE_CACHE

참고

기본적으로 Docker 데몬은 VPC가 아닌 빌드에는 활성화되어 있습니다. VPC 빌드에 Docker 컨테이너를 사용하려면 Docker Docs 웹 사이트의 런타임 권한 및 Linux 기능을 참조하고 권한 모드를 활성화하세요. 또한 Windows는 권한 모드를 지원하지 않습니다.

자세한 내용은 빌드 프로젝트 생성(AWS CloudFormation)을(를) 참조하세요.

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

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

문서 규칙

빌드 프로젝트 세부 정보 보기

빌드 트리거