스테이지에 대한 조건 구성

입력 조건 구성(콘솔)

1. AWS CloudWatchAlarm과 같이 리소스가 제공되는 규칙에 대한 리소스 및 ARN 생성과 같은 사전 조건을 완료합니다.

2. AWS Management Console에 로그인하여 http://console.aws.amazon.com/codesuite/codepipeline/home에서 CodePipeline 콘솔을 여세요.

   사용자의 AWS 계정에 연결된 모든 파이프라인의 이름과 상태가 표시됩니다.

3. [Name]에서 편집할 파이프라인의 이름을 선택합니다.

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

5. 편집 페이지에서 편집하려는 작업에 대해 스테이지 편집을 선택합니다.

6. 입력 조건 추가를 선택합니다. 스테이지 진입 전 조건 카드가 이 조건에 사용할 수 있는 실패 옵션과 함께 표시됩니다.

7. 규칙 추가를 선택하고 다음을 완료합니다.

   1. 규칙 이름에 규칙의 이름을 입력합니다. 이 예에서는 MyAlarmRule를 입력합니다.

   2. 규칙 공급자에서 조건에 추가할 사전 구성된 규칙 공급자를 선택합니다. 이 예에서는 AWS CloudWatchAlarm을 선택하고, 다음 단계를 완료합니다.

   3. 리전에서 조건에 맞는 리전을 선택하거나 기본값을 그대로 둡니다.

   4. 경보 이름에서 규칙에 사용할 CloudWatch 리소스를 선택합니다. 계정에 리소스를 이미 생성했어야 합니다.

   5. (선택 사항) 대기 시간에 경보가 처음 평가될 때 경보가 ALARM 상태인 경우 CodePipeline이 대기하는 시간을 입력합니다. 규칙을 처음 확인할 때 경보가 OK 상태인 경우 규칙이 즉시 성공합니다.

   6. (선택 사항) 모니터링할 특정 경보 상태를 입력하고 필요한 경우 역할 ARN을 입력합니다.

   7. 스테이지 편집을 완료하면 완료를 선택합니다. 파이프라인 편집 페이지에서 저장을 선택합니다.

8. 실행 후 결과를 확인합니다.

건너뛰기 결과를 사용하여 입력 조건 구성(콘솔)

1. AWS CloudWatchAlarm과 같이 리소스가 제공되는 규칙에 대한 리소스 및 ARN 생성과 같은 사전 조건을 완료합니다.

2. AWS Management Console에 로그인하여 http://console.aws.amazon.com/codesuite/codepipeline/home에서 CodePipeline 콘솔을 여세요.

   사용자의 AWS 계정에 연결된 모든 파이프라인의 이름과 상태가 표시됩니다.

3. [Name]에서 편집할 파이프라인의 이름을 선택합니다.

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

5. 편집 페이지에서 편집하려는 작업에 대해 스테이지 편집을 선택합니다.

6. 입력 조건 추가를 선택한 다음 결과로 건너뛰기를 선택합니다.

7. 규칙 추가를 선택하고 다음을 완료합니다.

   1. 규칙 이름에 규칙의 이름을 입력합니다. 이 예에서는 MyAlarmRule를 입력합니다.

   2. 규칙 공급자에서 조건에 추가할 사전 구성된 규칙 공급자를 선택합니다. 이 예제에서는 VariableCheck를 선택하고, 다음 단계를 완료합니다.

      

   3. 리전에서 조건에 맞는 리전을 선택하거나 기본값을 그대로 둡니다.

   4. 변수에서 GitHub 버전 2 소스 작업이 있는 파이프라인에 대한 #{SourceVariables.FullRepositoryName}과 같이 비교할 변수를 선택합니다. 리포지토리 이름을 입력하고 Equals와 같은 연산자를 선택합니다.

   5. 스테이지 편집을 완료하면 완료를 선택합니다. 파이프라인 편집 페이지에서 저장을 선택합니다.

8. 실행 후 결과를 확인합니다.

   

9. 세부 정보를 검토하려면 검토를 선택합니다. 다음 예제의 세부 정보는 조건에 대해 구성된 결과가 건너뛰기이며 재정의할 수 없음을 보여줍니다. 조건이 충족되지 않아 규칙 상태가 실패입니다.

   

조건 및 규칙 또는 규칙 구성(CLI)

• 터미널(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고 AWS CLI를 사용하여 update-pipeline 명령을 실행함으로써 파이프라인 구조의 실패 조건을 지정합니다. 다음 예제에서는 Deploy라는 이름의 스테이지에 대한 입력 조건을 구성합니다.

  {
      "name": "Deploy",
      "actions": [
          {
              "name": "Deploy",
              "actionTypeId": {
                  "category": "Deploy",
                  "owner": "AWS",
                  "provider": "S3",
                  "version": "1"
              },
              "runOrder": 1,
              "configuration": {
                  "BucketName": "MyBucket",
                  "Extract": "false",
                  "ObjectKey": "object.xml"
              },
              "outputArtifacts": [],
              "inputArtifacts": [
                  {
                      "name": "SourceArtifact"
                  }
              ],
              "region": "us-east-1",
              "namespace": "DeployVariables"
          }
      ],
      "beforeEntry": {
          "conditions": [
              {
                  "result": "FAIL",
                  "rules": [
                      {
                          "name": "MyAlarmRule",
                          "ruleTypeId": {
                              "category": "Rule",
                              "owner": "AWS",
                              "provider": "CloudWatchAlarm",
                              "version": "1"
                          },
                          "configuration": {
                              "AlarmName": "CWAlarm",
                              "WaitTime": "1"
                          },
                          "inputArtifacts": [],
                          "region": "us-east-1"
                      }
                  ]
              }
          ]
      }
  } 

  스테이지 롤백의 성공 조건 구성에 대한 자세한 내용은 CodePipeline API 참조의 SuccessConditions을 참조하세요.

• 다음 조각과 같이 템플릿을 업데이트합니다. 다음 예제에서는 MyMonitorRule이라는 규칙으로 입력 조건을 구성합니다.

  Name: Deploy
  Actions:
  - Name: Deploy
    ActionTypeId:
      Category: Deploy
      Owner: AWS
      Provider: S3
      Version: '1'
    RunOrder: 1
    Configuration:
      BucketName: MyBucket
      Extract: 'false'
      ObjectKey: object.xml
    OutputArtifacts: []
    InputArtifacts:
    - Name: SourceArtifact
    Region: us-east-1
    Namespace: DeployVariables
  BeforeEntry:
    Conditions:
    - Result: FAIL
      Rules:
      - Name: MyMonitorRule
        RuleTypeId:
          Category: Rule
          Owner: AWS
          Provider: CloudWatchAlarm
          Version: '1'
        Configuration:
          AlarmName: CWAlarm
          WaitTime: '1'
        InputArtifacts: []
        Region: us-east-1 

  beforeEntry 조건 구성에 대한 자세한 내용은 AWS CloudFormation 사용 설명서의 StageDeclaration에서 AWS::CodePipeline::Pipeline BeforeEntryConditions을 참조하세요.

실패 시 조건 구성(콘솔)

1. LambdaInvoke 규칙과 같이 리소스가 제공되는 규칙에 대한 리소스 및 ARN 생성과 같은 사전 조건을 완료합니다.

2. AWS Management Console에 로그인하여 http://console.aws.amazon.com/codesuite/codepipeline/home에서 CodePipeline 콘솔을 여세요.

   사용자의 AWS 계정에 연결된 모든 파이프라인의 이름과 상태가 표시됩니다.

3. [Name]에서 편집할 파이프라인의 이름을 선택합니다.

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

5. 편집 페이지에서 편집하려는 작업에 대해 스테이지 편집을 선택합니다.

6. 실패 조건 추가를 선택합니다. 실패 조건 카드가 이 조건에 사용할 수 있는 롤백 옵션과 함께 표시됩니다.

7. 규칙 추가를 선택하고 다음을 완료합니다.

   1. 규칙 이름에 규칙의 이름을 입력합니다. 이 예에서는 MyLambdaRule를 입력합니다.

   2. 규칙 공급자에서 조건에 추가할 사전 구성된 규칙 공급자를 선택합니다. 이 예에서는 AWS LambdaInvoke를 선택하고, 다음 단계를 완료합니다.

   3. 리전에서 조건에 맞는 리전을 선택하거나 기본값을 그대로 둡니다.

   4. 입력 아티팩트에서 소스 아티팩트를 선택합니다.

   5. 함수 이름에서 규칙에 사용할 Lambda 리소스를 선택합니다. 계정에 리소스를 이미 생성했어야 합니다.

   6. (선택 사항) 사용자 파라미터에 추가 구성을 위한 파라미터를 나타내는 모든 페어를 입력합니다.

   7. (선택 사항) 역할 ARN에서 구성된 경우 역할 ARN을 입력합니다.

   8. (선택 사항) 제한 시간(분)에 규칙이 제한 시간 전에 기다려야 하는 시간을 분 단위로 입력합니다.

   9. 스테이지 편집을 완료하면 완료를 선택합니다. 파이프라인 편집 페이지에서 저장을 선택합니다.

재시도 결과로 onFailure 조건 구성(콘솔)

1. AWS CloudWatchAlarm과 같이 리소스가 제공되는 규칙에 대한 리소스 및 ARN 생성과 같은 사전 조건을 완료합니다.

2. AWS Management Console에 로그인하여 http://console.aws.amazon.com/codesuite/codepipeline/home에서 CodePipeline 콘솔을 여세요.

   사용자의 AWS 계정에 연결된 모든 파이프라인의 이름과 상태가 표시됩니다.

3. [Name]에서 편집할 파이프라인의 이름을 선택합니다.

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

5. 편집 페이지에서 편집하려는 작업에 대해 스테이지 편집을 선택합니다.

6. 스테이지 하단의 자동화된 스테이지 구성:에서 스테이지 장애 시 자동 재시도 활성화를 선택합니다. 재시도 모드에서 실패한 단계 재시도 또는 실패한 작업 재시도 중 하나를 선택합니다.

   

7. onFailure 조건을 추가하도록 선택한 다음 규칙 추가를 선택하고 조건에 대한 규칙을 입력합니다.

   1. 규칙 이름에 규칙의 이름을 입력합니다. 이 예에서는 MyAlarmRule를 입력합니다.

   2. 규칙 공급자에서 조건에 추가할 사전 구성된 규칙 공급자를 선택합니다. 이 예에서는 CloudWatchAlarm을 선택하고, 다음 단계를 완료합니다.

   3. 리전에서 조건에 맞는 리전을 선택하거나 기본값을 그대로 둡니다.

   4. 경보 이름에서 경보에 대해 구성된 리소스를 선택합니다.

   5. 스테이지 편집을 완료하면 완료를 선택합니다. 파이프라인 편집 페이지에서 저장을 선택합니다.

8. 실행 후 결과를 확인합니다.

조건 및 규칙 또는 규칙 구성(CLI)

• 터미널(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고 AWS CLI를 사용하여 update-pipeline 명령을 실행함으로써 파이프라인 구조의 실패 조건을 지정합니다. 다음 예제에서는 Deploy라는 이름의 스테이지에 대한 실패 시 조건을 구성합니다.

  {
      "name": "Deploy",
      "actions": [
          {
              "name": "Deploy",
              "actionTypeId": {
                  "category": "Deploy",
                  "owner": "AWS",
                  "provider": "S3",
                  "version": "1"
              },
              "runOrder": 1,
              "configuration": {
                  "BucketName": "MyBucket",
                  "Extract": "false",
                  "ObjectKey": "object.xml"
              },
              "outputArtifacts": [],
              "inputArtifacts": [
                  {
                      "name": "SourceArtifact"
                  }
              ],
              "region": "us-east-1",
              "namespace": "DeployVariables"
          }
      ],
      "onFailure": {
          "conditions": [
              {
                  "result": "ROLLBACK",
                  "rules": [
                      {
                          "name": "MyLambdaRule",
                          "ruleTypeId": {
                              "category": "Rule",
                              "owner": "AWS",
                              "provider": "LambdaInvoke",
                              "version": "1"
                          },
                          "configuration": {
                              "FunctionName": "my-function"
                          },
                          "inputArtifacts": [
                              {
                                  "name": "SourceArtifact"
                              }
                          ],
                          "region": "us-east-1"
                      }
                  ]
              }
          ]
      }
  }

  실패 조건 구성에 대한 자세한 내용은 CodePipeline API 참조의 FailureConditions을 참조하세요.

• 다음 조각과 같이 템플릿을 업데이트합니다. 다음 예제에서는 MyMonitorRule이라는 규칙으로 OnFailure 조건을 구성합니다.

  name: Deploy
  actions:
  - name: Deploy
    actionTypeId:
      category: Deploy
      owner: AWS
      provider: S3
      version: '1'
    runOrder: 1
    configuration:
      BucketName: MyBucket
      Extract: 'false'
      ObjectKey: object.xml
    outputArtifacts: []
    inputArtifacts:
    - name: SourceArtifact
    region: us-east-1
    namespace: DeployVariables
  onFailure:
    conditions:
    - result: ROLLBACK
      rules:
      - name: MyMonitorRule
        ruleTypeId:
          category: Rule
          owner: AWS
          provider: CloudWatchAlarm
          version: '1'
        configuration:
          AlarmName: AlarmOnHelloWorldInvocation
          AlarmStates: ALARM
          WaitTime: '1'
        inputArtifacts: []
        region: us-east-1
  

  실패 조건 구성에 대한 자세한 내용은 AWS CloudFormation 사용 설명서에서 StageDeclaration 아래의 OnFailure를 참조하세요.

성공 시 조건 구성(콘솔)

1. AWS LambdaRule과 같이 리소스가 제공되는 규칙에 대한 리소스 및 ARN 생성과 같은 사전 조건을 완료합니다.

2. AWS Management Console에 로그인하여 http://console.aws.amazon.com/codesuite/codepipeline/home에서 CodePipeline 콘솔을 여세요.

   사용자의 AWS 계정에 연결된 모든 파이프라인의 이름과 상태가 표시됩니다.

3. [Name]에서 편집할 파이프라인의 이름을 선택합니다.

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

5. 편집 페이지에서 편집하려는 작업에 대해 스테이지 편집을 선택합니다.

6. 성공 조건 추가를 선택합니다. 온스테이지 성공 조건 카드가 표시됩니다. 이 조건 유형에 사용 가능한 결과로 표시된 롤백 또는 실패 옵션을 선택합니다.

7. 규칙 추가를 선택하고 다음을 완료합니다.

   1. 규칙 이름에 조건의 이름을 입력합니다. 이 예에서는 MyDeploymentRule를 입력합니다.

   2. 규칙 공급자에서 조건에 추가할 사전 구성된 규칙을 선택합니다. 이 예에서는 AWS DeploymentWindow를 선택하고, 다음 단계를 완료합니다.

   3. 리전에서 조건에 맞는 리전을 선택하거나 기본값을 그대로 둡니다.

   4. Cron에 배포 기간의 cron 표현식을 입력합니다. cron 표현식은 배포가 허용되어야 하는 날짜와 시간을 정의합니다. cron 표현식에 대한 참조 정보는 cron 및 rate 표현식을 사용하여 규칙 예약을 참조하세요.

   5. (선택 사항) TimeZone에 배포 기간의 시간대를 입력합니다.

8. 실행 후 결과를 확인합니다.

   

조건 및 규칙 또는 규칙 구성(CLI)

• 터미널(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고 AWS CLI를 사용하여 update-pipeline 명령을 실행함으로써 파이프라인 구조의 실패 조건을 지정합니다. 다음 예제에서는 규칙 이름이 MyDeploymentRule인 Deploy라는 이름의 스테이지에 대한 성공 시 조건을 구성합니다.

  {
      "name": "Deploy",
      "actions": [
          {
              "name": "Deploy",
              "actionTypeId": {
                  "category": "Deploy",
                  "owner": "AWS",
                  "provider": "S3",
                  "version": "1"
              },
              "runOrder": 1,
              "configuration": {
                  "BucketName": "MyBucket",
                  "Extract": "false",
                  "ObjectKey": "object.xml"
              },
              "outputArtifacts": [],
              "inputArtifacts": [
                  {
                      "name": "SourceArtifact"
                  }
              ],
              "region": "us-east-1",
              "namespace": "DeployVariables"
          }
      ],
      "onSuccess": {
         "conditions": [
              {
                  "result": "FAIL",
                  "rules": [
                      {
                          "name": "MyAlarmRule",
                          "ruleTypeId": {
                              "category": "Rule",
                              "owner": "AWS",
                              "provider": "CloudWatchAlarm",
                              "version": "1"
                          },
                          "configuration": {
                              "AlarmName": "CWAlarm",
                              "WaitTime": "1"
                          },
                          "inputArtifacts": [],
                          "region": "us-east-1"
                      }
                  ]
              }
          ]
      }
  }

  성공 조건 구성에 대한 자세한 내용은 CodePipeline API 참조의 SuccessConditions을 참조하세요.

• 다음 조각과 같이 템플릿을 업데이트합니다. 다음 예제에서는 MyDeploymentWindowRule이라는 규칙으로 OnSuccess 조건을 구성합니다.

  name: Deploy
  actions:
  - name: Deploy
    actionTypeId:
      category: Deploy
      owner: AWS
      provider: S3
      version: '1'
    runOrder: 1
    configuration:
      BucketName: MyBucket
      Extract: 'false'
      ObjectKey: object.xml
    outputArtifacts: []
    inputArtifacts:
    - name: SourceArtifact
    region: us-east-1
    namespace: DeployVariables
  onSuccess:
     conditions:
    - result: FAIL
      rules:
      - name: MyMonitorRule
        ruleTypeId:
          category: Rule
          owner: AWS
          provider: CloudWatchAlarm
          version: '1'
        configuration:
          AlarmName: CWAlarm
          WaitTime: '1'
        inputArtifacts: []
        region: us-east-1
  

  스테이지 롤백의 실패 조건 구성에 대한 자세한 내용은 AWS CloudFormation 사용 설명서에서 StageDeclaration 아래의 OnFailure를 참조하세요.

스테이지 조건을 삭제하려면

1. AWS Management Console에 로그인하여 http://console.aws.amazon.com/codesuite/codepipeline/home에서 CodePipeline 콘솔을 여세요.

   사용자의 AWS 계정에 연결된 모든 파이프라인의 이름과 상태가 표시됩니다.

2. [Name]에서 편집할 파이프라인의 이름을 선택합니다.

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

4. 편집 페이지에서 편집하려는 조건에 대해 스테이지 편집을 선택합니다.

5. 삭제하려는 조건 옆에 있는 조건 삭제를 선택합니다.

스테이지 조건을 재정의하려면

1. 이 예제에서는 파이프라인 단계가 조건과 함께 실행됩니다. 재정의 버튼이 활성화됩니다.

   

2. 재정의하려는 조건 옆에 있는 재정의를 선택합니다.

   

3. 세부 정보를 검토하려면 검토를 선택합니다. 다음 예제의 세부 정보는 조건에 대해 구성된 결과가 실패이며 재정의되었음을 보여줍니다. 규칙 상태는 재정의로 인해 중단됨 상태입니다.