Amazon S3 소스 작업

구성된 버킷 및 객체 키에 새 객체가 업로드될 때 파이프라인을 트리거합니다.

참고

이 참조 항목에서는 원본 위치가 버전 관리를 위해 CodePipeline 구성된 Amazon S3 버킷인 경우 Amazon S3 소스 작업에 대해 설명합니다. 의 Amazon S3 배포 작업에 대한 참조 정보는 CodePipeline 을 참조하십시오Amazon S3 배포 작업.

Amazon S3 버킷을 생성하여 애플리케이션 파일의 원본 위치로 사용할 수 있습니다.

참고

소스 버킷을 생성할 때는 버킷에 대한 버전 관리를 활성화해야 합니다. 기존의 Amazon S3 버킷을 사용하려면 기존 버킷에 대한 버전 관리를 활성화하기 위한 버전 관리 사용을 참조하세요.

콘솔을 사용하여 파이프라인을 생성하거나 편집하는 경우, S3 원본 버킷이 변경될 때 파이프라인을 시작하는 CloudWatch 이벤트 규칙을 CodePipeline 생성합니다.

Amazon S3 작업을 통해 파이프라인을 연결하기 전에 Amazon S3 소스 버킷을 생성하고 원본 파일을 단일 ZIP 파일로 업로드해야 합니다.

참고

Amazon S3가 파이프라인의 소스 공급자인 경우, 소스 파일을 .zip 하나로 압축하고 그 .zip을 소스 버킷에 업로드할 수 있습니다. 압축이 풀린 단일 파일을 업로드할 수도 있지만 .zip 파일을 예상하는 다운스트림 작업은 실패합니다.

작업 유형

• 범주: Source

• 소유자: AWS

• 공급자: S3

• 버전: 1

구성 파라미터

S3Bucket

필수 여부: 예

소스 변경 사항이 감지되는 Amazon S3 버킷의 이름입니다.

S3 ObjectKey

필수 여부: 예

소스 변경 사항이 감지되는 Amazon S3 객체 키의 이름입니다.

AllowOverrideForS3 ObjectKey

필수 여부: 아니요

AllowOverrideForS3ObjectKey의 소스 오버라이드가 소스 작업에 이미 구성된 S3ObjectKey 것을 재정의할 StartPipelineExecution 수 있는지 여부를 제어합니다. S3 객체 키를 사용한 소스 재정의에 대한 자세한 내용은 을 참조하십시오. 소스 개정 재정의로 파이프라인 시작

중요

생략하면 이 AllowOverrideForS3ObjectKey 파라미터를 로 설정하여 소스 ObjectKey 작업에서 S3를 재정의하는 기능이 CodePipeline 기본적으로 설정됩니다. false

이 파라미터에 유효한 값은 다음과 같습니다.

• true: 설정된 경우 파이프라인 실행 중에 소스 수정 재정의로 사전 구성된 S3 객체 키를 재정의할 수 있습니다.

  참고

  새 파이프라인 실행을 시작하는 동안 모든 CodePipeline 사용자가 사전 구성된 S3 객체 키를 재정의할 수 있도록 허용하려면 로 설정해야 합니다. AllowOverrideForS3ObjectKey true

• false:

  설정하면 소스 수정 CodePipeline 재정의를 사용하여 S3 객체 키를 재정의할 수 없습니다. 이 값은 이 파라미터의 기본값이기도 합니다.

PollForSourceChanges

필수 여부: 아니요

PollForSourceChangesAmazon S3 원본 버킷을 CodePipeline 폴링하여 소스 변경 사항을 조사할지 여부를 제어합니다. 대신 CloudWatch Events를 사용하고 소스 변경을 CloudTrail 감지하는 데 사용하는 것이 좋습니다. CloudWatch 이벤트 구성에 대한 자세한 내용은 S3 소스 및 CloudTrail 트레일 (CLI) 을 사용하여 폴링 파이프라인을 마이그레이션합니다. 또는 을 참조하십시오S3 소스 및 CloudTrail 트레일 (AWS CloudFormation 템플릿) 을 사용하여 폴링 파이프라인을 마이그레이션하십시오..

중요

CloudWatch 이벤트를 구성하려는 경우 파이프라인 중복 실행을 PollForSourceChanges false 방지하도록 로 설정해야 합니다.

이 파라미터에 유효한 값은 다음과 같습니다.

• true: 설정하면 소스 위치를 CodePipeline 폴링하여 소스 변경 내용을 확인합니다.

  참고

  PollForSourceChanges생략하면 소스 위치를 폴링하여 소스 변경 내용을 확인하는 것이 CodePipeline 기본값입니다. 이러한 동작은 PollForSourceChanges이 포함되었고 true로 설정된 경우와 똑같습니다.

• false: 설정하면 소스 위치를 폴링하여 소스 변경 내용을 확인하지 CodePipeline 않습니다. 소스 변경을 탐지하도록 CloudWatch 이벤트 규칙을 구성하려면 이 설정을 사용하십시오.

입력 아티팩트

• 아티팩트 수: 0

• 설명: 이 작업 유형에는 입력 아티팩트가 적용되지 않습니다.

출력 아티팩트

• 아티팩트 수: 1

• 설명: 파이프라인에 연결하도록 구성된 소스 버킷에서 사용할 수 있는 아티팩트를 제공합니다. 버킷에서 생성된 아티팩트는 Amazon S3 작업의 출력 아티팩트입니다. Amazon S3 객체 메타데이터 (ETag 및 버전 ID) 는 트리거된 파이프라인 실행의 소스 수정 버전으로 표시됩니다. CodePipeline

출력 변수

이 작업을 구성하면 파이프라인에서 다운스트림 작업의 작업 구성에서 참조할 수 있는 변수가 생성됩니다. 이 작업은 작업에 네임스페이스가 없는 경우에도 출력 변수로 볼 수 있는 변수를 생성합니다. 이러한 변수를 다운스트림 작업 구성에서 사용할 수 있도록 네임스페이스를 사용하여 작업을 구성합니다.

의 변수에 대한 자세한 내용은 CodePipeline 을 참조하십시오Variables.

BucketName

파이프라인을 트리거한 소스 변경과 관련된 Amazon S3 버킷의 이름.

ETag

파이프라인을 트리거한 소스 변경과 관련된 개체의 엔터티 태그입니다. ETag는 객체의 MD5 해시입니다. ETag는 객체의 내용에 대한 변경 사항만 반영하고 메타데이터에 대한 변경은 반영하지 않습니다.

ObjectKey

파이프라인을 트리거한 소스 변경과 관련된 Amazon S3 객체 키의 이름.

VersionId

파이프라인을 트리거한 소스 변경과 관련된 객체 버전의 버전 ID입니다.

작업 선언

YAML

Name: Source
Actions:
  - RunOrder: 1
    OutputArtifacts:
      - Name: SourceArtifact
    ActionTypeId:
      Provider: S3
      Owner: AWS
      Version: '1'
      Category: Source
    Region: us-west-2
    Name: Source
    Configuration:
      S3Bucket: my-bucket-oregon
      S3ObjectKey: my-application.zip
      PollForSourceChanges: 'false'
    InputArtifacts: []

JSON

{
    "Name": "Source",
    "Actions": [
        {
            "RunOrder": 1,
            "OutputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "ActionTypeId": {
                "Provider": "S3",
                "Owner": "AWS",
                "Version": "1",
                "Category": "Source"
            },
            "Region": "us-west-2",
            "Name": "Source",
            "Configuration": {
                "S3Bucket": "my-bucket-oregon",
                "S3ObjectKey": "my-application.zip",
                "PollForSourceChanges": "false"
            },
            "InputArtifacts": []
        }
    ]
},

다음 사항도 참조하세요.

이 작업을 수행할 때 참조할 수 있는 관련 리소스는 다음과 같습니다.

• 자습서: 간단한 파이프라인 생성(S3 버킷)— 이 자습서에서는 샘플 앱 사양 파일과 샘플 CodeDeploy 애플리케이션 및 배포 그룹을 제공합니다. 이 자습서를 사용하여 Amazon EC2 인스턴스에 배포되는 Amazon S3 소스로 파이프라인을 생성합니다.