A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).
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á.
# Ação YAML “Renderizar definição de tarefa do Amazon ECS”
Veja a seguir a definição YAML da ação **Renderizar definição de tarefa do Amazon ECS**. Para saber como usar essa ação, consulte [Modificação de uma definição de tarefa do Amazon ECS](render-ecs-action.md).
Essa definição de ação existe como uma seção dentro de um arquivo de definição de fluxo de trabalho mais amplo. Para obter mais informações sobre esse arquivo, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md).
**nota**
A maioria das propriedades YAML a seguir tem elementos de interface de usuário correspondentes no editor visual. Para pesquisar um elemento de interface, use **Ctrl\$1F**. O elemento será listado com a propriedade YAML associada.
```
# The workflow definition starts here.
# See Propriedades de nível superior for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
ECSRenderTaskDefinition\$1nn:
Identifier: aws/ecs-render-task-definition@v1
DependsOn:
- build-action
Compute:
Type: EC2 | Lambda
Fleet: fleet-name
Timeout: timeout-minutes
Inputs:
# Specify a source or an artifact, but not both.
Sources:
- source-name-1
Artifacts:
- task-definition-artifact
Variables:
- Name: variable-name-1
Value: variable-value-1
- Name: variable-name-2
Value: variable-value-2
Configuration
task-definition: task-definition-path
container-definition-name: container-definition-name
image: docker-image-name
environment-variables:
- variable-name-1=variable-value-1
- variable-name-2=variable-value-2
Outputs:
Artifacts:
- Name: TaskDefArtifact
Files: "task-definition*"
Variables:
- task-definition
```
## ECSRenderTaskDefinition
(Obrigatório)
Especifique o nome da ação. Todos os nomes de ação devem ser exclusivos no fluxo de trabalho. Os nomes de ação são limitados a caracteres alfanuméricos (a-z, A-Z, 0-9), hifens (-) e sublinhados (\$1). Não são permitidos espaços. Não é possível usar aspas para habilitar caracteres especiais e espaços nos nomes de ação.
Padrão: `ECSRenderTaskDefinition_nn`.
Interface de usuário correspondente: guia Configuração/**Nome da ação**
## Identifier
(*ECSRenderTaskDefinition*/**Identifier**)
(Obrigatório)
Identifica a ação. Não altere essa propriedade, a menos que você queira alterar a versão. Para obter mais informações, consulte [Especificação da versão da ação a ser usada](workflows-action-versions.md).
Padrão: `aws/ecs-render-task-definition@v1`.
**UI correspondente: diagrama de fluxo de trabalho/ ECSRenderTaskDefinition \$1nn/ aws/ @v1 label ecs-render-task-definition**
## DependsOn
(*ECSRenderTaskDefinition*/**DependsOn**)
(Optional)
Especifique uma ação, um grupo de ação ou um portão que deve ser executado com êxito para que essa ação seja executada.
Para ter mais informações sobre a funcionalidade “Depende de”, consulte [Sequenciar ações](workflows-depends-on.md).
Interface de usuário correspondente: guia Entradas/**Depende de - opcional**
## Compute
(*ECSRenderTaskDefinition*/**Compute**)
(Optional)
O mecanismo de computação usado para executar as ações de fluxo de trabalho. É possível especificar a computação em nível de fluxo de trabalho ou em nível de ação, mas não em ambos. Quando especificada em nível de fluxo de trabalho, a configuração de computação se aplica a todas as ações definidas no fluxo de trabalho. Em nível de fluxo de trabalho, também é possível realizar várias ações na mesma instância. Para obter mais informações, consulte [Compartilhamento de computação entre ações](compute-sharing.md).
Interface de usuário correspondente: *nenhuma*
## Type
(*ECSRenderTaskDefinition*/Compute/**Type**)
(Obrigatório se [Compute](#render.ecs.computename) for incluído)
O tipo do mecanismo de computação. É possível usar um dos seguintes valores:
+ **EC2**(editor visual) ou `EC2` (editor YAML)
Otimizado para flexibilidade durante as execuções de ação.
+ **Lambda** (editor visual) ou `Lambda` (editor YAML)
Velocidades otimizadas de inicialização da ação.
Para obter informações sobre tipos de dados, consulte [Tipos de computação](workflows-working-compute.md#compute.types).
Interface de usuário correspondente: guia Configuração/**Tipo de computação**
## Fleet
(*ECSRenderTaskDefinition*/Compute/**Fleet**)
(Optional)
Especifique a máquina ou a frota que executará o fluxo de trabalho ou as ações de fluxo de trabalho. Com frotas sob demanda, quando uma ação é iniciada, o fluxo de trabalho provisiona os recursos necessários e as máquinas são destruídas quando a ação termina. Exemplos de frota sob demanda: `Linux.x86-64.Large`, `Linux.x86-64.XLarge`. Para ter mais informações sobre frotas sob demanda, consulte [Propriedades da frota sob demanda](workflows-working-compute.md#compute.on-demand).
Com frotas provisionadas, você configura um conjunto de máquinas dedicadas para realizar as ações do fluxo de trabalho. Essas máquinas permanecem ociosas, prontas para processar ações imediatamente. Para ter mais informações sobre frotas provisionadas, consulte [Propriedades da frota provisionada](workflows-working-compute.md#compute.provisioned-fleets).
Se `Fleet` for omitido, o padrão será `Linux.x86-64.Large`.
Interface de usuário correspondente: guia Configuração/**Frota de computação**
## Timeout
(*ECSRenderTaskDefinition*/**Timeout**)
(Optional)
Especifique a quantidade de tempo em minutos (editor YAML) ou horas e minutos (editor visual) que a ação pode ser executada antes de CodeCatalyst finalizar a ação. O mínimo é de cinco minutos e o máximo está descrito em [Cotas para fluxos de trabalho em CodeCatalyst](workflows-quotas.md). O tempo limite padrão é igual ao tempo limite máximo.
Interface de usuário correspondente: guia Configuração/**Tempo limite - opcional**
## Inputs
(*ECSRenderTaskDefinition*/**Inputs**)
(Optional)
A seção `Inputs` define os dados que `ECSRenderTaskDefinition` precisa durante a execução de um fluxo de trabalho.
**nota**
Somente uma entrada (uma origem ou um artefato) é permitida por ação **Renderizar definição de tarefa do Amazon ECS**. As variáveis não são contadas nesse total.
Interface de usuário correspondente: guia **Entradas**
## Sources
(*ECSRenderTaskDefinition*/Inputs/**Sources**)
(Obrigatório se o arquivo de definição de tarefas estiver armazenado em um repositório de origem)
Se seu arquivo de definição de tarefa estiver armazenado em um repositório de origem, especifique o rótulo do repositório de origem. Atualmente, o único rótulo compatível é `WorkflowSource`.
Se seu arquivo de definição de tarefa não estiver em um repositório de origem, ele deverá residir em um artefato gerado por outra ação.
Para obter mais informações sobre fontes, consulte [Conectar repositórios de origem aos fluxos de trabalho](workflows-sources.md).
Interface de usuário correspondente: guia Entradas/**Origens - opcional**
## Artifacts - input
(*ECSRenderTaskDefinition*/Inputs/**Artifacts**)
(Obrigatório se o arquivo de definição de tarefa estiver armazenado em um [artefato de saída](workflows-working-artifacts-output.md) de uma ação anterior)
Se o arquivo de definição de tarefa que você deseja implantar estiver em um artefato gerado por uma ação anterior, especifique esse artefato aqui. Se seu arquivo de definição de tarefa não estiver em um artefato, ele deverá residir em seu repositório de origem.
Para ter mais informações sobre artefatos, inclusive exemplos, consulte [Compartilhar artefatos e arquivos entre ações](workflows-working-artifacts.md).
Interface de usuário correspondente: guia Configuração/**Artefatos - opcional**
## Variables - input
(*ECSRenderTaskDefinition*/Inputs/**Variables**)
(Obrigatório)
Especifique uma sequência de name/value pares que defina as variáveis de entrada que você deseja disponibilizar para a ação. Os nomes de variável são limitados a caracteres alfanuméricos (a-z, A-Z, 0-9), hifens (-) e sublinhados (\$1). Não são permitidos espaços. Não é possível usar aspas para habilitar caracteres especiais e espaços nos nomes de variável.
Para ter mais informações sobre variáveis, inclusive exemplos, consulte [Uso de variáveis em fluxos de trabalho](workflows-working-with-variables.md).
Interface de usuário correspondente: guia Entradas/**Variáveis - opcional**
## Configuration
(*ECSRenderTaskDefinition*/**Configuration**)
(Obrigatório)
Uma seção na qual você pode definir as propriedades de configuração da ação.
Interface de usuário correspondente: guia **Configuração**
## task-definition
(*ECSRenderTaskDefinition*/Configuration/**task-definition**)
(Obrigatório)
Especifique o caminho para um arquivo de definição de tarefa existente. Se o arquivo residir em seu repositório de origem, o caminho é relativo à pasta raiz do repositório de origem. Se o arquivo residir em um artefato de uma ação anterior do fluxo de trabalho, o caminho é relativo à pasta raiz do artefato. Para ter mais informações sobre os arquivos de definição de tarefa, consulte [Definições de tarefa](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions) no *Guia do desenvolvedor do Amazon Elastic Container Service*.
Interface de usuário correspondente: guia Configuração/**Definição de tarefa**
## container-definition-name
(*ECSRenderTaskDefinition*/Configuration/**container-definition-name**)
(Obrigatório)
Especifique o nome do contêiner em que sua imagem do Docker será executada. Você pode encontrar esse nome em `containerDefinitions`, campo `name` em seu arquivo de definição de tarefa. Para ter mais informações, consulte [Nome](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_name) no *Guia do desenvolvedor do Amazon Elastic Container Service*.
Interface de usuário correspondente: guia Configuração/**Nome do contêiner**
## image
(*ECSRenderTaskDefinition*/Configuration/**image**)
(Obrigatório)
Especifique o nome da imagem do Docker que você deseja que a ação **Renderizar definição de tarefa do Amazon ECS** adicione ao seu arquivo de definição de tarefas. A ação adiciona esse nome a `containerDefinitions`, campo `image` em seu arquivo de definição de tarefa. Se um valor já existir no campo `image`, a ação o substituirá. Você pode incluir variáveis no nome da imagem.
Exemplos:
Se você especificar`MyDockerImage:${WorkflowSource.CommitId}`, a ação será adicionada `MyDockerImage:commit-id` ao arquivo de definição da tarefa, onde *commit-id* está uma ID de confirmação gerada em tempo de execução pelo fluxo de trabalho.
Se você especificar`my-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s)`, a ação adicionará *my-ecr-repo* /image-repo: *date \$1%m-%d-%y-%H-%m-%s* ao arquivo de definição da tarefa, onde *my-ecr-repo* é o URI de um Amazon Elastic Container Registry (ECR) e *date \$1%m-%d-%y-%H-%m-%s* é um timestamp no formato `month-day-year-hour-minute-second` gerado em tempo de execução pelo fluxo de trabalho.
Para ter mais informações sobre o campo `image`, consulte [Imagem](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_image) no *Guia do desenvolvedor do Amazon Elastic Container Service*. Para ter mais informações sobre variáveis, consulte [Uso de variáveis em fluxos de trabalho](workflows-working-with-variables.md).
Interface de usuário correspondente: guia Configuração/**Nome da imagem**
## environment-variables
(*ECSRenderTaskDefinition*/Configuration/**environment-variables**)
(Obrigatório)
Especifique as variáveis de ambiente que você deseja que a ação **Renderizar definição de tarefa do Amazon ECS** adicione ao seu arquivo de definição de tarefa. A ação adiciona as variáveis a `containerDefinitions`, campo `environment` em seu arquivo de definição de tarefa. Se as variáveis já existirem no arquivo, a ação substituirá os valores das variáveis existentes e adicionará quaisquer novas variáveis. Para ter mais informações sobre as variáveis de ambiente do Amazon ECS, consulte [Especificar variáveis de ambiente](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) no *Guia do desenvolvedor do Amazon Elastic Container Service*.
Interface de usuário correspondente: guia Configuração/**Variáveis de ambiente – opcional**
## Outputs
(*ECSRenderTaskDefinition*/**Outputs**)
(Obrigatório)
Define os dados que são gerados pela ação durante a execução de um fluxo de trabalho.
Interface de usuário correspondente: guia **Saídas**
## Artifacts
(*ECSRenderTaskDefinition*/Outputs/**Artifacts**)
(Obrigatório)
Especifique os artefatos gerados pela ação. Você pode referenciar esses artefatos como entrada em outras ações.
Para ter mais informações sobre artefatos, inclusive exemplos, consulte [Compartilhar artefatos e arquivos entre ações](workflows-working-artifacts.md).
Interface de usuário correspondente: guia Saídas/**Artefatos**
## Name
(*ECSRenderTaskDefinition*/Outputs/Artifacts/**Name**)
(Obrigatório)
Especifique o nome do artefato que conterá o arquivo de definição de tarefa atualizado. O valor padrão é `MyTaskDefinitionArtifact`. Em seguida, você deve especificar esse artefato como entrada na ação **Implantar no Amazon ECS**. Para entender como adicionar esse artefato como entrada para a ação **Implantar no Amazon ECS**, consulte [Exemplo: modificar uma definição de tarefa do Amazon ECS](render-ecs-action-example-workflow.md).
Interface de usuário correspondente: guia Saídas/Artefatos/**Nome**
## Files
(*ECSRenderTaskDefinition*/Outputs/Artifacts/**Files**)
(Obrigatório)
Especifique os arquivos a serem incluídos no artefato. Você deve especificar `task-definition-*` para que o arquivo de definição de tarefa atualizado, que começa com `task-definition-`, seja incluído.
Interface de usuário correspondente: guia Saídas/Artefatos/**Arquivos**
## Variables
(*ECSRenderTaskDefinition*/Outputs/**Variables**)
(Obrigatório)
Especifique o nome de uma variável a ser definida pela ação de renderização. A ação de renderização definirá o valor dessa variável como o nome do arquivo de definição de tarefa atualizado (por exemplo, `task-definition-random-string.json`). Em seguida, você deve especificar essa variável na propriedade **Definição de tarefa** (editor visual) ou `task-definition` (editor yaml) da ação **Implantar no Amazon ECS**. Para entender como adicionar essa variável na ação **Implantar no Amazon ECS**, consulte [Exemplo: modificar uma definição de tarefa do Amazon ECS](render-ecs-action-example-workflow.md).
Padrão: `task-definition`
Interface de usuário correspondente: guia Saídas/Variáveis/**Nome**