AWS CodePipelineReferência da ação de invocação do
Você usa uma ação invocar do CodePipeline para simplificar o acionamento de execuções de pipeline posteriores e a passagem de variáveis de pipeline e revisões de origem entre pipelines.
nota
Essa ação só é compatível para pipelines tipo V2.
Tópicos
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) chamadomy-s3-pipelineiniciar 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 da revisão de origem, consulte SourceRevisionOverride no Guia da API do CodePipeline.
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 como usar variáveis de pipeline, consulte PipelineVariable no Guia da API CodePipeline.
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.
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.
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 de política do perfil de serviço para a ação invocar do CodePipeline
Quando o CodePipeline executa a ação, o perfil de serviço do CodePipeline exige a permissão codepipeline:StartPipelineExecution, com escopo indicado para o ARN de recurso do pipeline a fim de manter acesso com privilégio mínimo.
{ "Sid": "StatementForPipelineInvokeAction", "Effect": "Allow", "Action": "codepipeline:StartPipelineExecution", "Resource": [ "arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}" ] }
Declaração de ação
Consulte também
Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.
-
Iniciar um pipeline com uma substituição da revisão de origem: esta seção descreve como iniciar manualmente um pipeline com revisões de origem ou por meio do transformador de entrada do evento EventBridge.
