Automatizar a inicialização de pipelines usando gatilhos e filtragem

Para um único tipo de filtro, como pull request, você pode combinar filtros, e esses filtros usarão uma operação AND, o que significa que somente uma correspondência completa iniciará o pipeline. O exemplo a seguir mostra uma configuração do Git para um tipo de evento push com dois filtros diferentes (filePathsebranches). No exemplo a seguir, filePaths será usado com o operador E e com branches:

{
  "filePaths": {
    "includes": ["common/**/*.js"]
  },
  "branches": {
    "includes": ["feature/**"]
  }
}

Com a configuração do Git acima, este exemplo mostra um evento que iniciará a execução do pipeline porque o uso do operador E foi bem-sucedido. Em outras palavras, o caminho do arquivo common/app.js é incluído para o filtro, que inicia o pipeline como AND mesmo que a ramificação refs/heads/feature/triggers especificada não tenha tido impacto.

{
  "ref": "refs/heads/feature/triggers",
  ...
  "commits": [
    {
      ...
      "modified": [
        "common/app.js"
      ]
      ...
    }
  ]
}

O exemplo a seguir mostra um evento para um acionador com a configuração acima que não iniciará a execução do pipeline porque a ramificação é capaz de filtrar, mas o caminho do arquivo não.

{
   "ref": "refs/heads/feature/triggers",
  ...
  "commits": [
    {
      ...
      "modified": [
        "src/Main.java"
      ]
      ...
    }
  ]
}

Filtros de gatilho, como ramificação em um único tipo de evento de pull request, usam uma operação AND entre as inclusões e as exclusões. Isso permite que você configure vários gatilhos para iniciar a execução no mesmo pipeline. O exemplo a seguir mostra uma configuração de gatilho com um único tipo de filtro (branches) no objeto de configuração para um evento push. As Excludes operações Includes e serão And'ed, o que significa que, se uma ramificação corresponder a um padrão de exclusão (como feature-branch no exemplo), o pipeline não será acionado, a menos que uma inclusão também corresponda. Se o padrão de inclusão corresponder, como no caso da ramificação main, o pipeline será acionado.

Para o exemplo a seguir, JSON:

{
  "branches": {
      "Includes": [
          "main"
      ],
      "Excludes": [
          "feature-branch"
      ]
   }

Os objetos de configuração do gatilho, como um acionador que contém um tipo de evento push e um tipo de evento pull request, usam uma operação OR entre os dois tipos de eventos. O exemplo a seguir mostra uma configuração de gatilho com um tipo de evento push com a main ramificação incluída e um tipo de evento de pull request com a mesma ramificação main excluída. Além disso, o tipo de evento push tem um caminho de arquivo LICENSE.txt excluído e um caminho de arquivo README.MD incluído. Para o segundo tipo de evento, uma pull request que está na ramificação Closed ou Created na feature-branch ramificação (incluída) inicia o pipeline, e o pipeline não inicia ao criar ou fechar uma pull request na ramificação feature-branch-2 ou nas main ramificações (excluídas). As Excludes operações Includes e serão AND, com um conflito assumindo como padrão a exclusão. Por exemplo, para um evento de pull request na feature-branch ramificação (incluído na pull request) enquanto a feature-branch ramificação é excluída para o tipo de evento push, então o padrão será excluir.

Para o exemplo a seguir,

A imagem a seguir mostra a configuração.

Veja a seguir um exemplo de JSON para a configuração.

"triggers": [
            {
                "providerType": "CodeStarSourceConnection",
                "gitConfiguration": {
                    "sourceActionName": "Source",
                    "push": [
                        {
                            "branches": {
                                "includes": [
                                    "main"
                                ],
                                "excludes": [
                                    "feature-branch",
                                    "feature-branch-2"
                                ]
                            },
                            "filePaths": {
                                "includes": [
                                    "README.md"
                                ],
                                "excludes": [
                                    "LICENSE.txt"
                                ]
                            }
                        }
                    ],
                    "pullRequest": [
                        {
                            "events": [
                                "CLOSED",
                                "OPEN"
                            ],
                            "branches": {
                                "includes": [
                                    "feature-branch"
                                ],
                                "excludes": [
                                    "feature-branch-2",
                                    "main"
                                ]
                            }
                        }
                    ]
                }
            }
        ]
    },

A imagem a seguir mostra um tipo de filtro push especificando o filtro na tag release-1 (incluído). Um segundo tipo de filtro de pressão é adicionado especificando filtrar na ramificação main (incluído) e não iniciar o envio para as feature* ramificações (excluído).

Para o seguinte exemplo:

O exemplo a seguir da página Editar mostra os dois tipos de filtros push e suas configurações para inclusões e exclusões.

O BranchName campo padrão de configuração da ação define uma única ramificação que será usada quando o pipeline for iniciado manualmente, enquanto acionadores com filtros podem ser usados para qualquer ramificação ou ramificações que você especificar.

Veja a seguir um exemplo de JSON para a configuração da ação que mostra o BranchName campo.

{
                "name": "Source",
                "actions": [
                    {
                        "name": "Source",
                        "actionTypeId": {
                            "category": "Source",
                            "owner": "AWS",
                            "provider": "CodeStarSourceConnection",
                            "version": "1"
                        },
                        "runOrder": 1,
                        "configuration": {
                            "BranchName": "main",
                            "ConnectionArn": "ARN",
                            "DetectChanges": "false",
                            "FullRepositoryId": "owner-name/my-bitbucket-repo",
                            "OutputArtifactFormat": "CODE_ZIP"
                        },
                        "outputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "inputArtifacts": [],
                        "region": "us-west-2",
                        "namespace": "SourceVariables"
                    }
                ],

O exemplo de saída de ação a seguir mostra que a ramificação principal padrão foi usada quando o pipeline foi iniciado manualmente.

O exemplo de saída de ação a seguir mostra a pull request e a ramificação que foram usadas para o gatilho quando filtradas por pull request.