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. # Utilisez la `codebuild-tests-run` commande CLI AWS CodeBuild fournit une CLI qui prendra la commande de test et l'emplacement du fichier de test en entrée. La CLI avec ces entrées divisera les tests en un nombre de partitions tel que spécifié dans le `parallelism` champ en fonction des noms de fichiers de test. L'attribution des fichiers de test au shard est décidée par la stratégie de sharding. ``` codebuild-tests-run \ --files-search "codebuild-glob-search '**/__tests__/*.js'" \ --test-command 'npx jest --runInBand --coverage' \ --sharding-strategy 'equal-distribution' ``` Le tableau suivant décrit les champs de la commande `codebuild-tests-run` CLI. | Nom de champ | Type | Obligatoire ou facultatif | Définition | | --- | --- | --- | --- | | `test-command` | String | Obligatoire | Cette commande est utilisée pour exécuter les tests. | | `files-search` | String | Obligatoire | Cette commande fournit une liste de fichiers de test. Vous pouvez utiliser la commande [codebuild-glob-search](parallel-test-glob-search.md)CLI AWS CodeBuild fournie ou tout autre outil de recherche de fichiers de votre choix. Assurez-vous que la `files-search` commande affiche des noms de fichiers, séparés chacun par une nouvelle ligne. | | `sharding-strategy` | Enum | Facultatif | Valeurs valides : `equal-distribution` (par défaut), `stability` [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/parallel-test-tests-run.html) Pour de plus amples informations, veuillez consulter [À propos du fractionnement des tests](parallel-test-splitting.md). | La `codebuild-tests-run` CLI fonctionne d'abord pour identifier la liste des fichiers de test à l'aide de la commande fournie dans le `files-search` paramètre. Il détermine ensuite un sous-ensemble de fichiers de test désignés pour la partition actuelle (environnement) en utilisant la stratégie de partitionnement spécifiée. Enfin, ce sous-ensemble de fichiers de test est formaté sous forme de liste séparée par des espaces et ajouté à la fin de la commande fournie dans le `test-command` paramètre avant d'être exécuté. Pour les frameworks de test qui n'acceptent pas les listes séparées par des espaces, la `codebuild-tests-run` CLI fournit une alternative flexible via la variable d'`CODEBUILD_CURRENT_SHARD_FILES`environnement. Cette variable contient une liste séparée par de nouvelles lignes de chemins de fichiers de test désignés pour la partition de build actuelle. En tirant parti de cette variable d'environnement, vous pouvez facilement vous adapter aux différentes exigences du framework de test, en prenant en compte ceux qui attendent des formats d'entrée différents de ceux des listes séparées par des espaces. De plus, vous pouvez également formater les noms des fichiers de test selon les besoins du framework de test. Voici un exemple d'`CODEBUILD_CURRENT_SHARD_FILES`utilisation sous Linux avec le framework Django. Voici `CODEBUILD_CURRENT_SHARD_FILES` ce qui est utilisé pour obtenir les chemins de fichiers de *notation par points* supportés par Django : ``` codebuild-tests-run \ —files-search "codebuild-glob-search '/tests/test_.py'" \ —test-command 'python3 manage.py test $(echo "$CODEBUILD_CURRENT_SHARD_FILES" | sed -E "s/\//__/g; s/\.py$//; s/__/./g")' \ —sharding-strategy 'equal-distribution' ``` **Note** Notez que la variable d'`CODEBUILD_CURRENT_SHARD_FILES`environnement ne peut être utilisée que dans le cadre de la `codebuild-tests-run` CLI. De plus, si vous utilisez la commande de test `CODEBUILD_CURRENT_SHARD_FILES` interne, mettez-la entre `CODEBUILD_CURRENT_SHARD_FILES` guillemets, comme indiqué dans l'exemple ci-dessus.