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 «Renderizar la definición de ECS tareas de Amazon» YAML
La siguiente es la YAML definición de la acción de definición de ECS tareas Render Amazon. Para obtener información sobre cómo utilizar esta acción, consulteModificación de una definición de ECS tarea de Amazon.
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 YAMLDefinición del flujo de trabajo.
nota
La mayoría de las YAML propiedades siguientes tienen los elementos de interfaz de usuario correspondientes en el editor visual. Para buscar un elemento de la interfaz de usuario, utilice Ctrl+F. El elemento aparecerá en la lista con su propiedad asociadaYAML.
# The workflow definition starts here.
# See Propiedades de nivel superior for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
ECSRenderTaskDefinition_nn
:
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 en el flujo de trabajo. Los nombres de las acciones se limitan a caracteres alfanuméricos (a-z, A-Z, 0-9), guiones (-) y guiones bajos (_). No se permiten espacios. No se pueden usar comillas para habilitar los caracteres especiales y los espacios en los nombres de las acciones.
Predeterminado: ECSRenderTaskDefinition_nn
.
Interfaz de usuario correspondiente: pestaña de 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 Especificar la versión de la acción que se va a utilizar.
Predeterminado: aws/ecs-render-task-definition@v1
.
Interfaz de usuario correspondiente: diagrama de flujo de trabajo/ ECSRenderTaskDefinition _nn/ aws/ @v1 label ecs-render-task-definition
DependsOn
(ECSRenderTaskDefinition
/DependsOn)
(Opcional)
Especifique una acción, un grupo de acciones o una 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
Interfaz de usuario correspondiente: pestaña de entradas/Depende de: opcional
Compute
(ECSRenderTaskDefinition
/Compute)
(Opcional)
El motor informático utilizado para ejecutar las acciones del flujo de trabajo. Puede especificar el procesamiento en el nivel del flujo de trabajo o en el nivel de acción, pero no en ambos. Cuando se especifica en el nivel del flujo de trabajo, la configuración de procesamiento se aplica a todas las acciones definidas en el flujo de trabajo. En el nivel del flujo de trabajo, también puedes ejecutar varias acciones en la misma instancia. Para obtener más información, consulte Compartir el cómputo entre acciones.
Interfaz de usuario correspondiente: ninguna
Type
(ECSRenderTaskDefinition
/Compute/Type)
(Obligatorio si Compute está incluido)
El tipo de motor de cómputo. Puede usar uno de los siguientes valores:
-
EC2(editor visual) o
EC2
(YAMLeditor)Optimizado para ofrecer flexibilidad durante las ejecuciones de acción.
-
Lambda (editor visual) o
Lambda
(YAMLeditor)Velocidades de inicio de acciones optimizadas.
Para obtener más información sobre los tipos de computación, consulte Tipos de procesamiento.
Interfaz de usuario correspondiente: pestaña de configuración/tipo de cálculo
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 la flota bajo demanda
Con las flotas aprovisionadas, puede configurar un conjunto de máquinas dedicadas para ejecutar las acciones de su flujo de trabajo. Estas máquinas permanecen inactivas y listas para procesar las acciones de forma inmediata. Para obtener más información sobre las flotas aprovisionadas, consulte. Propiedades de la flota aprovisionada
Si Fleet
se omite, el valor predeterminado es. Linux.x86-64.Large
Interfaz de usuario correspondiente: pestaña de configuración/flota de cómputo
Timeout
(ECSRenderTaskDefinition
/Timeout)
(Opcional)
Especifique la cantidad de tiempo en minutos (YAMLeditor) 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 de 5 minutos y el máximo se describe enCuotas para flujos de trabajo en CodeCatalyst. El tiempo de espera predeterminado es el mismo que el tiempo de espera máximo.
Interfaz de usuario correspondiente: pestaña de configuración/tiempo de espera: opcional
Inputs
(ECSRenderTaskDefinition
/Inputs)
(Opcional)
La Inputs
sección define los datos que se ECSRenderTaskDefinition
necesitan durante la ejecución de un flujo de trabajo.
nota
Solo se permite una entrada (ya sea una fuente o un artefacto) por acción de definición de ECS tareas de Render Amazon. Las variables no se tienen en cuenta para este total.
Interfaz de usuario correspondiente: pestaña de entradas
Sources
(ECSRenderTaskDefinition
/Inputs/Sources)
(Necesario si el archivo de definición de tareas está almacenado en un repositorio de origen)
Si el archivo de definición de tareas está almacenado en un repositorio de origen, especifique la etiqueta de ese repositorio de origen. Actualmente, la única etiqueta admitida esWorkflowSource
.
Si el archivo de definición de tareas no está contenido en un repositorio de origen, 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 origen a flujos de trabajo.
Interfaz de usuario correspondiente: pestaña Entradas/Fuentes (opcional)
Artifacts - input
(ECSRenderTaskDefinition
/Inputs/Artifacts)
(Obligatorio si el archivo de definición de tareas está almacenado en un artefacto de salida de una acción anterior)
Si el archivo de definición de tareas que desea implementar está contenido en un artefacto generado por una acción anterior, especifique ese artefacto aquí. Si el archivo de definición de tareas no está contenido en un artefacto, debe residir en el repositorio de origen.
Para obtener más información sobre los artefactos, incluidos ejemplos, consulteCompartir artefactos y archivos entre acciones.
Interfaz de usuario correspondiente: pestaña de configuración/Artefactos: opcional
Variables - input
(ECSRenderTaskDefinition
/Inputs/Variables)
(Obligatorio)
Especifique una secuencia de pares de nombre/valor que definan las variables de entrada que desea poner a disposición de la acción. Los nombres de las variables se limitan a caracteres alfanuméricos (a-z, A-Z, 0-9), guiones (-) y guiones bajos (_). No se permiten espacios. No puede usar comillas para habilitar los caracteres especiales y los espacios en los nombres de las variables.
Para obtener más información sobre las variables, incluidos ejemplos, consulteUso de variables en los flujos de trabajo.
Interfaz de usuario correspondiente: pestaña de 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 de configuración
task-definition
(ECSRenderTaskDefinition
/Configuration/task-definition)
(Obligatorio)
Especifique la ruta a un archivo de definición de tareas existente. Si el archivo reside en el repositorio de origen, la ruta es relativa a la carpeta raíz del repositorio de origen. Si el archivo reside en un artefacto de una acción de 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 Definiciones de tareas en la Guía para desarrolladores de Amazon Elastic Container Service.
Interfaz de usuario correspondiente: pestaña de configuración/definición de tareas
container-definition-name
(ECSRenderTaskDefinition
/Configuration/container-definition-name)
(Obligatorio)
Especifique el nombre del contenedor en el que se ejecutará la imagen de Docker. Puedes encontrar este nombre en el name
campocontainerDefinitions
, del archivo de definición de tareas. Para obtener más información, consulte Nombre en la guía para desarrolladores de Amazon Elastic Container Service.
Interfaz de usuario correspondiente: pestaña de configuración/nombre del contenedor
image
(ECSRenderTaskDefinition
/Configuration/image)
(Obligatorio)
Especifique el nombre de la imagen de Docker que desea que la acción de definición de ECS tareas Render Amazon añada a su archivo de definición de tareas. La acción añade este nombre al image
campocontainerDefinitions
, del archivo de definición de tareas. Si ya existe un valor en el image
campo, la acción lo sobrescribe. Puede incluir variables en el nombre de la imagen.
Ejemplos:
Si lo especificaMyDockerImage:${WorkflowSource.CommitId}
, la acción se añade MyDockerImage:
al archivo de definición de tareas, donde commit-id
commit-id
es un ID de confirmación generado en tiempo de ejecución por el flujo de trabajo.
Si lo especificasmy-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s)
, la acción añade my-ecr-repo
/image-repo:date
+%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
+%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 image
campo, consulte la imagen en la guía para desarrolladores de Amazon Elastic Container Service. Para obtener más información sobre las variables, consulteUso de variables en los flujos de trabajo.
Interfaz de usuario correspondiente: pestaña de configuración/nombre de imagen
environment-variables
(ECSRenderTaskDefinition
/Configuration/environment-variables)
(Obligatorio)
Especifique las variables de entorno que desee que la acción de definición de ECS tareas Render Amazon añada a su archivo de definición de tareas. La acción añade las variables al environment
campocontainerDefinitions
, del 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 ECS entorno de Amazon, consulte Especificación de variables de entorno en la Guía para desarrolladores de Amazon Elastic Container Service.
Interfaz de usuario correspondiente: pestaña de configuración/variables de entorno (opcional)
Outputs
(ECSRenderTaskDefinition
/Outputs)
(Obligatorio)
Define los datos que genera la acción durante la ejecución de un flujo de trabajo.
Interfaz de usuario correspondiente: pestaña de salidas
Artifacts
(ECSRenderTaskDefinition
/Outputs/Artifacts)
(Obligatorio)
Especifique los artefactos generados por la acción. Puedes hacer referencia a estos artefactos como entrada en otras acciones.
Para obtener más información sobre los artefactos, incluidos ejemplos, consulteCompartir artefactos y archivos entre acciones.
Interfaz de usuario correspondiente: pestaña de 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 ECS acción Implementar en Amazon. Para saber cómo añadir este artefacto como entrada a la ECS acción Implementar en Amazon, consulteEjemplo: modificar un ECS taskdef de Amazon.
Interfaz de usuario correspondiente: pestaña de salidas/Artefactos/nombre
Files
(ECSRenderTaskDefinition
/Outputs/Artifacts/Files)
(Obligatorio)
Especifique los archivos que desee incluir en el artefacto. Debe task-definition-*
especificarlo para que se incluya el archivo de definición de tareas actualizadotask-definition-
, que comienza con.
Interfaz de usuario correspondiente: pestaña de 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 renderización 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 ECS acción Deploy to Amazon. Para saber cómo añadir esta variable a la ECS acción Implementar en Amazon, consulteEjemplo: modificar un ECS taskdef de Amazon.
Valor predeterminado: task-definition
Interfaz de usuario correspondiente: pestaña de salidas/variables/campo de nombre