As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Inicia o pipeline quando uma nova confirmação é feita no CodeCommit repositório e na ramificação configurados.
Se você usa o console para criar ou editar o pipeline, CodePipeline cria uma EventBridge regra que inicia seu pipeline quando ocorre uma alteração no repositório.
nota
Para Amazon ECR, Amazon S3 CodeCommit ou fontes, você também pode criar uma substituição de origem usando a entrada de transformação de entrada para usar revisionValue o EventBridge in para seu evento de pipeline, onde revisionValue o é derivado da variável de evento de origem para sua chave de objeto, confirmação ou ID de imagem. Para obter mais informações, consulte a etapa opcional para a entrada da transformação de entrada incluída nos procedimentos em Recursos e ações de origem do Amazon ECR EventBridge Conectando-se às ações de origem do Amazon S3 com uma fonte habilitada para eventos, ouCodeCommit ações de origem e EventBridge.
Você já deve ter criado um CodeCommit repositório antes de conectar o pipeline por meio de uma CodeCommit ação.
Depois que uma alteração de código é detectada, você tem as seguintes opções para passar o código para ações subsequentes:
-
Padrão — Configura a ação de CodeCommit origem para gerar um arquivo ZIP com uma cópia superficial do seu commit.
-
Clone completo: configura a ação de origem para gerar uma referência de URL do Git para o repositório nas ações subsequentes.
Atualmente, a referência de URL do Git só pode ser usada por CodeBuild ações downstream para clonar o repositório e os metadados do Git associados. A tentativa de passar uma referência de URL do Git para CodeBuild não-ações resulta em um erro.
Tópicos
Tipo de ação
-
Categoria:
Source -
Proprietário:
AWS -
Fornecedor:
CodeCommit -
Versão:
1
Parâmetros de configuração
- RepositoryName
-
Obrigatório: sim
O nome do repositório onde as alterações de origem devem ser detectadas.
- BranchName
-
Obrigatório: sim
O nome da ramificação onde as alterações de origem devem ser detectadas.
- PollForSourceChanges
-
Obrigatório: não
PollForSourceChangescontrola se CodePipeline pesquisa o CodeCommit repositório em busca de alterações na fonte. Em vez disso, recomendamos que você use CloudWatch Eventos para detectar alterações na fonte. Para obter mais informações sobre a configuração de CloudWatch eventos, consulte Migrar pipelines de pesquisa (CodeCommit fonte) (CLI) ouMigrar canais de votação (CodeCommit fonte) (modelo)AWS CloudFormation.Importante
Se você pretende configurar uma regra de CloudWatch eventos, deve defini-la
PollForSourceChangesfalsepara evitar execuções duplicadas no pipeline.Os valores válidos para esse parâmetro:
-
true: se definido, CodePipeline pesquisa seu repositório em busca de alterações na fonte.nota
Se você omitir
PollForSourceChanges, o CodePipeline padrão é pesquisar seu repositório em busca de alterações na fonte. Esse comportamento será o mesmo quando oPollForSourceChangesestiver incluído e definido comotrue. -
false: se definido, CodePipeline não pesquisa seu repositório em busca de alterações na fonte. Use essa configuração se você pretende configurar uma regra de CloudWatch Eventos para detectar alterações na origem.
-
- OutputArtifactFormat
-
Obrigatório: não
Formato do artefato de saída. Os valores podem ser
CODEBUILD_CLONE_REFouCODE_ZIP. Se não especificado, o padrão seráCODE_ZIP.Importante
A opção
CODEBUILD_CLONE_REFsó pode ser usada por ações downstream do CodeBuild.Se você escolher essa opção, precisará adicionar a
codecommit:GitPullpermissão à sua função de CodeBuild serviço, conforme mostrado emAdicionar CodeBuild GitClone permissões para ações CodeCommit de origem. Você também precisa adicionar acodecommit:GetRepositorypermissão à sua função CodePipeline de serviço, conforme mostrado emAdicionar permissões à função de serviço do CodePipeline. Para assistir a um tutorial que mostre como usar a opção Clone completo, consulte Tutorial: use o clone completo com uma fonte de CodeCommit pipeline.
Input artifacts (Artefatos de entrada)
-
Número de artefatos:
0 -
Descrição: os artefatos de entrada não se aplicam a esse tipo de ação.
Artefatos de saída
-
Número de artefatos:
1 -
Descrição: O artefato de saída desta ação é um arquivo ZIP que contém o conteúdo do repositório e ramificação configurados na confirmação especificada como a revisão de origem para a execução do pipeline. Os artefatos gerados do repositório são os artefatos de saída para a ação. CodeCommit O ID de confirmação do código-fonte é exibido CodePipeline como a revisão da fonte para a execução do pipeline acionado.
Variáveis de saída
Quando configurada, essa ação produz variáveis que podem ser referenciadas pela configuração de ação de uma ação downstream no pipeline. Esta ação produz variáveis que podem ser visualizadas como variáveis de saída, mesmo que a ação não tenha um namespace. Configure uma ação com um namespace a fim de disponibilizar as variáveis para a configuração de ações downstream.
Para obter mais informações, consulte Referência de variáveis.
- CommitId
-
O ID do CodeCommit commit que acionou a execução do pipeline. IDs Os commits são o SHA completo do commit.
- CommitMessage
-
A mensagem da descrição, se houver, associada à confirmação que acionou a execução do pipeline.
- RepositoryName
-
O nome do CodeCommit repositório em que o commit que acionou o pipeline foi feito.
- BranchName
-
O nome da ramificação do CodeCommit repositório em que a alteração na fonte foi feita.
- AuthorDate
-
A data em que a confirmação foi criada, no formato de timestamp.
- CommitterDate
-
A data em que a confirmação foi confirmada, no formato de timestamp.
Exemplo de configuração da ação
Exemplo de formato de artefato de saída padrão
name: Source
actionTypeId:
category: Source
owner: AWS
provider: CodeCommit
version: '1'
runOrder: 1
configuration:
BranchName: main
PollForSourceChanges: 'false'
RepositoryName: MyWebsite
outputArtifacts:
- name: Artifact_MyWebsiteStack
inputArtifacts: []
region: us-west-2
namespace: SourceVariables
Exemplo de formato de artefato de saída de clonagem completa
name: Source
actionTypeId:
category: Source
owner: AWS
provider: CodeCommit
version: '1'
runOrder: 1
configuration:
BranchName: main
OutputArtifactFormat: CODEBUILD_CLONE_REF
PollForSourceChanges: 'false'
RepositoryName: MyWebsite
outputArtifacts:
- name: SourceArtifact
inputArtifacts: []
region: us-west-2
namespace: SourceVariablesConsulte também
Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.
-
Tutorial: Criar um pipeline simples (repositório do CodeCommit)— Este tutorial fornece um exemplo de arquivo de especificação do aplicativo e um exemplo de grupo de implantação e CodeDeploy aplicativo. Use este tutorial para criar um pipeline com uma CodeCommit fonte que é implantada em EC2 instâncias da Amazon.
