CodeCommit 소스 액션 레퍼런스 - AWS CodePipeline
작업 유형구성 파라미터 입력 아티팩트출력 아티팩트출력 변수예제 작업 구성다음 사항도 참조하세요.

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

CodeCommit 소스 액션 레퍼런스

구성된 CodeCommit 리포지토리와 브랜치에서 새 커밋이 이루어지면 파이프라인을 시작합니다.

콘솔을 사용하여 파이프라인을 생성하거나 편집하는 경우, 리포지토리에 변경 사항이 발생할 때 파이프라인을 시작하는 CodeCommit CloudWatch 이벤트 규칙이 CodePipeline 생성됩니다.

CodeCommit 작업을 통해 파이프라인을 연결하려면 먼저 CodeCommit 리포지토리를 생성해야 합니다.

코드 변경이 감지되면 다음 옵션을 사용하여 코드를 후속 작업에 전달할 수 있습니다.

  • 기본값 - 커밋의 CodeCommit 단순 사본이 포함된 ZIP 파일을 출력하도록 소스 작업을 구성합니다.

  • 전체 복제 - 후속 작업을 위해 리포지토리에 대한 Git URL 참조를 출력하도록 소스 작업을 구성합니다.

    현재 Git URL 참조는 리포지토리 및 관련 Git 메타데이터를 복제하기 위한 다운스트림 CodeBuild 작업에서만 사용할 수 있습니다. URLGit 참조를 non-actions로 전달하려고 CodeBuild 하면 오류가 발생합니다.

작업 유형

  • 범주: Source

  • 소유자: AWS

  • 공급자: CodeCommit

  • 버전: 1

구성 파라미터

RepositoryName

필수 여부: 예

소스 변경 사항을 감지할 리포지토리의 이름입니다.

BranchName

필수 여부: 예

소스 변경 사항을 감지할 분기의 이름입니다.

PollForSourceChanges

필수 여부: 아니요

PollForSourceChanges CodeCommit리포지토리에서 CodePipeline 소스 변경 내용을 폴링할지 여부를 제어합니다. 대신 CloudWatch 이벤트를 사용하여 소스 변경을 감지하는 것이 좋습니다. CloudWatch 이벤트 구성에 대한 자세한 내용은 폴링 파이프라인 마이그레이션 (CodeCommit source) () CLI 또는 을 참조하십시오폴링 파이프라인 마이그레이션 (CodeCommit 소스) (AWS CloudFormation 템플릿).

중요

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

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

  • true: 설정하면 리포지토리를 CodePipeline 폴링하여 소스 변경 사항을 확인합니다.

    참고

    생략하면 PollForSourceChanges CodePipeline 기본적으로 리포지토리를 폴링하여 소스 변경 내용을 확인합니다. 이러한 동작은 PollForSourceChanges이 포함되었고 true로 설정된 경우와 똑같습니다.

  • false: 설정하면 저장소에서 소스 CodePipeline 변경 내용을 폴링하지 않습니다. 소스 변경을 탐지하도록 CloudWatch 이벤트 규칙을 구성하려면 이 설정을 사용하십시오.

OutputArtifactFormat

필수 여부: 아니요

출력 아티팩트 형식. 값은 CODEBUILD_CLONE_REF 또는 CODE_ZIP가 될 수 있습니다. 미지정된 경우 기본값은 CODE_ZIP입니다.

중요

이 CODEBUILD_CLONE_REF 옵션은 CodeBuild 다운스트림 작업에서만 사용할 수 있습니다.

이 옵션을 선택하는 경우 와 같이 CodeBuild 서비스 역할에 codecommit:GitPull 권한을 추가해야 합니다. CodeCommit소스 작업에 대한 CodeBuild GitClone 권한 추가 또한 에서와 같이 CodePipeline 서비스 역할에 codecommit:GetRepository 권한을 추가해야 CodePipeline 서비스 역할에 권한 추가 합니다. 전체 복제 옵션을 사용하는 방법을 보여주는 자습서는 튜토리얼: CodeCommit 파이프라인 소스와 함께 전체 클론 사용을 참조하세요.

입력 아티팩트

  • 아티팩트 수: 0

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

출력 아티팩트

  • 아티팩트 수: 1

  • 설명: 이 작업의 출력 아티팩트는 파이프라인 실행의 소스 수정으로 지정된 커밋에 구성된 리포지토리 및 브랜치의 콘텐츠가 들어 있는 ZIP 파일입니다. 리포지토리에서 생성된 아티팩트는 작업의 출력 아티팩트입니다. CodeCommit 소스 코드 커밋 ID는 트리거된 CodePipeline 파이프라인 실행의 소스 수정 버전으로 표시됩니다.

출력 변수

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

자세한 내용은 변수 레퍼런스 단원을 참조하십시오.

CommitId

파이프라인 실행을 트리거한 CodeCommit 커밋 ID. IDs커밋이 전체 SHA 커밋입니다.

CommitMessage

파이프라인 실행을 트리거한 커밋과 연관된 설명 메시지입니다(존재하는 경우).

RepositoryName

파이프라인을 트리거한 커밋이 만들어진 CodeCommit 리포지토리의 이름.

BranchName

소스가 변경된 CodeCommit 리포지토리의 브랜치 이름.

AuthorDate

커밋이 작성된 날짜입니다(타임스탬프 형식).

Git의 작성자와 커미터의 차이점에 대한 자세한 내용은 Scott Chacon과 Ben Straub가 작성한 Pro Git의 커밋 기록 보기를 참조하십시오.

CommitterDate

커밋이 수행된 날짜입니다(타임스탬프 형식).

Git의 작성자와 커미터의 차이점에 대한 자세한 내용은 Scott Chacon과 Ben Straub가 작성한 Pro Git의 커밋 기록 보기를 참조하십시오.

예제 작업 구성

기본 출력 아티팩트 형식의 예

YAML
Actions:
  - OutputArtifacts:
      - Name: Artifact_MyWebsiteStack
    InputArtifacts: []
    Name: source
    Configuration:
      RepositoryName: MyWebsite
      BranchName: main
      PollForSourceChanges: 'false'
    RunOrder: 1
    ActionTypeId:
      Version: '1'
      Provider: CodeCommit
      Category: Source
      Owner: AWS
  Name: Source
JSON
{
    "Actions": [
        {
            "OutputArtifacts": [
                {
                    "Name": "Artifact_MyWebsiteStack"
                }
            ],
            "InputArtifacts": [],
            "Name": "source",
            "Configuration": {
                "RepositoryName": "MyWebsite",
                "BranchName": "main",
                "PollForSourceChanges": "false"
            },
            "RunOrder": 1,
            "ActionTypeId": {
                "Version": "1",
                "Provider": "CodeCommit",
                "Category": "Source",
                "Owner": "AWS"
            }
        }
    ],
    "Name": "Source"
},

전체 복제 출력 아티팩트 형식의 예

YAML
name: Source
actionTypeId:
  category: Source
  owner: AWS
  provider: CodeCommit
  version: '1'
runOrder: 1
configuration:
  BranchName: main
  OutputArtifactFormat: CODEBUILD_CLONE_REF
  PollForSourceChanges: 'false'
  RepositoryName: MyWebsite
outputArtifacts:
  - name: SourceArtifact
inputArtifacts: []
region: us-west-2
namespace: SourceVariables
JSON
{
    "name": "Source",
    "actionTypeId": {
        "category": "Source",
        "owner": "AWS",
        "provider": "CodeCommit",
        "version": "1"
    },
    "runOrder": 1,
    "configuration": {
        "BranchName": "main",
        "OutputArtifactFormat": "CODEBUILD_CLONE_REF",
        "PollForSourceChanges": "false",
        "RepositoryName": "MyWebsite"
    },
    "outputArtifacts": [
        {
            "name": "SourceArtifact"
        }
    ],
    "inputArtifacts": [],
    "region": "us-west-2",
    "namespace": "SourceVariables"
}

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