에서 파이프라인 편집 CodePipeline

파이프라인은 완료되어야 하는 단계와 작업을 포함해 AWS CodePipeline이 따라야 할 릴리스 프로세스를 설명합니다. 파이프라인을 편집하여 이러한 요소를 추가하거나 제거할 수 있습니다. 그러나 파이프라인을 편집할 때 파이프라인 이름이나 파이프라인 메타데이터 등의 값은 변경할 수 없습니다.

파이프라인 편집 페이지를 사용하여 파이프라인 유형, 변수, 트리거를 편집할 수 있습니다. 파이프라인에서 단계 및 작업을 추가하거나 변경할 수도 있습니다.

파이프라인 생성과 달리 파이프라인 편집은 파이프라인을 통해 최신 개정을 다시 실행하지 않습니다. 방금 편집한 파이프라인을 통해 최신 개정을 실행하려면 수동으로 다시 실행해야 합니다. 그렇지 않으면 다음에 사용자가 소스 단계에 구성된 소스 위치를 변경할 때 편집된 파이프라인이 실행됩니다. 자세한 내용은 수동으로 파이프라인 시작을 참조하세요.

파이프라인과 다른 AWS 리전에 있는 작업을 파이프라인에 추가할 수 있습니다. AWS 서비스가 작업 제공자이고 이 작업 유형/공급자 유형이 파이프라인과 다른 AWS 리전에 있는 경우 이 작업은 교차 리전 작업입니다. 교차 리전 작업에 대한 자세한 내용은 CodePipeline에 교차 리전 작업 추가 항목을 참조하십시오.

CodePipeline 소스 코드 변경이 푸시될 때 변경 감지 메서드를 사용하여 파이프라인을 시작합니다. 이러한 감지 방법은 소스 유형을 기반으로 합니다.

CodePipeline Amazon CloudWatch Events를 사용하여 CodeCommit 원본 리포지토리 또는 Amazon S3 원본 버킷의 변경 사항을 감지합니다.

참고

콘솔을 사용하면 변경 감지 리소스가 자동으로 생성됩니다. 콘솔을 사용하여 파이프라인을 생성하거나 편집하면 추가 리소스가 자동으로 생성됩니다. AWS CLI를 사용하여 파이프라인을 생성할 경우 추가 리소스를 직접 생성해야 합니다. CodeCommit 파이프라인 생성 또는 업데이트에 대한 자세한 내용은 을 참조하십시오 CodeCommit 소스에 대한 EventBridge 규칙 생성 (CLI). CLI를 사용하여 Amazon S3 파이프라인을 생성 또는 업데이트하는 방법에 대한 자세한 내용은 Amazon S3 소스 (CLI) 에 대한 EventBridge 규칙 생성 단원을 참조하세요.

파이프라인 편집(콘솔)

CodePipeline 콘솔을 사용하여 파이프라인에서 단계를 추가, 편집 또는 제거하고 단계에서 작업을 추가, 편집 또는 제거할 수 있습니다.

파이프라인을 업데이트하면 모든 실행 중인 작업을 CodePipeline 정상적으로 완료한 다음 실행 중인 작업이 완료된 단계 및 파이프라인 실행에 실패합니다. 파이프라인이 업데이트되면 파이프라인을 다시 실행해야 합니다. 파이프라인 실행에 대한 자세한 내용은 수동으로 파이프라인 시작 단원을 참조하세요.

파이프라인을 편집하려면

AWS Management Console로그인하고 http://console.aws.amazon.com/codesuite/codepipeline/home 에서 콘솔을 엽니다. CodePipeline

사용자의 AWS 계정에 연결된 모든 파이프라인의 이름이 표시됩니다.
[Name]에서 편집할 파이프라인의 이름을 선택합니다. 이렇게 하면 파이프라인 각 단계의 각 작업 상태를 포함하여 파이프라인의 세부 정보 보기가 열립니다.
파이프라인 세부 정보 페이지에서 [Edit]를 선택합니다.
파이프라인 유형을 편집하려면 편집: 파이프라인 속성 카드에서 편집을 선택합니다. 다음 옵션 중 하나를 선택한 다음 완료를 선택합니다.
- V1 유형 파이프라인은 표준 파이프라인, 단계, 작업 수준 파라미터를 포함하는 JSON 구조를 가지고 있습니다.
- V2 유형 파이프라인은 트리거 및 파이프라인 수준 변수와 같은 추가 매개변수 지원과 함께 V1 유형과 구조가 동일합니다.
파이프라인 유형은 특성과 가격이 다릅니다. 자세한 설명은 파이프라인 유형 섹션을 참조하세요.
파이프라인 변수를 편집하려면 편집: 변수 카드에서 변수 편집을 선택합니다. 파이프라인 수준의 변수를 추가하거나 변경한 다음 완료를 선택합니다.

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

참고
파이프라인 수준에서 변수를 추가하는 것은 선택 사항이지만, 값이 제공되지 않은 파이프라인 수준의 변수로 지정된 파이프라인의 경우 파이프라인 실행이 실패합니다.
파이프라인 트리거를 편집하려면 편집: 트리거 카드에서 트리거 편집을 선택합니다. 트리거를 추가 또는 변경한 다음 완료를 선택합니다.

트리거 추가에 대한 자세한 내용은 Bitbucket Cloud, GitHub (버전 2), GitHub 엔터프라이즈 서버, GitLab .com 또는 GitLab 자체 관리형 (예:) 에 대한 연결을 만드는 단계를 참조하십시오. GitHub 연결
편집 페이지에서 단계 및 작업을 편집하려면 다음 중 하나를 수행합니다.
- 단계를 편집하려면 Edit stage(단계 편집)를 선택합니다. 기존 작업과 연속되게/동시에 실행되는 작업을 추가할 수 있습니다.
  
  해당 작업의 편집 아이콘을 선택하면 이 보기에서 작업을 편집할 수도 있습니다. 작업을 삭제하려면 해당 작업의 삭제 아이콘을 선택합니다.
- 작업을 편집하려면 해당 작업의 편집 아이콘을 선택한 후 [Edit action]에서 값을 변경합니다. 별표(*)로 표시된 항목은 필수 항목입니다.
  - CodeCommit 리포지토리 이름 및 브랜치의 경우 이 파이프라인에 대해 생성될 Amazon CloudWatch Events 규칙을 보여주는 메시지가 나타납니다. CodeCommit 소스를 제거하면 Amazon CloudWatch Events 규칙을 삭제해야 한다는 메시지가 나타납니다.
  - Amazon S3 원본 버킷의 경우 이 파이프라인에 대해 생성될 Amazon CloudWatch Events 규칙 및 AWS CloudTrail 트레일을 보여주는 메시지가 나타납니다. Amazon S3 소스를 제거하면 삭제해야 할 Amazon CloudWatch Events 규칙 및 AWS CloudTrail 트레일을 보여주는 메시지가 나타납니다. AWS CloudTrail 추적을 다른 파이프라인에서 사용하는 경우 추적이 제거되지 않고 데이터 이벤트는 삭제됩니다.
- 단계를 추가하려면 단계를 추가하려는 파이프라인의 지점에서 + Add stage(단계 추가)를 선택합니다. 단계의 이름을 입력한 다음 하나 이상의 작업을 추가합니다. 별표(*)로 표시된 항목은 필수 항목입니다.
- 단계를 삭제하려면 해당 단계의 삭제 아이콘을 선택합니다. 단계 및 해당 작업 모두가 삭제됩니다.
예를 들어, 파이프라인의 단계에 연쇄 작업을 추가하려면
1. 작업을 추가하려는 단계에서 Edit stage(단계 편집)를 선택한 다음, + Add action group(작업 그룹 추가)을 선택합니다.
2. Edit action(작업 편집)의 Action name(작업 이름)에 작업 이름을 입력합니다. Action provider(작업 공급자) 목록은 공급자 옵션을 범주별로 표시합니다. 해당 범주를 찾습니다(예: Deploy). 해당 범주에서 공급자를 선택합니다(예: AWS CodeDeploy). 리전에서 리소스가 생성된 또는 리소스를 생성하려는 AWS 리전을 선택합니다. 리전 필드는 이 작업 유형 및 공급자 유형에 대해 AWS 리소스가 생성되는 위치를 지정합니다. 이 필드는 작업 공급자가 AWS 서비스인 작업에 대해서만 표시합니다. 리전 필드의 기본값은 파이프 라인과 동일한 AWS 리전입니다.
  
  입력 및 출력 아티팩트의 이름과 사용 방법을 포함하여 에서의 CodePipeline 작업 요구 사항에 대한 자세한 내용은 을 참조하십시오CodePipeline의 작업 구조 요구 사항. 작업 공급자를 추가하고 각 공급자에 대한 기본 필드를 사용하는 예제는 파이프라인 생성(콘솔)을 참조하십시오.
  
  스테이지에 빌드 액션 또는 테스트 CodeBuild 액션으로 추가하려면 사용 CodePipeline 설명서의 CodeBuild CodeBuild with를 사용하여 코드 테스트 및 빌드 실행을 참조하십시오.
  
  참고
  예를 들어 일부 작업 제공자의 경우 제공자의 웹 사이트에 연결해야 작업 구성을 완료할 수 있습니다. GitHub 공급자의 웹 사이트에 연결할 때는 해당 웹 사이트의 자격 증명을 사용해야 합니다. AWS 자격 증명을 사용하지 마십시오.
3. 작업 구성을 마쳤으면 저장을 선택합니다.
참고
콘솔 보기에서는 스테이지 이름을 바꿀 수 없습니다. 변경하려는 이름으로 스테이지를 추가한 다음 이전 스테이지를 삭제할 수 있습니다. 기존 단계나 작업을 삭제하기 전에 해당 단계에 있어야 하는 모든 작업이 추가되었는지 확인합니다.
파이프라인 편집을 마쳤으면 저장을 선택하여 요약 페이지로 돌아갑니다.

중요
변경 내용을 저장한 후에는 취소할 수 없습니다. 파이프라인을 다시 편집해야 합니다. 변경 사항을 저장할 때 파이프라인을 통해 개정이 실행되고 있으면 실행이 완료되지 않습니다. 편집한 파이프라인을 통해 특정 커밋이나 변경 사항이 실행되도록 하려면 파이프라인을 통해 해당 커밋이나 변경 사항을 수동으로 실행해야 합니다. 그렇지 않으면, 다음 커밋이나 변경 사항이 파이프라인을 통해 자동으로 실행됩니다.
작업을 테스트하려면 변경 사항 배포를 선택하여 파이프라인을 통해 해당 커밋을 처리하거나, 파이프라인의 소스 단계에 지정되어 있는 소스에 대한 변경 사항을 커밋합니다. 또는 수동으로 파이프라인 시작의 단계를 따라 AWS CLI를 사용하여 변경 사항을 수동으로 릴리스합니다.

파이프라인 편집(AWS CLI)

update-pipeline 명령을 사용하여 파이프라인을 편집할 수 있습니다.

파이프라인을 업데이트하면 실행 중인 모든 작업을 CodePipeline 정상적으로 완료한 다음 실행 중인 작업이 완료된 단계 및 파이프라인 실행에 실패합니다. 파이프라인이 업데이트되면 파이프라인을 다시 실행해야 합니다. 파이프라인 실행에 대한 자세한 내용은 수동으로 파이프라인 시작 단원을 참조하세요.

중요

AWS CLI를 사용하여 파트너 작업을 포함한 파이프라인을 편집할 수 있지만 파트너 작업 자체의 JSON을 수동으로 편집해서는 안 됩니다. 이렇게 하면 파이프라인 업데이트 후 파트너 작업이 실패합니다.

파이프라인을 편집하려면

터미널 세션(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고 get-pipeline 명령을 실행하여 파이프라인 구조를 JSON 파일에 복사합니다. 예를 들어, MyFirstPipeline라는 파이프라인에서는 다음 명령을 입력합니다.
```
aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json
```
이 명령은 아무 것도 반환하지 않지만 생성한 파일이 명령을 실행한 디렉터리에 표시되어야 합니다.

일반 텍스트 편집기에서 JSON 파일을 열고 파일의 구조를 수정하여 파이프라인에 대한 변경 사항을 반영합니다. 예를 들어 단계를 추가 또는 제거하거나 기존 단계에 다른 작업을 추가할 수 있습니다.

다음 예에서는 pipeline.json 파일에 다른 배포 단계를 추가하는 방법을 보여 줍니다. 이 단계는 Staging이라는 첫 번째 배포 단계 이후에 실행됩니다.

참고

다음은 파일의 전체 구조가 아닌 일부입니다. 자세한 설명은 CodePipeline 파이프라인 구조 참조 섹션을 참조하세요.


,      
        {
            "name": "Staging",
            "actions": [
                    {
                        "inputArtifacts": [
                            {
                                "name": "MyApp"
                            }
                        ],
                        "name": "Deploy-CodeDeploy-Application",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                            "ApplicationName": "CodePipelineDemoApplication",
                            "DeploymentGroupName": "CodePipelineDemoFleet"
                        },
                        "runOrder": 1
                    }
                ]
             },      
        {
            "name": "Production",
            "actions":  [
                    {
                        "inputArtifacts": [
                            {
                                "name": "MyApp"
                            }
                        ],
                        "name": "Deploy-Second-Deployment",
                        "actionTypeId": {
                            "category": "Deploy",
                            "owner": "AWS",
                            "version": "1",
                            "provider": "CodeDeploy"
                        },
                        "outputArtifacts": [],
                        "configuration": {
                        "ApplicationName": "CodePipelineDemoApplication",
                        "DeploymentGroupName": "CodePipelineProductionFleet"
                        },
                        "runOrder": 1
                    }
                ]
        }
    ]
}

CLI를 사용하여 파이프라인에 승인 작업을 추가하는 방법에 대한 자세한 내용은 CodePipeline의 파이프라인에 수동 승인 작업 추가 단원을 참조하십시오.

JSON 파일의 PollForSourceChanges 파라미터는 다음과 같이 설정되어야 합니다.


                "PollForSourceChanges": "false",

CodePipeline Amazon CloudWatch Events를 사용하여 CodeCommit 소스 리포지토리와 브랜치 또는 Amazon S3 소스 버킷의 변경 사항을 감지합니다. 다음 단계에는 이러한 리소스를 수동으로 생성하기 위한 설명이 포함되어 있습니다. 플래그를 false로 설정하면 정기적 확인이 비활성화되어 권장되는 변경 감지 방법을 사용할 때 필요하지 않습니다.

파이프라인과 다른 리전에서 빌드, 테스트, 배포 작업을 추가하려면 파이프라인 구조에 다음을 추가해야 합니다. 자세한 지침은 CodePipeline에 교차 리전 작업 추가 섹션을 참조하세요.
- 작업 파이프라인 구조에 Region 파라미터를 추가합니다.
- artifactStores 파라미터를 사용하여 작업이 있는 각 리전에 대해 아티팩트 버킷을 지정합니다.
get-pipeline 명령을 사용하여 검색한 파이프라인 구조로 작업 중인 경우, JSON 파일의 구조를 수정해야 합니다. update-pipeline 명령이 JSON 파일을 사용할 수 있도록 하려면 이 파일에서 metadata 라인을 삭제해야 합니다. JSON 파일의 파이프라인 구조에서 단원("metadata": { } 행과 "created", "pipelineARN" 및 "updated" 필드)을 삭제합니다.

예를 들어, 구조에서 다음 행을 삭제합니다.
```
"metadata": {  
  "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name",
  "created": "date",
  "updated": "date"
  }
```
파일을 저장합니다.
CLI를 사용하여 파이프라인을 편집하는 경우 파이프라인에 대해 권장되는 변경 감지 리소스를 수동으로 관리해야 합니다.
- CodeCommit 리포지토리의 경우 에 설명된 대로 CloudWatch 이벤트 규칙을 생성해야 CodeCommit 소스에 대한 EventBridge 규칙 생성 (CLI) 합니다.
- Amazon S3 소스의 경우 에 설명된 대로 CloudWatch 이벤트 규칙 및 AWS CloudTrail 트레일을 생성해야 Amazon S3 소스 액션 EventBridge 및 AWS CloudTrail 합니다.
변경 사항을 적용하려면 파이프라인 JSON 파일을 지정하여 update-pipeline 명령을 실행합니다.

중요
파일 이름 앞에 file://를 포함해야 합니다. 이 명령에 필수적입니다.
```
aws codepipeline update-pipeline --cli-input-json file://pipeline.json
```
이 명령은 편집한 파이프라인의 전체 구조를 반환합니다.

참고
update-pipeline 명령을 실행하면 파이프라인이 중지됩니다. update-pipeline 명령을 실행할 때 파이프라인을 통해 개정을 실행하는 중이라면 해당 실행이 중지됩니다. 업데이트된 파이프라인을 통해 해당 개정을 실행하려면 파이프라인을 수동으로 시작해야 합니다.
CodePipeline 콘솔을 열고 방금 편집한 파이프라인을 선택합니다.

파이프라인에 변경 사항이 표시됩니다. 다음에 사용자가 소스 위치를 변경할 경우, 파이프라인의 개정된 구조를 통해 해당 개정이 실행됩니다.
파이프라인의 개정된 구조를 통해 마지막 개정을 수동으로 실행하려면 start-pipeline-execution 명령을 실행합니다. 자세한 설명은 수동으로 파이프라인 시작 섹션을 참조하세요.

파이프라인의 구조와 예상 값에 대한 자세한 내용은 CodePipeline 파이프라인 구조 참조 및 AWS CodePipeline API 참조를 참조하세요.

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

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

문서 규칙

자체 관리형 GitLab 연결

파이프라인 및 세부 정보 보기