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

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