Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Acción Render Amazon ECS task definition en YAML
A continuación figura la definición en YAML de la acción **Render Amazon ECS task definition**. Para obtener información sobre cómo utilizar esta acción, consulte [Modificación de una definición de tarea de Amazon ECS](render-ecs-action.md).
Esta definición de acción existe como una sección dentro de un archivo de definición de flujo de trabajo más amplio. Para obtener más información acerca de este archivo, consulte [Definición de flujo de trabajo en YAML](workflow-reference.md).
**nota**
La mayoría de las propiedades de YAML que se muestran a continuación tienen elementos de interfaz de usuario correspondientes en el editor visual. Para buscar un elemento de la interfaz de usuario, use **Ctrl\$1F**. El elemento aparecerá en la lista con su propiedad de YAML asociada.
```
# The workflow definition starts here.
# See Propiedades de nivel 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
(Obligatorio)
Especifique el nombre de la acción. Todos los nombres de las acciones deben ser únicos dentro del flujo de trabajo. Los nombres de las acciones están limitados a caracteres alfanuméricos (a-z, A-Z y 0-9), guiones (-) y guiones bajos (\$1). No se permiten espacios. No puede utilizar comillas para permitir caracteres especiales ni espacios en los nombres de las acciones.
Predeterminado: `ECSRenderTaskDefinition_nn`.
Interfaz de usuario correspondiente: pestaña Configuración/**Nombre de la acción**
## Identifier
(*ECSRenderTaskDefinition*/**Identifier**)
(Obligatorio)
Identifica la acción. No cambie esta propiedad a menos que desee cambiar la versión. Para obtener más información, consulte [Especificación de la versión de la acción que se va a utilizar](workflows-action-versions.md).
Predeterminado: `aws/ecs-render-task-definition@v1`.
**Interfaz de usuario correspondiente: diagrama ECSRenderTaskDefinition de flujo de trabajo/ \$1nn/ aws/ @v1 label ecs-render-task-definition**
## DependsOn
(*ECSRenderTaskDefinition*/**DependsOn**)
(Opcional)
Especifique la acción, el grupo de acciones o la puerta que debe ejecutarse correctamente para que esta acción se ejecute.
Para obtener más información sobre la funcionalidad “depende de”, consulte [Secuenciación de acciones](workflows-depends-on.md).
Interfaz de usuario correspondiente: pestaña Entradas/**Depende de (opcional)**
## Compute
(*ECSRenderTaskDefinition*/**Compute**)
(Opcional)
El motor de computación utilizado para ejecutar las acciones del flujo de trabajo. Puede especificar el motor de computación en el nivel del flujo de trabajo o en el nivel de acción, pero no en ambos. Cuando se especifica en el nivel de flujo de trabajo, la configuración del motor de computación se aplica a todas las acciones definidas en el flujo de trabajo. En el nivel de flujo de trabajo, también puede ejecutar varias acciones en la misma instancia. Para obtener más información, consulte [Uso compartido de recursos de computación entre acciones](compute-sharing.md).
Interfaz de usuario correspondiente: *ninguna*
## Type
(*ECSRenderTaskDefinition*/Compute/**Type**)
(Obligatorio si se incluye [Compute](#render.ecs.computename))
El tipo de motor de computación. Puede utilizar uno de los siguientes valores:
+ **EC2**(editor visual) o (editor YAML) `EC2`
Optimizado para ofrecer flexibilidad durante las ejecuciones de acciones.
+ **Lambda** (editor visual) o `Lambda` (editor de YAML)
Velocidades de inicio de acciones optimizadas.
Para obtener más información sobre los tipos de computación, consulte [Tipos de computación](workflows-working-compute.md#compute.types).
Interfaz de usuario correspondiente: pestaña Configuración/**Tipo de computación**
## Fleet
(*ECSRenderTaskDefinition*/Compute/**Fleet**)
(Opcional)
Especifique la máquina o la flota que ejecutará el flujo de trabajo o las acciones del flujo de trabajo. Con las flotas bajo demanda, cuando se inicia una acción, el flujo de trabajo aprovisiona los recursos que necesita y las máquinas se destruyen cuando finaliza la acción. Ejemplos de flotas bajo demanda: `Linux.x86-64.Large`, `Linux.x86-64.XLarge`. Para obtener más información sobre las flotas bajo demanda, consulte [Propiedades de las flotas bajo demanda](workflows-working-compute.md#compute.on-demand).
Con las flotas aprovisionadas, configura un conjunto de máquinas dedicadas para ejecutar las acciones del flujo de trabajo. Estas máquinas permanecen inactivas, listas para procesar acciones de forma inmediata. Para obtener más información sobre las flotas aprovisionadas, consulte [Propiedades de flotas aprovisionadas](workflows-working-compute.md#compute.provisioned-fleets).
Si `Fleet` se omite, el valor predeterminado es `Linux.x86-64.Large`.
Interfaz de usuario correspondiente: pestaña Configuración/**Flota de computación**
## Timeout
(*ECSRenderTaskDefinition*/**Timeout**)
(Opcional)
Especifique la cantidad de tiempo en minutos (editor YAML) o en horas y minutos (editor visual) que la acción puede ejecutarse antes de que CodeCatalyst finalice la acción. El mínimo es 5 minutos y el máximo se describe en [Cuotas para flujos de trabajo en CodeCatalyst](workflows-quotas.md). El tiempo de espera predeterminado es el mismo que el tiempo de espera máximo.
Interfaz de usuario correspondiente: pestaña Configuración/**Tiempo de espera (opcional)**
## Inputs
(*ECSRenderTaskDefinition*/**Inputs**)
(Opcional)
La sección `Inputs` define los datos que necesita la acción `ECSRenderTaskDefinition` durante la ejecución de un flujo de trabajo.
**nota**
Solo se permite una entrada (ya sea un código fuente o un artefacto) para cada acción **Render Amazon ECS task definition**. Las variables no se contabilizan en este total.
Interfaz de usuario correspondiente: pestaña **Entradas**
## Sources
(*ECSRenderTaskDefinition*/Inputs/**Sources**)
(Obligatorio si el archivo de definición de la tarea está almacenado en un repositorio de código fuente)
Si el archivo de definición de la tarea está almacenado en un repositorio de código fuente, especifique la etiqueta de dicho repositorio. Actualmente, la única etiqueta admitida es `WorkflowSource`.
Si el archivo de definición de la tarea no está incluido en un repositorio de código fuente, debe residir en un artefacto generado por otra acción.
Para obtener más información sobre orígenes, consulte [Conexión de repositorios de código fuente a flujos de trabajo](workflows-sources.md).
Interfaz de usuario correspondiente: pestaña Entradas/**Orígenes (opcional)**
## Artifacts - input
(*ECSRenderTaskDefinition*/Inputs/**Artifacts**)
(Obligatorio si el archivo de definición de la tarea está almacenado en un [artefacto de salida](workflows-working-artifacts-output.md) de una acción anterior)
Si el archivo de definición de la tarea que desea implementar está incluido en un artefacto generado por una acción anterior, especifique ese artefacto aquí. Si el archivo de definición de la tarea no está incluido en un artefacto, debe residir en el repositorio de código fuente.
Para obtener más información sobre los artefactos, incluidos ejemplos, consulte [Cómo compartir artefactos y archivos entre acciones](workflows-working-artifacts.md).
Interfaz de usuario correspondiente: pestaña Configuración/**Artefactos (opcional)**
## Variables - input
(*ECSRenderTaskDefinition*/Inputs/**Variables**)
(Obligatorio)
Especifique una secuencia de name/value pares que defina las variables de entrada que desea que estén disponibles para la acción. Los nombres de variables están limitados a caracteres alfanuméricos (a-z, A-Z y 0-9), guiones (-) y guiones bajos (\$1). No se permiten espacios. No puede utilizar comillas para permitir caracteres especiales ni espacios en los nombres de variables.
Para obtener más información sobre las variables, incluidos ejemplos, consulte [Uso de variables en flujos de trabajo](workflows-working-with-variables.md).
Interfaz de usuario correspondiente: pestaña Entradas/**Variables (opcional)**
## Configuration
(*ECSRenderTaskDefinition*/**Configuration**)
(Obligatorio)
Una sección en la que puede definir las propiedades de configuración de la acción.
Interfaz de usuario correspondiente: pestaña **Configuración**
## task-definition
(*ECSRenderTaskDefinition*/Configuration/**task-definition**)
(Obligatorio)
Especifique la ruta a un archivo de definición de la tarea existente. Si el archivo reside en el repositorio de código fuente, la ruta es relativa a la carpeta raíz del repositorio de código fuente. Si el archivo reside en un artefacto de una acción del flujo de trabajo anterior, la ruta es relativa a la carpeta raíz del artefacto. Para obtener más información sobre los archivos de definición de tareas, consulte [Task definitions](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions) en la *Guía para desarrolladores de Amazon Elastic Container Service*.
Interfaz de usuario correspondiente: pestaña Configuración/**Definición de tarea**
## container-definition-name
(*ECSRenderTaskDefinition*/Configuration/**container-definition-name**)
(Obligatorio)
Especifique el nombre del contenedor en el que se ejecutará la imagen de Docker. Puede encontrar este nombre en las `containerDefinitions`, en el campo `name` del archivo de definición de tareas. Para obtener más información, consulte [Nombre](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_name) en la *Guía para desarrolladores de Amazon Elastic Container Service*.
Interfaz de usuario correspondiente: pestaña Configuración/**Nombre de contenedor**
## image
(*ECSRenderTaskDefinition*/Configuration/**image**)
(Obligatorio)
Especifique el nombre de la imagen de Docker que quiera que se agregue al archivo de definición de tareas con la acción **Render Amazon ECS task definition**. La acción añade este nombre a las `containerDefinitions`, al campo `image`, en el archivo de definición de tareas. Si ya existe un valor en el campo `image`, la acción lo sobrescribe. Puede incluir variables en el nombre de la imagen.
Ejemplos:
Si lo especificas`MyDockerImage:${WorkflowSource.CommitId}`, la acción se agrega `MyDockerImage:commit-id` al archivo de definición de tareas, donde *commit-id* se encuentra un ID de confirmación generado en tiempo de ejecución por el flujo de trabajo.
Si lo especificas`my-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s)`, la acción añade *my-ecr-repo* /image-repo: *date \$1%m-%d-%y-%H-%m-%s* al archivo de definición de tareas, donde *my-ecr-repo* es el URI de un Amazon Elastic Container Registry (ECR) y *date \$1%m-%d-%y-%H-%m-%s* es una marca de tiempo en el formato `month-day-year-hour-minute-second` generado en tiempo de ejecución por el flujo de trabajo.
Para obtener más información sobre el campo `image`, consulte [Imagen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_image) en la *Guía para desarrolladores de Amazon Elastic Container Service*. Para obtener más información acerca de las variables, consulte [Uso de variables en flujos de trabajo](workflows-working-with-variables.md).
Interfaz de usuario correspondiente: pestaña Configuración/**Nombre de imagen**
## environment-variables
(*ECSRenderTaskDefinition*/Configuration/**environment-variables**)
(Obligatorio)
Especifique las variables de entorno que quiera que se agreguen al archivo de definición de tareas con la acción **Render Amazon ECS task definition**. La acción añade las variables a las `containerDefinitions`, al campo `environment`, en el archivo de definición de tareas. Si las variables ya existen en el archivo, la acción sobrescribe los valores de las variables existentes y añade las variables nuevas. Para obtener más información sobre las variables de entorno de Amazon ECS, consulte [Especificación de variables de entorno](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) en la *Guía para desarrolladores de Amazon Elastic Container Service*.
Interfaz de usuario correspondiente: pestaña Configuración/**Variables de entorno - opcional**
## Outputs
(*ECSRenderTaskDefinition*/**Outputs**)
(Obligatorio)
Define los datos que necesita una acción durante la ejecución de un flujo de trabajo.
Interfaz de usuario correspondiente: pestaña **Salidas**
## Artifacts
(*ECSRenderTaskDefinition*/Outputs/**Artifacts**)
(Obligatorio)
Especifique el nombre de los artefactos generados por la acción. Puede hacer referencia a estos artefactos como entrada en otras acciones.
Para obtener más información sobre los artefactos, incluidos ejemplos, consulte [Cómo compartir artefactos y archivos entre acciones](workflows-working-artifacts.md).
Interfaz de usuario correspondiente: pestaña Salidas/**Artefactos**
## Name
(*ECSRenderTaskDefinition*/Outputs/Artifacts/**Name**)
(Obligatorio)
Especifique el nombre del artefacto que contendrá el archivo de definición de tareas actualizado. El valor predeterminado es `MyTaskDefinitionArtifact`. A continuación, debe especificar este artefacto como entrada en la acción **Deploy to Amazon ECS**. Para saber cómo añadir este artefacto como entrada a la acción **Deploy to Amazon ECS**, consulte [Ejemplo: Modificación de una taskdef de Amazon ECS](render-ecs-action-example-workflow.md).
Interfaz de usuario correspondiente: pestaña Salidas/Artefactos/**Nombre**
## Files
(*ECSRenderTaskDefinition*/Outputs/Artifacts/**Files**)
(Obligatorio)
Especifique los archivos que desee incluir en el artefacto. Debe especificar `task-definition-*` para que se incluya el archivo de definición de tareas actualizado, que comienza con `task-definition-`.
Interfaz de usuario correspondiente: pestaña Salidas/Artefactos/**Archivos**
## Variables
(*ECSRenderTaskDefinition*/Outputs/**Variables**)
(Obligatorio)
Especifique el nombre de una variable que se establecerá mediante la acción de renderizado. La acción de renderizado establecerá el valor de esta variable en el nombre del archivo de definición de tareas actualizado (por ejemplo, `task-definition-random-string.json`). A continuación, debe especificar esta variable en la propiedad **Definición de tareas** (editor visual) o `task-definition` (editor yaml) de la acción **Implementar en Amazon ECS**. Para saber cómo agregar esta variable a la acción **Deploy to Amazon ECS**, consulte [Ejemplo: Modificación de una taskdef de Amazon ECS](render-ecs-action-example-workflow.md).
Valor predeterminado: `task-definition`
Interfaz de usuario correspondiente: pestaña Salidas/Variables/campo **Nombre**