Amazon S3 소스 작업

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

참고

이 참조 주제에서는 다음에 대한 Amazon S3 소스 작업에 대해 설명합니다. CodePipeline 여기서 소스 위치는 버전 관리를 위해 구성된 Amazon S3 버킷입니다. CodePipeline의 Amazon S3 배포 작업에 대한 참조 정보는 단원을 참조하십시오.Amazon S3 작업.

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

참고

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

콘솔을 사용하여 파이프라인을 생성하거나 편집하는 경우 CodePipeline 를 생성합니다. CloudWatch S3 소스 버킷에서 변경이 발생할 때 파이프라인을 시작하는 이벤트 규칙입니다.

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

참고

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

작업 유형

• 범주: Source

• 소유자: AWS

• 공급자: S3

• 버전: 1

구성 파라미터

S3Bucket

필수 사항: 예

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

S3ObjectKey

필수 사항: 예

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

PollForSourceChanges

필수 사항: 아니요

PollForSourceChanges제어 여부 CodePipeline 가 소스 변경 사항에 대해 Amazon S3 소스 버킷을 폴링합니다. 를 사용할 것을 권장합니다. CloudWatch 대신 소스 변경 사항을 감지하는 이벤트 및 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.

ETag

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

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 S3 소스에 배포되는 Amazon S3 소스로 파이프라인을 생성합니다.