Iniciar um pipeline com uma substituição da revisão de origem - AWS CodePipeline
Iniciar um pipeline com uma substituição de revisão de origem (console)Iniciar um pipeline com uma substituição da revisão de origem (CLI)

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á.

Iniciar um pipeline com uma substituição da revisão de origem

É possível usar substituições para iniciar um pipeline com um ID de revisão de origem específico fornecido para a execução do pipeline. Por exemplo, se você quiser iniciar um pipeline que processará um ID de confirmação específico da origem do CodeCommit, poderá adicionar o ID de confirmação como uma substituição ao iniciar o pipeline.

Há quatro tipos de revisão de origem para revisionType:

  • COMMIT_ID

  • IMAGE_DIGEST

  • S3_OBJECT_VERSION_ID

  • S3_OBJECT_KEY

nota

Para os tipos de revisões de origem COMMIT_ID e IMAGE_DIGEST, o ID de revisão de origem se aplica a todo o conteúdo no repositório, em todas as ramificações.

nota

Para os tipos S3_OBJECT_VERSION_ID e S3_OBJECT_KEY de revisões de origem, qualquer um dos tipos podem ser usados independentemente ou podem ser usados ​​juntos para substituir a origem com um ObjectKey e VersionID específicos. Para S3_OBJECT_KEY, o parâmetro de configuração AllowOverrideForS3ObjectKey precisa ser definido como true. Para ter mais informações sobre os parâmetros de configuração de origem do S3, consulte Parâmetros de configuração .

Iniciar um pipeline com uma substituição de revisão de origem (console)

Para iniciar manualmente um pipeline e executar a revisão mais recente por meio de um pipeline

  1. Faça login no AWS Management Console e abra o console do CodePipeline em http://console.aws.amazon.com/codesuite/codepipeline/home.

  2. Em Name, escolha o nome do pipeline que você deseja iniciar.

  3. Na página de detalhes do pipeline, escolha Lançar alteração. Selecionar Lançar alteração abre a janela Lançar alteração. Em Substituição da revisão de origem, selecione a seta para expandir o campo. Em Origem, insira o ID da revisão de origem. Por exemplo, se o pipeline tiver uma origem do CodeCommit, selecione o ID de confirmação no campo a ser utilizado.

    Um exemplo da tela de substituições no CodePipeline.

Iniciar um pipeline com uma substituição da revisão de origem (CLI)

Como iniciar manualmente um pipeline e executar o ID de revisão de origem especificado para um artefato por meio de um pipeline

  1. Abra um terminal (Linux, macOS ou Unix) ou prompt de comando (Windows) e use a AWS CLI para executar o comando start-pipeline-execution, especificando o nome do pipeline que você deseja iniciar. Também é necessário o argumento --source-revisions para fornecer o ID da revisão de origem. A revisão de origem é composta por actionName, revisionType e revisionValue. Os valores válidos de revisionType são COMMIT_ID | IMAGE_DIGEST | S3_OBJECT_VERSION_ID | S3_OBJECT_KEY.

    No exemplo a seguir, para começar a executar a alteração especificada por meio de um pipeline chamado codecommit-pipeline, o comando a seguir especifica um nome de ação de origem, um tipo de revisão de COMMIT_ID e um ID de confirmação de 78a25c18755ccac3f2a9eec099dEXAMPLE.

    aws codepipeline start-pipeline-execution --name codecommit-pipeline --source-revisions actionName=Source,revisionType=COMMIT_ID,revisionValue=78a25c18755ccac3f2a9eec099dEXAMPLE --region us-west-1

  2. Para confirmar se tudo deu certo, visualize o objeto retornado. Este comando retorna um ID de execução semelhante a:

    {
    "pipelineExecutionId": "c53dbd42-This-Is-An-Example"
}
    nota

    Depois que você iniciar o pipeline, poderá monitorar seu progresso no console do CodePipeline ou executando o comando get-pipeline-state. Para ter mais informações, consulte Visualizar pipelines (console) e Visualizar detalhes e histórico do pipeline (CLI).