为阶段配置条件

配置“入口”条件（控制台）

1. 完成所有前提条件，例如为提供资源的规则（如 Amazon CloudWatchAlarm）创建资源和 ARN。

2. 通过以下网址登录Amazon Web Services 管理控制台并打开 CodePipeline 控制台：http://console.aws.amazon.com/codesuite/codepipeline/home。

   显示所有与您的 Amazon Web Services 账户关联的管道的名称和状态。

3. 在 Name 中，选择您要编辑的管道的名称。

4. 在管道详细信息页中，选择编辑。

5. 在编辑页面上，对于要编辑的操作，选择编辑阶段。

6. 选择添加入口条件。此时将显示阶段前入口条件卡，其中包含适用于该条件的失败选项。

7. 选择添加规则，然后完成以下操作。

   1. 在规则名称中，输入规则的名称。在此示例中，请输入 MyAlarmRule。

   2. 在规则提供程序中，选择要添加到条件中的预配置规则提供程序。在此示例中，选择 Amazon CloudWatchAlarm，然后完成以下步骤。

   3. 在区域中，选择适合您条件的区域或保留默认值。

   4. 在警报名称中，选择要用于规则的 CloudWatch 资源。您必须已在账户中创建了资源。

   5. （可选）在等待时间中，输入首次评估警报时，如果警报处于 ALARM 状态，CodePipeline 将等待的时间。如果首次检查规则时警报处于 OK 状态，则规则会立即成功执行。

   6. （可选）输入要监控的任何特定警报状态，并酌情输入角色 ARN。

   7. 完成阶段编辑后，选择完成。在管道编辑页面上，选择保存。

8. 运行后，查看结果。

配置使用跳过结果的“入口”条件（控制台）

1. 完成所有前提条件，例如为提供资源的规则（如 Amazon CloudWatchAlarm）创建资源和 ARN。

2. 通过以下网址登录Amazon Web Services 管理控制台并打开 CodePipeline 控制台：http://console.aws.amazon.com/codesuite/codepipeline/home。

   显示所有与您的 Amazon Web Services 账户关联的管道的名称和状态。

3. 在 Name 中，选择您要编辑的管道的名称。

4. 在管道详细信息页中，选择编辑。

5. 在编辑页面上，对于要编辑的操作，选择编辑阶段。

6. 选择添加入口条件，然后选择跳过作为结果。

7. 选择添加规则，然后完成以下操作。

   1. 在规则名称中，输入规则的名称。在此示例中，请输入 MyAlarmRule。

   2. 在规则提供程序中，选择要添加到条件中的预配置规则提供程序。在此示例中，选择 VariableCheck，然后完成以下步骤。

      

   3. 在区域中，选择适合您条件的区域或保留默认值。

   4. 在变量中，选择要与之比较的变量，如 #{SourceVariables.FullRepositoryName} 用于具有 GitHub（通过 GitHub 应用程序）源操作的管道。输入存储库名称并选择运算符，如等于。

   5. 完成阶段编辑后，选择完成。在管道编辑页面上，选择保存。

8. 运行后，查看结果。

   

9. 要查看详细信息，请选择查看。以下示例中的详细信息显示，条件的配置结果为跳过，不能覆盖。由于不满足条件，规则状态为失败。

   

配置条件和一条或多条规则（CLI）

• 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows），并使用 Amazon 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 条件的更多信息，请参阅《Amazon CloudFormation 用户指南》中的 StageDeclaration 下的 AWS::CodePipeline::Pipeline BeforeEntryConditions。

配置“失败时”条件（控制台）

1. 完成所有前提条件，例如为提供资源的规则（如 LambdaInvoke 规则）创建资源和 ARN。

2. 通过以下网址登录Amazon Web Services 管理控制台并打开 CodePipeline 控制台：http://console.aws.amazon.com/codesuite/codepipeline/home。

   显示所有与您的 Amazon Web Services 账户关联的管道的名称和状态。

3. 在 Name 中，选择您要编辑的管道的名称。

4. 在管道详细信息页中，选择编辑。

5. 在编辑页面上，对于要编辑的操作，选择编辑阶段。

6. 选择添加失败条件。此时将显示失败条件卡，其中包含适用于该条件的回滚选项。

7. 选择添加规则，然后完成以下操作。

   1. 在规则名称中，输入规则的名称。在此示例中，请输入 MyLambdaRule。

   2. 在规则提供程序中，选择要添加到条件中的预配置规则提供程序。在此示例中，选择 Amazon LambdaInvoke，然后完成以下步骤。

   3. 在区域中，选择适合您条件的区域或保留默认值。

   4. 在输入构件中，选择源构件。

   5. 在函数名称中，选择要用于规则的 Lambda 资源。您必须已在账户中创建了资源。

   6. （可选）在用户参数中，输入任何代表附加配置参数的配对。

   7. （可选）在角色 ARN 中，输入角色 ARN（如果已配置）。

   8. （可选）在超时（以分钟为单位）中，输入规则在超时之前应等待的时间（以分钟为单位）。

   9. 完成阶段编辑后，选择完成。在管道编辑页面上，选择保存。

配置使用“重试”结果的 onFailure 条件（控制台）

1. 完成所有前提条件，例如为提供资源的规则（如 Amazon CloudWatchAlarm）创建资源和 ARN。

2. 通过以下网址登录Amazon Web Services 管理控制台并打开 CodePipeline 控制台：http://console.aws.amazon.com/codesuite/codepipeline/home。

   显示所有与您的 Amazon Web Services 账户关联的管道的名称和状态。

3. 在 Name 中，选择您要编辑的管道的名称。

4. 在管道详细信息页中，选择编辑。

5. 在编辑页面上，对于要编辑的操作，选择编辑阶段。

6. 在阶段底部的自动阶段配置:下，选择启用阶段失败时的自动重试。在重试模式中，选择重试失败的阶段或重试失败的操作。

   

7. 选择添加 onFailure 条件，然后选择添加规则并输入条件规则。

   1. 在规则名称中，输入规则的名称。在此示例中，请输入 MyAlarmRule。

   2. 在规则提供程序中，选择要添加到条件中的预配置规则提供程序。在此示例中，选择 CloudWatchAlarm，然后完成以下步骤。

   3. 在区域中，选择适合您条件的区域或保留默认值。

   4. 在警报名称中，为警报选择已配置的资源。

   5. 完成阶段编辑后，选择完成。在管道编辑页面上，选择保存。

8. 运行后，查看结果。

配置条件和一条或多条规则（CLI）

• 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows），并使用 Amazon 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
  

  有关配置失败条件的更多信息，请参阅《Amazon CloudFormation 用户指南》中的 StageDeclaration 下的 OnFailure。

配置“成功时”条件（控制台）

1. 完成所有前提条件，例如为提供资源的规则（如 Amazon LambdaRule）创建资源和 ARN。

2. 通过以下网址登录Amazon Web Services 管理控制台并打开 CodePipeline 控制台：http://console.aws.amazon.com/codesuite/codepipeline/home。

   显示所有与您的 Amazon Web Services 账户关联的管道的名称和状态。

3. 在 Name 中，选择您要编辑的管道的名称。

4. 在管道详细信息页中，选择编辑。

5. 在编辑页面上，对于要编辑的操作，选择编辑阶段。

6. 选择添加成功条件。此时将显示阶段成功条件卡。选择显示为该条件类型的可用结果的回滚或失败选项。

7. 选择添加规则，然后完成以下操作。

   1. 在规则名称中，输入条件的名称。在此示例中，请输入 MyDeploymentRule。

   2. 在规则提供程序中，选择要添加到条件中的预配置规则。在此示例中，选择 Amazon DeploymentWindow，然后完成以下步骤。

   3. 在区域中，选择适合您条件的区域或保留默认值。

   4. 在 Cron 中，输入部署窗口的 cron 表达式。cron 表达式定义了允许部署的天数和时间。有关 cron 表达式的参考信息，请参阅使用 cron 和 rate 表达式计划规则。

   5. （可选）在时区中，输入部署窗口的时区。

8. 运行后，查看结果。

   

配置条件和一条或多条规则（CLI）

• 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows），并使用 Amazon CLI 运行 update-pipeline 命令，指定管道结构中的失败条件。下面的示例为名为 Deploy 的阶段配置了“成功时”条件，其中的规则名为 MyDeploymentRule：

  {
      "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
  

  有关配置阶段回滚失败条件的更多信息，请参阅《Amazon CloudFormation 用户指南》中的 StageDeclaration 下的 OnFailure。

删除阶段条件

1. 通过以下网址登录Amazon Web Services 管理控制台并打开 CodePipeline 控制台：http://console.aws.amazon.com/codesuite/codepipeline/home。

   显示所有与您的 Amazon Web Services 账户关联的管道的名称和状态。

2. 在 Name 中，选择您要编辑的管道的名称。

3. 在管道详细信息页中，选择编辑。

4. 在编辑页面上，对于要编辑的条件，选择编辑阶段。

5. 在要删除的条件旁边，选择删除条件。

覆盖阶段条件

1. 在此示例中，管道阶段在条件下运行。覆盖按钮已启用。

   

2. 在要覆盖的条件旁边，选择覆盖。

   

3. 要查看详细信息，请选择查看。以下示例中的详细信息显示，条件的配置结果为“失败”，但已被覆盖。由于覆盖，规则状态为 Abandoned。