에서 파이프라인 편집 CodePipeline - AWS CodePipeline

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

에서 파이프라인 편집 CodePipeline

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

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

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

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

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

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

참고

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

파이프라인 편집(콘솔)

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

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

파이프라인을 편집하려면
  1. 에 로그인 AWS Management Console 하고 http://console.aws.amazon.com/codesuite/codepipeline/home CodePipeline 콘솔을 엽니다.

    AWS 계정과 연결된 모든 파이프라인의 이름이 표시됩니다.

  2. [Name]에서 편집할 파이프라인의 이름을 선택합니다. 이렇게 하면 파이프라인 각 단계의 각 작업 상태를 포함하여 파이프라인의 세부 정보 보기가 열립니다.

  3. 파이프라인 세부 정보 페이지에서 [Edit]를 선택합니다.

  4. 파이프라인 유형을 편집하려면 편집: 파이프라인 속성 카드에서 편집을 선택합니다. 다음 옵션 중 하나를 선택한 다음 완료를 선택합니다.

    • V1 유형 파이프라인에는 표준 파이프라인, 단계 및 작업 수준 파라미터가 포함된 JSON 구조가 있습니다.

    • V2 유형 파이프라인은 트리거 및 파이프라인 수준 변수와 같은 추가 매개변수 지원과 함께 V1 유형과 구조가 동일합니다.

    파이프라인 유형은 특성과 가격이 다릅니다. 자세한 내용은 파이프라인 유형 단원을 참조하십시오.

  5. 파이프라인 변수를 편집하려면 편집: 변수 카드에서 변수 편집을 선택합니다. 파이프라인 수준의 변수를 추가하거나 변경한 다음 완료를 선택합니다.

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

    참고

    파이프라인 수준에서 변수를 추가하는 것은 선택 사항이지만, 값이 제공되지 않은 파이프라인 수준의 변수로 지정된 파이프라인의 경우 파이프라인 실행이 실패합니다.

  6. 파이프라인 트리거를 편집하려면 편집: 트리거 카드에서 트리거 편집을 선택합니다. 트리거를 추가 또는 변경한 다음 완료를 선택합니다.

    트리거 추가에 대한 자세한 내용은 Bitbucket Cloud, GitHub (버전 2), GitHub Enterprise Server, GitLab.com 또는 GitLab 와 같은 자체 관리형에 대한 연결을 생성하는 단계를 참조하세요GitHub 연결.

  7. 편집 페이지에서 단계 및 작업을 편집하려면 다음 중 하나를 수행합니다.

    • 단계를 편집하려면 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 리전으로 설정됩니다.

      작업 공급자를 추가하고 각 공급자에 대한 기본 필드를 사용하는 예제는 사용자 지정 파이프라인 생성(콘솔)을 참조하십시오.

      단계에 빌드 작업 또는 테스트 작업 CodeBuild 으로 를 추가하려면 CodeBuild 사용 설명서 CodeBuild 와 CodePipeline 함께 코드 테스트 및 빌드 실행을 참조하세요.

      참고

      와 같은 일부 작업 공급자는 작업 구성을 완료하기 전에 공급자의 웹 사이트에 연결 GitHub해야 합니다. 공급자의 웹 사이트에 연결할 때는 해당 웹 사이트의 자격 증명을 사용해야 합니다. AWS 자격 증명을 사용하지 마세요.

    3. 작업 구성을 마쳤으면 저장을 선택합니다.

    참고

    콘솔 보기에서는 스테이지 이름을 바꿀 수 없습니다. 변경하려는 이름으로 스테이지를 추가한 다음 이전 스테이지를 삭제할 수 있습니다. 기존 단계나 작업을 삭제하기 전에 해당 단계에 있어야 하는 모든 작업이 추가되었는지 확인합니다.

  8. 파이프라인 편집을 마쳤으면 저장을 선택하여 요약 페이지로 돌아갑니다.

    중요

    변경 내용을 저장한 후에는 취소할 수 없습니다. 파이프라인을 다시 편집해야 합니다. 변경 사항을 저장할 때 파이프라인을 통해 개정이 실행되고 있으면 실행이 완료되지 않습니다. 편집한 파이프라인을 통해 특정 커밋이나 변경 사항이 실행되도록 하려면 파이프라인을 통해 해당 커밋이나 변경 사항을 수동으로 실행해야 합니다. 그렇지 않으면, 다음 커밋이나 변경 사항이 파이프라인을 통해 자동으로 실행됩니다.

  9. 작업을 테스트하려면 변경 사항 릴리스를 선택하여 파이프라인을 통해 해당 커밋을 처리하거나, 파이프라인의 소스 단계에 지정되어 있는 소스에 대한 변경 사항을 커밋합니다. 또는 의 단계에 따라 수동으로 파이프라인 시작를 사용하여 변경 사항을 AWS CLI 수동으로 릴리스합니다.

파이프라인 편집(AWS CLI)

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

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

중요

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

파이프라인을 편집하려면
  1. 터미널 세션(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고 get-pipeline 명령을 실행하여 파이프라인 구조를 JSON 파일로 복사합니다. 예를 들어, MyFirstPipeline라는 파이프라인에서는 다음 명령을 입력합니다.

    aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

    이 명령은 아무 것도 반환하지 않지만 생성한 파일이 명령을 실행한 디렉터리에 표시되어야 합니다.

  2. 일반 텍스트 편집기에서 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로 설정하면 정기적 확인이 비활성화되어 권장되는 변경 감지 방법을 사용할 때 필요하지 않습니다.

  3. 파이프라인과 다른 리전에서 빌드, 테스트, 배포 작업을 추가하려면 파이프라인 구조에 다음을 추가해야 합니다. 자세한 지침은 에 지역 간 액션 추가 CodePipeline 섹션을 참조하십시오.

    • 작업 파이프라인 구조에 Region 파라미터를 추가합니다.

    • artifactStores 파라미터를 사용하여 작업이 있는 각 리전에 대해 아티팩트 버킷을 지정합니다.

  4. 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" }

    파일을 저장합니다.

  5. CLI 를 사용하여 파이프라인을 편집하는 경우 파이프라인에 권장되는 변경 감지 리소스를 수동으로 관리해야 합니다.

  6. 변경 사항을 적용하려면 명령을 실행하고 파이프라인 JSON 파일을 update-pipeline 지정합니다.

    중요

    파일 이름 앞에 file://를 포함해야 합니다. 이 명령에 필수적입니다.

    aws codepipeline update-pipeline --cli-input-json file://pipeline.json

    이 명령은 편집한 파이프라인의 전체 구조를 반환합니다.

    참고

    update-pipeline 명령을 실행하면 파이프라인이 중지됩니다. update-pipeline 명령을 실행할 때 파이프라인을 통해 개정을 실행하는 중이라면 해당 실행이 중지됩니다. 업데이트된 파이프라인을 통해 해당 개정을 실행하려면 파이프라인을 수동으로 시작해야 합니다.

  7. CodePipeline 콘솔을 열고 방금 편집한 파이프라인을 선택합니다.

    파이프라인에 변경 사항이 표시됩니다. 다음에 사용자가 소스 위치를 변경할 경우, 파이프라인의 개정된 구조를 통해 해당 개정이 실행됩니다.

  8. 파이프라인의 개정된 구조를 통해 마지막 개정을 수동으로 실행하려면 start-pipeline-execution 명령을 실행합니다. 자세한 내용은 수동으로 파이프라인 시작 단원을 참조하십시오.

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