변수 참조

이 단원은 참조용입니다. 변수 생성에 대한 자세한 내용은 변수 작업 단원을 참조하십시오.

변수를 사용하면 파이프라인 실행 또는 작업 실행 시 결정되는 값으로 파이프라인 작업을 구성할 수 있습니다.

일부 작업 공급자는 정의된 변수 집합을 생성합니다. 해당 작업 공급자의 기본 변수 키에서 선택합니다(예: 커밋 ID).

변수 사용 예제를 보려면 step-by-step:

변수 제한

제한 정보는 의 할당량 AWS CodePipeline 단원을 참조하십시오.

개념

이 단원에서는 변수 및 네임스페이스와 관련된 주요 용어와 개념을 설명합니다.

Variables

변수는 파이프라인에서 작업을 동적으로 구성하는 데 사용할 수 있는 키-값 페어입니다. 현재 이러한 변수를 사용할 수 있는 세 가지 방법이 있습니다.

작업 구성에서 이러한 변수를 참조하려면 올바른 네임스페이스와 함께 변수 참조 구문을 사용해야 합니다.

변수 워크플로의 예는 변수 구성 단원을 참조하십시오.

네임스페이스

변수를 고유하게 참조할 수 있도록 하려면 해당 변수를 네임스페이스에 할당해야 합니다. 네임스페이스에 할당된 변수 집합이 있다면 다음 구문과 함께 네임스페이스 및 변수 키를 사용하여 작업 구성에서 이를 참조할 수 있습니다.

#{namespace.variable_key}

세 가지 유형의 네임스페이스 하에서 변수를 할당할 수 있습니다.

변수 사용 사례

다음은 파이프라인 수준의 가장 일반적인 몇 가지 변수 사용 사례로, 특정 요구 사항에 맞게 변수를 사용하는 방법을 결정하는 데 도움이 됩니다.

변수 구성

파이프라인 구조의 파이프라인 수준 또는 작업 수준에서 변수를 구성할 수 있습니다.

파이프라인 수준에서 변수 구성

파이프라인 수준에서 변수를 하나 이상 추가할 수 있습니다. CodePipeline 작업 구성에서 이 값을 참조할 수 있습니다. 파이프라인을 생성할 때 변수 이름, 기본값, 설명을 추가할 수 있습니다. 변수는 실행 시 확인됩니다.

파이프라인 구조의 변수 속성을 사용하여 파이프라인 수준에서 변수를 제공합니다. 다음 예제에서 변수 Variable1 값은 Value1입니다.

       "variables": [
            {
                "name": "Variable1",
                "defaultValue": "Value1",
                "description": "description"
            }
        ]

파이프라인 JSON 구조의 예는 섹션을 참조하세요파이프라인, 단계 및 작업 생성.

파이프라인 실행 시 전달되는 파이프라인 수준 변수에 대한 자습서는 자습서: 파이프라인 수준 변수 사용을 참조하세요.

단, 모든 종류의 소스 작업에서 파이프라인 수준 변수를 사용하는 것은 지원되지 않습니다.

작업 수준에서 변수 구성

작업의 네임스페이스를 선언하여 변수를 생성하도록 작업을 구성합니다. 작업은 변수를 생성하는 작업 공급자 중 하나여야 합니다. 그렇지 않으면 파이프라인 수준의 변수가 사용 가능한 변수가 됩니다.

다음과 같이 네임스페이스를 선언합니다.

이 예제에서는 라는 이름으로 CodeCommit 원본 작업에 namespace 파라미터를 추가합니다SourceVariables. 이렇게 하면 CommitId 같은 작업 공급자가 사용할 수 있는 변수를 생성하도록 작업이 구성됩니다.

{
    "name": "Source",
    "actions": [
        {
            "outputArtifacts": [
                {
                    "name": "SourceArtifact"
                }
            ],
            "name": "Source",
            "namespace": "SourceVariables",
            "configuration": {
                "RepositoryName": "MyRepo",
                "BranchName": "mainline",
                "PollForSourceChanges": "false"
            },
            "inputArtifacts": [],
            "region": "us-west-2",
            "actionTypeId": {
                "provider": "CodeCommit",
                "category": "Source",
                "version": "1",
                "owner": "AWS"
            },
            "runOrder": 1
        }
    ]
},

그런 다음, 이전 작업에서 생성된 변수를 사용하도록 다운스트림 작업을 구성합니다. 그 방법은 다음과 같습니다.

이 예제에서 빌드 작업의 구성 필드에는 작업 실행 시 업데이트되는 환경 변수가 표시됩니다. 이 예제에서는 #{codepipeline.PipelineExecutionId}을 사용하여 실행 ID에 대한 네임스페이스와 변수를 지정하고 #{SourceVariables.CommitId}를 사용하여 커밋 ID에 대한 네임스페이스 및 변수를 지정합니다.

{
    "name": "Build",
    "actions": [
        {
            "outputArtifacts": [
                {
                    "name": "BuildArtifact"
                }
            ],
            "name": "Build",
            "configuration": {
                "EnvironmentVariables": "[{\"name\":\"Release_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                "ProjectName": "env-var-test"
            },
            "inputArtifacts": [
                {
                    "name": "SourceArtifact"
                }
            ],
            "region": "us-west-2",
            "actionTypeId": {
                "provider": "CodeBuild",
                "category": "Build",
                "version": "1",
                "owner": "AWS"
            },
            "runOrder": 1
        }
    ]
},

변수 확인

작업이 파이프라인 실행의 일부로 실행될 때마다 생성되는 변수를 생성 작업 이후에 수행되도록 보장된 모든 작업에 사용할 수 있습니다. 소비 작업에서 이러한 변수를 사용하려면 앞의 예제에 나와 있는 구문을 사용하여 소비 작업의 구성에 변수를 추가할 수 있습니다. 소비 작업을 수행하기 전에 는 작업 실행을 시작하기 전에 구성에 있는 모든 변수 참조를 CodePipeline 해결합니다.

변수에 대한 규칙

다음 규칙은 변수 구성에 도움이 됩니다.

파이프라인 작업에 사용할 수 있는 변수

작업 공급자는 작업에서 생성할 수 있는 변수를 결정합니다.

변수 관리 step-by-step 절차는 섹션을 참조하세요변수 작업.

정의된 변수 키가 있는 작업

선택이 가능한 네임스페이스와 달리 다음과 같은 작업은 편집이 불가능한 변수 키를 사용합니다. 예를 들어 Amazon S3 작업 공급자의 경우, ETag 및 VersionId 변수 키만 사용할 수 있습니다.

또한 각 실행에는 파이프라인 릴리스 ID와 같이 실행에 대한 데이터를 포함하는 CodePipeline생성된 파이프라인 변수 집합이 있습니다. 이러한 변수는 파이프라인의 모든 작업에서 사용될 수 있습니다.

CodePipeline 실행 ID 변수

Amazon ECR 작업 출력 변수

AWS CloudFormation StackSets 작업 출력 변수

CodeCommit 작업 출력 변수

CodeStarSourceConnection 작업 출력 변수

GitHub 작업 출력 변수(GitHub 작업 버전 1)

S3 작업 출력 변수

사용자가 구성한 변수 키를 사용한 작업

CodeBuild AWS CloudFormation, 및 Lambda 작업의 경우 변수 키는 사용자가 구성합니다.

CloudFormation 작업 출력 변수

CodeBuild 작업 출력 변수

#{BuildVariables.EnvVar}

Lambda 작업 출력 변수