

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Usa il comando `codebuild-tests-run` CLI
<a name="parallel-test-tests-run"></a>

AWS CodeBuild fornisce una CLI che prenderà come input il comando di test e la posizione del file di test. La CLI con questi input suddividerà i test in un numero di frammenti come specificato nel `parallelism` campo in base ai nomi dei file di test. L'assegnazione dei file di test agli shard viene decisa dalla strategia di sharding.

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

La tabella seguente descrive i campi per il comando `codebuild-tests-run` CLI.


| Nome del campo | Tipo | Obbligatorio o facoltativo | Definizione | 
| --- | --- | --- | --- | 
|  `test-command`  |  Stringa  |  Richiesto  |  Questo comando viene utilizzato per eseguire i test.  | 
|  `files-search`  |  Stringa  |  Richiesto  |  Questo comando fornisce un elenco di file di test. Puoi utilizzare il comando [codebuild-glob-search](parallel-test-glob-search.md)CLI AWS CodeBuild fornito o qualsiasi altro strumento di ricerca di file a tua scelta.  Assicurati che il `files-search` comando restituisca i nomi dei file, ciascuno separato da una nuova riga.   | 
|  `sharding-strategy`  |  Enum  |  Facoltativo  |  Valori validi: `equal-distribution` (valore predefinito), `stability` [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/codebuild/latest/userguide/parallel-test-tests-run.html) Per ulteriori informazioni, consulta [Informazioni sulla suddivisione dei test](parallel-test-splitting.md).  | 

La `codebuild-tests-run` CLI funziona innanzitutto per identificare l'elenco dei file di test utilizzando il comando fornito nel `files-search` parametro. Quindi determina un sottoinsieme di file di test designati per lo shard (ambiente) corrente utilizzando la strategia di sharding specificata. Infine, questo sottoinsieme di file di test viene formattato in un elenco separato da spazi e aggiunto alla fine del comando fornito nel parametro prima di essere eseguito. `test-command`

Per i framework di test che non accettano elenchi separati da spazi, la `codebuild-tests-run` CLI fornisce un'alternativa flessibile tramite la variabile di ambiente. `CODEBUILD_CURRENT_SHARD_FILES` Questa variabile contiene un elenco separato da nuova riga di percorsi di file di test designati per lo shard di build corrente. Sfruttando questa variabile di ambiente, puoi adattarti facilmente a vari requisiti del framework di test, soddisfacendo quelli che prevedono formati di input diversi dagli elenchi separati da spazi. Inoltre, puoi anche formattare i nomi dei file di test in base alle esigenze del framework di test. Di seguito è riportato un esempio dell'utilizzo di `CODEBUILD_CURRENT_SHARD_FILES` su Linux con il framework Django. Qui `CODEBUILD_CURRENT_SHARD_FILES` viene utilizzato per ottenere i percorsi dei file *con notazione a punti* supportati da 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**  
Nota che la variabile di `CODEBUILD_CURRENT_SHARD_FILES` ambiente può essere utilizzata solo all'interno dell'ambito della `codebuild-tests-run` CLI.  
Inoltre, se stai usando `CODEBUILD_CURRENT_SHARD_FILES` inside test-command, inserisci `CODEBUILD_CURRENT_SHARD_FILES` tra virgolette doppie come mostrato nell'esempio precedente.