Acción «Renderizar la definición de ECS tareas de Amazon» YAML - Amazon CodeCatalyst

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:commit-id al archivo de definición de tareas, donde 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