

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.

# Uso del comando `codebuild-tests-run` de la CLI
<a name="parallel-test-tests-run"></a>

AWS CodeBuild proporciona una CLI que tomará el comando de prueba y la ubicación del archivo de prueba como entrada. La CLI con estas entradas dividirá las pruebas en el número de particiones especificado en el campo `parallelism` basándose en los nombres de los archivos de prueba. La asignación de archivos de prueba a la partición se decide mediante la estrategia de partición.

```
codebuild-tests-run \
    --files-search "codebuild-glob-search '**/__tests__/*.js'" \
    --test-command 'npx jest --runInBand --coverage' \
    --sharding-strategy 'equal-distribution'
```

En la siguiente tabla se describen los capos del comando `codebuild-tests-run` de la CLI.


| Nombre del campo | Tipo | Obligatorio u opcional | Definición | 
| --- | --- | --- | --- | 
|  `test-command`  |  Cadena  |  Obligatorio  |  Este comando se usa para ejecutar las pruebas.  | 
|  `files-search`  |  Cadena  |  Obligatorio  |  Este comando proporciona una lista de archivos de prueba. Puede utilizar el comando [codebuild-glob-search](parallel-test-glob-search.md)CLI AWS CodeBuild proporcionado o cualquier otra herramienta de búsqueda de archivos que prefiera.  Asegúrese de que el comando `files-search` muestre los nombres de archivo, cada uno de ellos separado por una línea.   | 
|  `sharding-strategy`  |  Enum  |  Opcional  |  Valores válidos: `equal-distribution`, (predeterminado), `stability` [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codebuild/latest/userguide/parallel-test-tests-run.html) Para obtener más información, consulte [Acerca de la división de pruebas](parallel-test-splitting.md).  | 

La `codebuild-tests-run` CLI trabaja primero para identificar la lista de archivos de prueba mediante el comando proporcionado en el parámetro `files-search`. A continuación, determina un subconjunto de archivos de prueba designados para la partición (entorno) actual mediante la estrategia de partición especificada. Por último, este subconjunto de archivos de prueba se formatea en una lista separada por espacios y se añade al final del comando proporcionado en el parámetro `test-command` antes de que se ejecute.

Para los marcos de prueba que no aceptan listas separadas por espacios, la `codebuild-tests-run` CLI proporciona una alternativa flexible a través de la variable de entorno `CODEBUILD_CURRENT_SHARD_FILES`. Esta variable contiene una lista separada por líneas de rutas de archivos de prueba designadas para la partición de compilación actual. Aprovechando esta variable de entorno, puede adaptarse fácilmente a varios requisitos del marco de pruebas y adaptarse a aquellos que requieren formatos de entrada diferentes de listas separadas por espacios. Además, también puede formatear los nombres de los archivos de prueba según las necesidades del marco de prueba. A continuación se ofrece un ejemplo de uso de `CODEBUILD_CURRENT_SHARD_FILES` en Linux con el marco Django. Aquí se usa `CODEBUILD_CURRENT_SHARD_FILES` para obtener rutas de archivo de *notación de puntos* compatibles con 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'
```

**nota**  
Tenga en cuenta que la variable de entorno `CODEBUILD_CURRENT_SHARD_FILES` solo se puede utilizar dentro del ámbito de la `codebuild-tests-run` CLI.  
Además, si utiliza `CODEBUILD_CURRENT_SHARD_FILES` dentro de test-command, escriba `CODEBUILD_CURRENT_SHARD_FILES` entre comillas dobles como se muestra en el ejemplo anterior.