Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Modification d'une définition de tâche Amazon ECS
Cette section décrit comment mettre à jour le `image` champ dans un fichier de [définition de tâche Amazon Elastic Container Service (Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions)) à l'aide CodeCatalyst d'un flux de travail. Pour ce faire, vous devez ajouter l'action de **définition de tâche Render Amazon ECS** à votre flux de travail. Cette action met à jour le champ image du fichier de définition de tâche avec un nom d'image Docker fourni par votre flux de travail lors de l'exécution.
**Note**
Vous pouvez également utiliser cette action pour mettre à jour le `environment` champ de définition de tâche avec des variables d'environnement.
**Topics**
+ [Quand utiliser cette action](#render-ecs-action-when-to-use)
+ [Fonctionnement de l'action « Rendre la définition des tâches Amazon ECS »](#render-ecs-action-how-it-works)
+ [Image d'exécution utilisée par l'action « Rendre la définition des tâches Amazon ECS »](#render-ecs-action-runtime)
+ [Exemple : modifier une définition de tâches Amazon ECS](render-ecs-action-example-workflow.md)
+ [Ajout de l'action « Render la définition de tâche Amazon ECS »](render-ecs-action-add.md)
+ [Affichage du fichier de définition de tâche mis à jour](render-ecs-action-view.md)
+ [Variables « Afficher la définition de la tâche Amazon ECS »](render-ecs-action-variables.md)
+ [Action YAML « Rendre la définition de la tâche Amazon ECS »](render-ecs-action-ref.md)
## Quand utiliser cette action
Utilisez-le si vous disposez d'un flux de travail qui crée et balise une image Docker avec du contenu dynamique, tel qu'un identifiant de validation ou un horodatage.
N'utilisez pas cette action si votre fichier de définition de tâche contient une valeur d'image qui reste toujours la même. Dans ce cas, vous pouvez saisir manuellement le nom de votre image dans le fichier de définition de tâche.
## Fonctionnement de l'action « Rendre la définition des tâches Amazon ECS »
Vous devez utiliser l'action de **définition de tâche Render Amazon ECS** avec les actions **Build** et **Deploy to Amazon ECS** dans votre flux de travail. Ensemble, ces actions fonctionnent comme suit :
1. L'action de **création** crée votre image Docker et l'étiquette avec un nom, un identifiant de validation, un horodatage ou un autre contenu dynamique. Par exemple, votre action de création peut ressembler à ceci :
```
MyECSWorkflow
Actions:
BuildAction:
Identifier: aws/build@v1
...
Configuration:
Steps:
# Build, tag, and push the Docker image...
- Run: docker build -t MyDockerImage:${WorkflowSource.CommitId} .
...
```
Dans le code précédent, la `docker build -t` directive indique de créer l'image Docker et de l'étiqueter avec l'ID de validation lors de l'exécution de l'action. Le nom de l'image générée peut ressembler à ceci :
`MyDockerImage:a37bd7e`
1. L'action de **définition de tâche Render Amazon ECS** ajoute le nom de l'image générée dynamiquement à votre fichier de définition de tâche, comme suit : `MyDockerImage:a37bd7e`
```
{
"executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
"containerDefinitions": [
{
"name": "codecatalyst-ecs-container",
"image": MyDockerImage:a37bd7e,
"essential": true,
...
"portMappings": [
{
"hostPort": 80,
"protocol": "tcp",
"containerPort": 80
}
]
}
],
...
}
```
Vous pouvez également demander à l'action **Render Amazon ECS de définition de tâche** d'ajouter des variables d'environnement à la définition de tâche, comme suit :
```
{
"executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
"containerDefinitions": [
{
"name": "codecatalyst-ecs-container",
"image": MyDockerImage:a37bd7e,
...
"environment": [
{
name": "ECS_LOGLEVEL",
value": "info"
}
]
}
],
...
}
```
Pour plus d'informations sur les variables d'environnement, consultez la section [Spécification des variables d'environnement](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) dans le manuel *Amazon Elastic Container Service Developer Guide*.
1. L'action **Deploy to Amazon ECS** enregistre le fichier de définition de tâche mis à jour auprès d'Amazon ECS. L'enregistrement du fichier de définition de tâche mis à jour déploie la nouvelle image `MyDockerImage:a37bd7e` dans Amazon ECS.
## Image d'exécution utilisée par l'action « Rendre la définition des tâches Amazon ECS »
L'action de **définition de tâche Render Amazon ECS** s'exécute sur une [image de novembre 2022](build-images.md#build.previous-image). Pour de plus amples informations, veuillez consulter [Images actives](build-images.md#build-curated-images).
# Exemple : modifier une définition de tâches Amazon ECS
Voici un exemple de flux de travail complet qui inclut l'action de **définition de tâche Render Amazon ECS**, ainsi que les actions de création et de déploiement. L'objectif du flux de travail est de créer et de déployer une image Docker dans votre cluster Amazon ECS. Le flux de travail comprend les éléments de base suivants qui s'exécutent de manière séquentielle :
+ Un **déclencheur** : ce déclencheur lance automatiquement l'exécution du flux de travail lorsque vous apportez une modification à votre référentiel source. Pour plus d'informations sur les déclencheurs, consultez [Démarrage d'un flux de travail exécuté automatiquement à l'aide de déclencheurs](workflows-add-trigger.md).
+ Une action de **génération** (`BuildDocker`) — Au moment du déclenchement, l'action crée l'image Docker à l'aide du Dockerfile, l'étiquette avec un ID de validation et envoie l'image vers Amazon ECR. Pour plus d'informations sur l'action de génération, consultez[Construire avec des flux de travail](build-workflow-actions.md).
+ Une action de **définition de tâche Render Amazon ECS** (`RenderTaskDef`) : à la fin de l'action de génération, cette action met à jour un `taskdef.json` élément existant situé à la racine de votre référentiel source avec une valeur de `image` champ qui inclut l'ID de validation correct. Il enregistre le fichier mis à jour sous un nouveau nom de fichier (`task-definition-random-string.json`), puis crée un artefact de sortie contenant ce fichier. L'action de rendu génère également une variable appelée `task-definition` et lui attribue le nom du nouveau fichier de définition de tâche. L'artefact et la variable seront utilisés lors de l'action de déploiement, qui est la suivante.
+ Une action de **déploiement vers Amazon ECS** (`DeployToECS`) : une fois l'action de **définition de tâche Render Amazon ECS** terminée, l'action **Deploy to Amazon ECS** recherche l'artefact de sortie généré par l'action de rendu (`TaskDefArtifact`), trouve le `task-definition-random-string.json` fichier qu'il contient et l'enregistre auprès de votre service Amazon ECS. Le service Amazon ECS suit ensuite les instructions du `task-definition-random-string.json` fichier pour exécuter les tâches Amazon ECS et les conteneurs d'images Docker associés au sein de votre cluster Amazon ECS.
```
Name: codecatalyst-ecs-workflow
SchemaVersion: 1.0
Triggers:
- Type: PUSH
Branches:
- main
Actions:
BuildDocker:
Identifier: aws/build@v1
Environment:
Name: codecatalyst-ecs-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-ecs-build-role
Inputs:
Variables:
- Name: REPOSITORY_URI
Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo
- Name: IMAGE_TAG
Value: ${WorkflowSource.CommitId}
Configuration:
Steps:
#pre_build:
- Run: echo Logging in to Amazon ECR...
- Run: aws --version
- Run: aws ecr get-login-password --region us-east-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-2.amazonaws.com
#build:
- Run: echo Build started on `date`
- Run: echo Building the Docker image...
- Run: docker build -t $REPOSITORY_URI:latest .
- Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG
#post_build:
- Run: echo Build completed on `date`
- Run: echo Pushing the Docker images...
- Run: docker push $REPOSITORY_URI:latest
- Run: docker push $REPOSITORY_URI:$IMAGE_TAG
RenderTaskDef:
DependsOn:
- BuildDocker
Identifier: aws/ecs-render-task-definition@v1
Inputs:
Variables:
- Name: REPOSITORY_URI
Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo
- Name: IMAGE_TAG
Value: ${WorkflowSource.CommitId}
Configuration:
task-definition: taskdef.json
container-definition-name: codecatalyst-ecs-container
image: $REPOSITORY_URI:$IMAGE_TAG
# The output artifact contains the updated task definition file.
# The new file is prefixed with 'task-definition'.
# The output variable is set to the name of the updated task definition file.
Outputs:
Artifacts:
- Name: TaskDefArtifact
Files:
- "task-definition*"
Variables:
- task-definition
DeployToECS:
Identifier: aws/ecs-deploy@v1
Environment:
Name: codecatalyst-ecs-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-ecs-deploy-role
#Input artifact contains the updated task definition file.
Inputs:
Sources: []
Artifacts:
- TaskDefArtifact
Configuration:
region: us-east-2
cluster: codecatalyst-ecs-cluster
service: codecatalyst-ecs-service
task-definition: ${RenderTaskDef.task-definition}
```
# Ajout de l'action « Render la définition de tâche Amazon ECS »
Suivez les instructions suivantes pour ajouter l'action de **définition de tâche Render Amazon ECS** à votre flux de travail.
**Prérequis**
Avant de commencer, assurez-vous de disposer d'un flux de travail qui inclut une action de génération qui génère dynamiquement une image Docker. Reportez-vous à l'[exemple de flux de travail](render-ecs-action-example-workflow.md) précédent pour plus de détails.
------
#### [ Visual ]
**Pour ajouter l'action « Render la définition des tâches Amazon ECS » à l'aide de l'éditeur visuel**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez **Modifier**.
1. Choisissez **Visual**.
1. En haut à gauche, choisissez **\$1 Actions** pour ouvrir le catalogue d'actions.
1. Dans la liste déroulante, sélectionnez **Amazon CodeCatalyst**.
1. Recherchez l'action de **définition de tâche Render Amazon ECS**, puis effectuez l'une des opérations suivantes :
+ Choisissez le signe plus (**\$1**) pour ajouter l'action au diagramme de flux de travail et ouvrir son volet de configuration.
Or
+ Choisissez la **définition de tâche Render Amazon ECS**. La boîte de dialogue des détails de l'action apparaît. Dans cette boîte de dialogue :
+ (Facultatif) Choisissez **Afficher la source** pour [afficher le code source de l'action](workflows-view-source.md#workflows-view-source.title).
+ Choisissez **Ajouter au flux de travail** pour ajouter l'action au diagramme du flux de travail et ouvrir son volet de configuration.
1. Dans les onglets **Entrées** et **Configuration**, complétez les champs en fonction de vos besoins. Pour obtenir une description de chaque champ, consultez le[Action YAML « Rendre la définition de la tâche Amazon ECS »](render-ecs-action-ref.md). Cette référence fournit des informations détaillées sur chaque champ (et la valeur de propriété YAML correspondante) tel qu'il apparaît dans les éditeurs YAML et visuels.
1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.
1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.
------
#### [ YAML ]
**Pour ajouter l'action « Render Amazon ECS task definition » à l'aide de l'éditeur YAML**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez **Modifier**.
1. Choisissez **YAML.**
1. En haut à gauche, choisissez **\$1 Actions** pour ouvrir le catalogue d'actions.
1. Dans la liste déroulante, sélectionnez **Amazon CodeCatalyst**.
1. Recherchez l'action de **définition de tâche Render Amazon ECS**, puis effectuez l'une des opérations suivantes :
+ Choisissez le signe plus (**\$1**) pour ajouter l'action au diagramme de flux de travail et ouvrir son volet de configuration.
Or
+ Choisissez la **définition de tâche Render Amazon ECS**. La boîte de dialogue des détails de l'action apparaît. Dans cette boîte de dialogue :
+ (Facultatif) Choisissez **Afficher la source** pour [afficher le code source de l'action](workflows-view-source.md#workflows-view-source.title).
+ Choisissez **Ajouter au flux de travail** pour ajouter l'action au diagramme du flux de travail et ouvrir son volet de configuration.
1. Modifiez les propriétés du code YAML en fonction de vos besoins. Une explication de chaque propriété disponible est fournie dans le[Action YAML « Rendre la définition de la tâche Amazon ECS »](render-ecs-action-ref.md).
1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.
1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.
------
**Étapes suivantes**
Après avoir ajouté l'action de rendu, ajoutez l'action **Deploy to Amazon ECS** à votre flux de travail en suivant les instructions fournies dans[Déploiement sur Amazon ECS à l'aide d'un flux de travail](deploy-action-ecs.md). Lors de l'ajout de l'action de déploiement, procédez comme suit :
1. Dans l'onglet **Entrées** de l'action de déploiement, dans **Artefacts - facultatif**, sélectionnez l'artefact généré par l'action de rendu. Il contient le fichier de définition de tâche mis à jour.
Pour plus d'informations sur les artefacts, consultez [Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md).
1. Dans l'onglet **Configuration** de l'action de déploiement, dans le champ **Définition de la tâche**, spécifiez la variable d'action suivante : `${action-name.task-definition}` où *action-name* est le nom de votre action de rendu, par exemple,`RenderTaskDef`. L'action de rendu attribue à cette variable le nouveau nom du fichier de définition de tâche.
Pour plus d'informations sur les variables, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md).
Pour plus d'informations sur la configuration de l'action de déploiement, consultez l'[exemple de flux](render-ecs-action-example-workflow.md) de travail précédent.
# Affichage du fichier de définition de tâche mis à jour
Vous pouvez consulter le nom et le contenu du fichier de définition de tâche mis à jour.
**Pour afficher le nom du fichier de définition de tâche mis à jour, une fois que l'action de **définition de tâche Render Amazon ECS** l'a traité.**
1. Trouvez l'exécution qui inclut une action de rendu terminée :
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez une exécution qui inclut l'action de rendu terminée.
1. Dans le diagramme du flux de travail, choisissez l'action de rendu.
1. Choisissez **Sorties**.
1. Choisissez **Variables**.
1. Le nom du fichier de définition de tâche s'affiche. Cela ressemble à`task-definition--259-0a2r7gxlTF5X-.json`.
**Pour afficher le contenu du fichier de définition de tâche mis à jour**
1. Trouvez l'exécution qui inclut une action de rendu terminée :
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Choisissez votre projet.
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.
1. Choisissez une exécution qui inclut l'action de rendu terminée.
1. Lors de l'exécution du flux de travail, en haut, à côté de **Visual** et **YAML**, choisissez les **sorties du flux de travail**.
1. Dans la section **Artefacts**, choisissez **Télécharger** à côté de l'artefact contenant le fichier de définition de tâche mis à jour. La colonne **Produit par** sera définie sur le nom de votre action de rendu pour cet artefact.
1. Ouvrez le fichier .zip pour afficher le fichier .json de définition de tâche.
# Variables « Afficher la définition de la tâche Amazon ECS »
L'action de **définition de tâche Render Amazon ECS** produit et définit les variables suivantes au moment de l'exécution. Ces variables sont connues sous le nom de *variables prédéfinies*.
Pour plus d'informations sur le référencement de ces variables dans un flux de travail, consultez[Utilisation de variables prédéfinies](workflows-using-predefined-variables.md).
| Clé | Valeur |
| --- | --- |
| définition des tâches | Nom donné au fichier de définition de tâche mis à jour par l'action de **définition de tâche Render Amazon ECS**. Le nom utilise le format suivant : `task-definition-random-string.json`. Exemple : `task-definition--259-0a2r7gxlTF5Xr.json` |
# Action YAML « Rendre la définition de la tâche Amazon ECS »
Voici la définition YAML de l'action de définition de **tâche Render Amazon ECS**. Pour savoir comment utiliser cette action, consultez[Modification d'une définition de tâche Amazon ECS](render-ecs-action.md).
Cette définition d'action existe sous forme de section au sein d'un fichier de définition de flux de travail plus large. Pour plus d’informations sur ce fichier, consultez [Définition du flux de travail YAML](workflow-reference.md).
**Note**
La plupart des propriétés YAML suivantes ont des éléments d'interface utilisateur correspondants dans l'éditeur visuel. Pour rechercher un élément de l'interface utilisateur, utilisez **Ctrl\$1F**. L'élément sera répertorié avec sa propriété YAML associée.
```
# The workflow definition starts here.
# See Propriétés de haut niveau 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
(Obligatoire)
Spécifiez le nom de l'action. Tous les noms d'action doivent être uniques dans le flux de travail. Les noms d'action sont limités aux caractères alphanumériques (a-z, A-Z, 0-9), aux tirets (-) et aux traits de soulignement (\$1). Les espaces ne sont pas autorisés. Vous ne pouvez pas utiliser de guillemets pour activer les caractères spéciaux et les espaces dans les noms d'action.
Par défaut : `ECSRenderTaskDefinition_nn`.
Interface utilisateur correspondante : onglet Configuration/nom de **l'action**
## Identifier
(*ECSRenderTaskDefinition*/**Identifier**)
(Obligatoire)
Identifie l'action. Ne modifiez pas cette propriété, sauf si vous souhaitez modifier la version. Pour de plus amples informations, veuillez consulter [Spécification de la version de l'action à utiliser](workflows-action-versions.md).
Par défaut : `aws/ecs-render-task-definition@v1`.
**Interface utilisateur correspondante : diagramme de flux de travail/ ECSRenderTaskDefinition \$1nn/ aws/ @v1 label ecs-render-task-definition**
## DependsOn
(*ECSRenderTaskDefinition*/**DependsOn**)
(Facultatif)
Spécifiez une action, un groupe d'actions ou une porte qui doit s'exécuter correctement pour que cette action soit exécutée.
Pour plus d'informations sur la fonctionnalité « dépend », consultez. [Actions de séquençage](workflows-depends-on.md)
Interface utilisateur correspondante : onglet **Entrées/dépend de - facultatif**
## Compute
(*ECSRenderTaskDefinition*/**Compute**)
(Facultatif)
Le moteur informatique utilisé pour exécuter les actions de votre flux de travail. Vous pouvez spécifier le calcul au niveau du flux de travail ou au niveau de l'action, mais pas les deux. Lorsqu'elle est spécifiée au niveau du flux de travail, la configuration de calcul s'applique à toutes les actions définies dans le flux de travail. Au niveau du flux de travail, vous pouvez également exécuter plusieurs actions sur la même instance. Pour de plus amples informations, veuillez consulter [Partage du calcul entre les actions](compute-sharing.md).
Interface utilisateur correspondante : *aucune*
## Type
(*ECSRenderTaskDefinition*/Compute/**Type**)
(Obligatoire s'[Compute](#render.ecs.computename)il est inclus)
Type de moteur de calcul. Vous pouvez utiliser l'une des valeurs suivantes :
+ **EC2**(éditeur visuel) ou `EC2` (éditeur YAML)
Optimisé pour la flexibilité lors des courses d'action.
+ **Lambda** (éditeur visuel) ou `Lambda` (éditeur YAML)
Vitesses de démarrage des actions optimisées.
Pour plus d'informations sur les types de calcul, veuillez consulter [Types de calcul](workflows-working-compute.md#compute.types).
Interface utilisateur correspondante : onglet Configuration/Type **de calcul**
## Fleet
(*ECSRenderTaskDefinition*/Compute/**Fleet**)
(Facultatif)
Spécifiez la machine ou le parc qui exécutera votre flux de travail ou vos actions de flux de travail. Dans le cas des flottes à la demande, lorsqu'une action démarre, le flux de travail fournit les ressources dont il a besoin et les machines sont détruites à la fin de l'action. Exemples de flottes à la demande :`Linux.x86-64.Large`,`Linux.x86-64.XLarge`. Pour plus d'informations sur les flottes à la demande, consultez[Propriétés de la flotte à la demande](workflows-working-compute.md#compute.on-demand).
Avec les flottes provisionnées, vous configurez un ensemble de machines dédiées pour exécuter les actions de votre flux de travail. Ces machines restent inactives, prêtes à exécuter des actions immédiatement. Pour plus d'informations sur les flottes provisionnées, consultez. [Propriétés de la flotte de véhicules provisionnée](workflows-working-compute.md#compute.provisioned-fleets)
S'il `Fleet` est omis, la valeur par défaut est`Linux.x86-64.Large`.
Interface utilisateur correspondante : onglet Configuration/parc **de calcul**
## Timeout
(*ECSRenderTaskDefinition*/**Timeout**)
(Facultatif)
Spécifiez la durée en minutes (éditeur YAML) ou en heures et minutes (éditeur visuel) pendant laquelle l'action peut être exécutée avant la CodeCatalyst fin de l'action. Le minimum est de 5 minutes et le maximum est décrit dans[Quotas pour les flux de travail dans CodeCatalyst](workflows-quotas.md). Le délai d'expiration par défaut est le même que le délai d'expiration maximal.
Interface utilisateur correspondante : onglet **Configuration/Délai d'expiration - facultatif**
## Inputs
(*ECSRenderTaskDefinition*/**Inputs**)
(Facultatif)
La `Inputs` section définit les données dont ils ont `ECSRenderTaskDefinition` besoin lors de l'exécution d'un flux de travail.
**Note**
Une seule entrée (source ou artefact) est autorisée par action de **définition de tâche Render Amazon ECS**. Les variables ne sont pas prises en compte dans ce total.
Interface utilisateur correspondante : onglet **Entrées**
## Sources
(*ECSRenderTaskDefinition*/Inputs/**Sources**)
(Obligatoire si votre fichier de définition de tâche est stocké dans un référentiel source)
Si votre fichier de définition de tâche est stocké dans un référentiel source, spécifiez l'étiquette de ce référentiel source. Actuellement, la seule étiquette prise en charge est`WorkflowSource`.
Si votre fichier de définition de tâche n'est pas contenu dans un référentiel source, il doit résider dans un artefact généré par une autre action.
Pour plus d'informations sur les sources, consultez [Connecter les référentiels sources aux flux de travail](workflows-sources.md).
Interface utilisateur correspondante : onglet **Entrées/Sources - facultatif**
## Artifacts - input
(*ECSRenderTaskDefinition*/Inputs/**Artifacts**)
(Obligatoire si votre fichier de définition de tâche est stocké dans un [artefact de sortie](workflows-working-artifacts-output.md) d'une action précédente)
Si le fichier de définition de tâche que vous souhaitez déployer est contenu dans un artefact généré par une action précédente, spécifiez cet artefact ici. Si votre fichier de définition de tâche n'est pas contenu dans un artefact, il doit résider dans votre référentiel source.
Pour plus d'informations sur les artefacts, y compris des exemples, consultez[Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md).
Interface utilisateur correspondante : onglet **Configuration/Artefacts - facultatif**
## Variables - input
(*ECSRenderTaskDefinition*/Inputs/**Variables**)
(Obligatoire)
Spécifiez une séquence de name/value paires qui définit les variables d'entrée que vous souhaitez mettre à la disposition de l'action. Les noms de variables sont limités aux caractères alphanumériques (a-z, A-Z, 0-9), aux tirets (-) et aux traits de soulignement (\$1). Les espaces ne sont pas autorisés. Vous ne pouvez pas utiliser de guillemets pour activer les caractères spéciaux et les espaces dans les noms de variables.
Pour plus d'informations sur les variables, y compris des exemples, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md).
Interface utilisateur correspondante : onglet **Entrées/Variables - facultatif**
## Configuration
(*ECSRenderTaskDefinition*/**Configuration**)
(Obligatoire)
Section dans laquelle vous pouvez définir les propriétés de configuration de l'action.
Interface utilisateur correspondante : onglet **Configuration**
## task-definition
(*ECSRenderTaskDefinition*/Configuration/**task-definition**)
(Obligatoire)
Spécifiez le chemin d'accès à un fichier de définition de tâche existant. Si le fichier se trouve dans votre dépôt source, le chemin est relatif au dossier racine du dépôt source. Si votre fichier réside dans un artefact issu d'une action de flux de travail précédente, le chemin est relatif au dossier racine de l'artefact. Pour plus d'informations sur les fichiers de définition de tâches, consultez la section [Définitions de tâches](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions) dans le manuel *Amazon Elastic Container Service Developer Guide*.
Interface utilisateur correspondante : onglet Configuration/Définition des **tâches**
## container-definition-name
(*ECSRenderTaskDefinition*/Configuration/**container-definition-name**)
(Obligatoire)
Spécifiez le nom du conteneur dans lequel votre image Docker sera exécutée. Vous pouvez trouver ce nom dans le `name` champ`containerDefinitions`, de votre fichier de définition de tâche. Pour plus d'informations, consultez la section [Nom](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_name) dans le manuel *Amazon Elastic Container Service Developer Guide*.
Interface utilisateur correspondante : onglet Configuration/nom **du conteneur**
## image
(*ECSRenderTaskDefinition*/Configuration/**image**)
(Obligatoire)
Spécifiez le nom de l'image Docker que l'action de **définition de tâche Render Amazon ECS** doit ajouter à votre fichier de définition de tâche. L'action ajoute ce nom au `image` champ`containerDefinitions`, de votre fichier de définition de tâche. Si une valeur existe déjà dans le `image` champ, l'action la remplace. Vous pouvez inclure des variables dans le nom de l'image.
Exemples :
Si vous le spécifiez`MyDockerImage:${WorkflowSource.CommitId}`, l'action est ajoutée `MyDockerImage:commit-id` au fichier de définition de tâche, où se *commit-id* trouve un ID de validation généré lors de l'exécution par le flux de travail.
Si vous le spécifiez`my-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s)`, l'action ajoute *my-ecr-repo* /image-repo : *date \$1%m-%d-%y-%H-%m-%s* au fichier de définition de tâche, où se *my-ecr-repo* trouve l'URI d'un Amazon Elastic Container Registry (ECR) et un horodatage au format *date \$1%m-%d-%y-%H-%m-%s* `month-day-year-hour-minute-second` généré lors de l'exécution par le flux de travail.
Pour plus d'informations sur ce `image` champ, consultez l'[image](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_image) dans le manuel *Amazon Elastic Container Service Developer Guide*. Pour plus d'informations sur les variables, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md).
Interface utilisateur correspondante : onglet Configuration/nom de **l'image**
## environment-variables
(*ECSRenderTaskDefinition*/Configuration/**environment-variables**)
(Obligatoire)
Spécifiez les variables d'environnement que l'action **Render Amazon ECS** doit ajouter à votre fichier de définition de tâche. L'action ajoute les variables au `environment` champ`containerDefinitions`, de votre fichier de définition de tâche. Si des variables existent déjà dans le fichier, l'action remplace les valeurs des variables existantes et ajoute de nouvelles variables. Pour plus d'informations sur les variables d'environnement Amazon ECS, consultez la section [Spécification des variables d'environnement](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) dans le manuel *Amazon Elastic Container Service Developer Guide*.
Interface utilisateur correspondante : onglet **Configuration/variables d'environnement - facultatif**
## Outputs
(*ECSRenderTaskDefinition*/**Outputs**)
(Obligatoire)
Définit les données produites par l'action lors de l'exécution d'un flux de travail.
Interface utilisateur correspondante : onglet **Sorties**
## Artifacts
(*ECSRenderTaskDefinition*/Outputs/**Artifacts**)
(Obligatoire)
Spécifiez les artefacts générés par l'action. Vous pouvez faire référence à ces artefacts en tant qu'entrée dans d'autres actions.
Pour plus d'informations sur les artefacts, y compris des exemples, consultez[Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md).
**Interface utilisateur correspondante : onglet Sorties/Artefacts**
## Name
(*ECSRenderTaskDefinition*/Outputs/Artifacts/**Name**)
(Obligatoire)
Spécifiez le nom de l'artefact qui contiendra le fichier de définition de tâche mis à jour. La valeur par défaut est `MyTaskDefinitionArtifact`. Vous devez ensuite spécifier cet artefact comme entrée dans l'action **Deploy to Amazon ECS**. Pour comprendre comment ajouter cet artefact en tant qu'entrée à l'action **Deploy to Amazon ECS**, consultez[Exemple : modifier une définition de tâches Amazon ECS](render-ecs-action-example-workflow.md).
**Interface utilisateur correspondante : onglet Sorties/Artefacts/Nom**
## Files
(*ECSRenderTaskDefinition*/Outputs/Artifacts/**Files**)
(Obligatoire)
Spécifiez les fichiers à inclure dans l'artefact. Vous devez spécifier `task-definition-*` que le fichier de définition de tâche mis à jour, qui commence par`task-definition-`, sera inclus.
**Interface utilisateur correspondante : onglet Sorties/Artefacts/Fichiers**
## Variables
(*ECSRenderTaskDefinition*/Outputs/**Variables**)
(Obligatoire)
Spécifiez le nom d'une variable à définir par l'action de rendu. L'action de rendu définira la valeur de cette variable sur le nom du fichier de définition de tâche mis à jour (par exemple,`task-definition-random-string.json`). Vous devez ensuite spécifier cette variable dans la propriété de **définition de tâche** **(éditeur visuel) ou `task-definition` (éditeur yaml) de l'action Deploy to Amazon ECS**. Pour comprendre comment ajouter cette variable à l'action **Deploy to Amazon ECS**, consultez[Exemple : modifier une définition de tâches Amazon ECS](render-ecs-action-example-workflow.md).
Par défaut : `task-definition`
**Interface utilisateur correspondante : onglet Sorties/Variables/Champ de nom**