View a markdown version of this page

AWS CodePipeline invocar referência de ação - AWS CodePipeline
Tipo de açãoParâmetros de configuraçãoInput artifacts (Artefatos de entrada)Artefatos de saídaPermissões da política de função de serviço para a CodePipeline ação de invocaçãoDeclaração de açãoConsulte também

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

AWS CodePipeline invocar referência de ação

Você usa uma ação de CodePipeline invocação para simplificar o acionamento de execuções de pipeline downstream e a transmissão de variáveis de pipeline e revisões de origem entre pipelines.

nota

Essa ação é compatível somente para pipelines tipo V2.

Tipo de ação

  • Categoria: Invoke

  • Proprietário: AWS

  • Fornecedor: CodePipeline

  • Versão: 1

Parâmetros de configuração

PipelineName

Obrigatório: Sim

O nome do pipeline que, ao ser executado, iniciará o pipeline de destino atual. Você já deve ter criado o pipeline de invocação. A ação iniciará o pipeline s3-pipeline-test (de destino) quando o pipeline (invocação) chamado my-s3-pipeline iniciar uma execução.

SourceRevisions

Obrigatório: não

As revisões de origem que você deseja que o pipeline de destino use quando for iniciado pelo pipeline de invocação. Por exemplo, uma ação de origem do S3 fornece variáveis de saída, como ID da versão e chave do objeto do S3. Você pode especificar um valor de revisão a ser usado quando o pipeline for invocado.

Para a CLI, você especifica as revisões de origem como uma string JSON serializada. Para obter mais informações sobre como usar substituições de revisão de origem, consulte o SourceRevisionOverride Guia da CodePipeline API.

O mapeamento usa um formato de string conforme mostrado no seguinte exemplo:

[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]
Variáveis

Obrigatório: não

Os nomes e os valores de variáveis com os quais você deseja que a ação seja compatível.

Para a CLI, você especifica variáveis como uma string JSON serializada. Para obter mais informações sobre o uso de variáveis de pipeline, consulte PipelineVariable o Guia de CodePipeline API.

O mapeamento usa um formato de string conforme mostrado no seguinte exemplo:

[{"name":"VAR1","value":"VALUE1"}]

A imagem a seguir mostra um exemplo da ação adicionada a um pipeline no console.

Um pipeline com uma origem S3 e um estágio de compilação que inclui a ação invocar do pipeline

A imagem a seguir mostra um exemplo da página Editar da ação. No exemplo a seguir, o pipeline chamado s3-pipeline-test tem uma ação invocar de pipeline configurada conforme mostrado no console. A ação iniciará o pipeline s3-pipeline-test quando o pipeline chamado my-s3-pipeline concluir uma execução. O exemplo mostra que a substituição da revisão da origem pela substituição da origem S3_OBJECT_VERSION_ID pelo valor de revisão especificado de zq8mjNYEexample.

A página Editar ação de um novo pipeline com a ação invocar do 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: 0

  • Descrição: os artefatos de saída não se aplicam a esse tipo de ação.

Permissões da política de função de serviço para a CodePipeline ação de invocação

Quando CodePipeline executa a ação, a política da função de CodePipeline serviço exige a codepipeline:StartPipelineExecution permissão, com escopo adequado até o ARN do recurso do pipeline para manter o acesso com o mínimo de privilégios.

 {
            "Sid": "StatementForPipelineInvokeAction",
            "Effect": "Allow",
            "Action": "codepipeline:StartPipelineExecution",
            "Resource": [
                "arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}"
            ]
        }

Declaração de ação

YAML
name: Invoke-pipeline
actionTypeId:
  category: Invoke
  owner: AWS
  provider: CodePipeline
  version: '1'
runOrder: 2
configuration:
  PipelineName: my-s3-pipeline
  SourceRevisions: '[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]'
  Variables: '[{"name":"VAR1","value":"VALUE1"}]'
JSON
{
    "name": "Invoke-pipeline",
    "actionTypeId": {
        "category": "Invoke",
        "owner": "AWS",
        "provider": "CodePipeline",
        "version": "1"
    },
    "runOrder": 2,
    "configuration": {
        "PipelineName": "my-s3-pipeline",
        "SourceRevisions": "[{\"actionName\":\"Source\",\"revisionType\":\"S3_OBJECT_VERSION_ID\",\"revisionValue\":\"zq8mjNEXAMPLE\"}]",
        "Variables": "[{\"name\":\"VAR1\",\"value\":\"VALUE1\"}]"
    }
},

Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.