Créez des expressions pour définir des instances de conteneur pour les ECS tâches Amazon

Les requêtes de cluster sont des expressions qui vous permettent de regrouper des objets. Par exemple, vous pouvez regrouper des instances de conteneur par attributs, notamment par zone de disponibilité, type d'instance ou métadonnées personnalisées. Pour de plus amples informations, veuillez consulter Attributs de l'instance de ECS conteneur Amazon.

Après avoir défini un groupe d'instances de conteneur, vous pouvez personnaliser Amazon ECS pour placer des tâches sur des instances de conteneur en fonction du groupe. Pour plus d'informations, consultez Exécution d'une application en tant que ECS tâche Amazon et Création d'un ECS service Amazon à l'aide de la console. Vous pouvez également appliquer un filtre de groupe lorsque vous répertoriez les instances de conteneur.

Syntaxe des expressions

Les expressions ont la syntaxe suivante :

subject operator [argument]

Sujet

Attribut ou champ à évaluer.

agentConnected

Sélectionnez les instances de conteneur en fonction de leur statut de connexion à l'agent de ECS conteneur Amazon. Vous pouvez utiliser ce filtre pour rechercher des instances avec des agents de conteneur déconnectés.

Opérateurs valides : equals (==), not_equals (!=), in, not_in (!in), matches (=~), not_matches (!~)

agentVersion

Sélectionnez les instances de conteneur en fonction de leur version d'agent de ECS conteneur Amazon. Vous pouvez utiliser ce filtre pour rechercher les instances qui exécutent des versions obsolètes de l'agent de ECS conteneur Amazon.

Opérateurs valides : equals (==), not_equals (!=), greater_than (>), greater_than_equal (>=), less_than (<), less_than_equal (<=)

attribute:attribute-name

Sélectionnez les instances de conteneur par attribut. Pour de plus amples informations, veuillez consulter Attributs de l'instance de ECS conteneur Amazon.

ec2InstanceId

Sélectionnez les instances de conteneur en fonction de leur ID d'EC2instance Amazon.

Opérateurs valides : equals (==), not_equals (!=), in, not_in (!in), matches (=~), not_matches (!~)

registeredAt

Sélectionnez les instances de conteneur par leur date d'enregistrement d'instance de conteneur. Vous pouvez utiliser ce filtre pour trouver de nouvelles instances enregistrées ou des instances très anciennes.

Opérateurs valides : equals (==), not_equals (!=), greater_than (>), greater_than_equal (>=), less_than (<), less_than_equal (<=)

Formats de date valides : 2018-06-18T22:28:28+00:00, 2018-06-18T22:28:28Z, 2018-06-18T22:28:28, 2018-06-18

runningTasksCount

Sélectionnez les instances de conteneur par nombre de tâches en cours d'exécution. Vous pouvez utiliser ce filtre pour trouver des instances vides ou presque vides (peu de tâches exécutées sur elles).

Opérateurs valides : equals (==), not_equals (!=), greater_than (>), greater_than_equal (>=), less_than (<), less_than_equal (<=)

task:group

Sélectionnez les instances de conteneur par groupe de tâches. Pour de plus amples informations, veuillez consulter ECSTâches Amazon liées au groupe .

Opérateur

Opérateur de comparaison. Les opérateurs suivants sont pris en charge.

Opérateur	Description
==, equals	Égalité de chaînes
!=, not_equals	Inégalité de chaînes
>, greater_than	Supérieur à
>=, greater_than_equal	Supérieur ou égal à
<, less_than	Inférieur à
<=, less_than_equal	Inférieur ou égal à
exists	Le sujet existe
!exists, not_exists	Le sujet n'existe pas
dans	Valeur présente dans la liste d'arguments
!in, not_in	Valeur ne se trouvant pas dans la liste d'arguments
=~, matches	Correspondance de modèle
!~, not_matches	Non-correspondance de modèle

Note

Une expression ne peut pas contenir de parenthèses. En revanche, vous pouvez utiliser des parenthèses pour spécifier la priorité dans des expressions composées.

Argument

Pour de nombreux opérateurs, l'argument est une valeur littérale.

Les opérateurs in et not_in attendent une liste d'arguments comme argument. Vous spécifiez une liste d'arguments comme suit :

[argument1, argument2, ..., argumentN]

Les opérateurs matches et not_matches attendent un argument respectant la syntaxe de l'expression régulière Java. Pour en savoir plus, consultez java.util.regex.Pattern.

Expressions composées

Vous pouvez combiner des expressions à l'aide des opérateurs booléens suivants :

• &&, and

• ||, or

• !, not

Vous pouvez spécifier la priorité à l'aide de parenthèses :

(expression1 or expression2) and expression3

Exemples d'expressions

Des exemples d'expressions sont présentés ci-après.

Exemple : égalité des chaînes

L'expression suivante sélectionne des instances avec le type d'instance spécifié.

attribute:ecs.instance-type == t2.small

Exemple : liste d'arguments

L'expression suivante sélectionne des instances dans la zone de disponibilité us-east-1a ou us-east-1b.

attribute:ecs.availability-zone in [us-east-1a, us-east-1b]

Exemple : expression composée

L'expression suivante sélectionne des instances G2 qui ne se trouvent pas dans la zone de disponibilité us-east-1d.

attribute:ecs.instance-type =~ g2.* and attribute:ecs.availability-zone != us-east-1d

Exemple : affinité des tâches

L'expression suivante sélectionne des instances qui hébergent des tâches dans le groupe service:production.

task:group == service:production

Exemple : anti-affinité des tâches

L'expression suivante sélectionne des instances qui n'hébergent pas de tâches dans le groupe de base de données.

not(task:group == database)

Exemple : nombre de tâches en cours d'exécution

L'expression suivante sélectionne des instances qui n'exécutent qu'une seule tâche.

runningTasksCount == 1

Exemple : version de l'agent de ECS conteneur Amazon

L'expression suivante sélectionne des instances qui exécutent une version de l'agent de conteneur antérieure à 1.14.5.

agentVersion < 1.14.5

Exemple : Date d'enregistrement d'instance

L'expression suivante sélectionne des instances qui ont été enregistrées avant le 13 février 2018.

registeredAt < 2018-02-13

Exemple : ID d'EC2instance Amazon

L'expression suivante sélectionne des instances avec l'EC2instance Amazon suivanteIDs.

ec2InstanceId in ['i-abcd1234', 'i-wxyx7890']