Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md).
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à.
# Creazione con flussi di lavoro
Utilizzando [CodeCatalyst i flussi di lavoro](workflow.md), puoi creare applicazioni e altre risorse.
**Topics**
+ [Come posso creare un'applicazione?](#build-how-to)
+ [Vantaggi dell'azione di compilazione](#build-benefits)
+ [Alternative all'azione di compilazione](#build-alternatives)
+ [Aggiungere l'azione di compilazione](build-add-action.md)
+ [Visualizzazione dei risultati di un'azione di compilazione](build-view-results.md)
+ [Tutorial: caricare artefatti su Amazon S3](build-deploy.md)
+ [Crea e testa azioni YAML](build-action-ref.md)
## Come posso creare un'applicazione?
Per creare un'applicazione o una risorsa CodeCatalyst, devi prima creare un flusso di lavoro, quindi specificare un'azione di compilazione al suo interno.
Un'azione di *compilazione* è un elemento costitutivo del flusso di lavoro che compila il codice sorgente, esegue test unitari e produce artefatti pronti per la distribuzione.
Puoi aggiungere un'azione di compilazione al tuo flusso di lavoro utilizzando l'editor visivo o l'editor YAML della CodeCatalyst console.
I passaggi di alto livello per creare un'applicazione o una risorsa sono i seguenti.
**Per creare un'applicazione (attività di alto livello)**
1. In CodeCatalyst, **aggiungi il codice sorgente** per un'applicazione che desideri creare. Per ulteriori informazioni, consulta [Memorizzazione del codice sorgente nei repository per un progetto in CodeCatalyst](source-repositories.md).
1. Nel CodeCatalyst, **crei un flusso di lavoro**. Il flusso di lavoro è il luogo in cui si definisce come creare, testare e distribuire l'applicazione. Per ulteriori informazioni, consulta [Guida introduttiva ai flussi di lavoro](workflows-getting-started.md).
1. (Facoltativo) Nel flusso di lavoro, **aggiungete un trigger** che indica gli eventi che causeranno l'avvio automatico del flusso di lavoro. Per ulteriori informazioni, consulta [L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger](workflows-add-trigger.md)
1. Nel flusso di lavoro, aggiungi un'azione di **compilazione** che compila e impacchetta il codice sorgente dell'applicazione o della risorsa. Facoltativamente, puoi anche fare in modo che l'azione di compilazione esegua test unitari, generi report e distribuisca l'applicazione se non desideri utilizzare un'azione di test o di distribuzione per questi scopi. Per ulteriori informazioni sulle azioni di test e distribuzione, consulta. [Aggiungere l'azione di compilazione](build-add-action.md)
1. (Facoltativo) Nel flusso di lavoro, **aggiungi un'azione di test** e un'**azione di distribuzione** per testare e distribuire l'applicazione o la risorsa. Puoi scegliere tra diverse azioni preconfigurate per distribuire la tua applicazione su destinazioni diverse, come Amazon ECS. Per ulteriori informazioni, consultare [Test con flussi di lavoroTest con flussi di lavoro](test-workflow-actions.md) e [Implementazione con flussi di lavoroImplementazione con flussi di lavoro](deploy.md).
1. **Il flusso di lavoro viene avviato** manualmente o automaticamente tramite un trigger. Il flusso di lavoro esegue le azioni di compilazione, test e distribuzione in sequenza per creare, testare e distribuire l'applicazione e le risorse sulla destinazione. Per ulteriori informazioni, consulta [Avvio manuale dell’esecuzione di un flusso di lavoro](workflows-manually-start.md).
## Vantaggi dell'azione di compilazione
L'utilizzo dell'azione di compilazione all'interno di un flusso di lavoro offre i seguenti vantaggi:
+ **Completamente gestito**: l'azione di compilazione elimina la necessità di configurare, applicare patch, aggiornare e gestire i propri server di build.
+ **Su richiesta**: l'azione di compilazione è scalabile su richiesta per soddisfare le tue esigenze di compilazione. Paghi soltanto per il tempo di compilazione utilizzato. Per ulteriori informazioni, consulta [Configurazione delle immagini di calcolo e di runtime](workflows-working-compute.md).
+ Pronto **all'uso**: CodeCatalyst include immagini Docker preconfezionate in ambiente di runtime che vengono utilizzate per eseguire tutte le azioni del flusso di lavoro, comprese le azioni di compilazione. Queste immagini sono preconfigurate con strumenti utili per la creazione di applicazioni come e Node.js. AWS CLI È possibile CodeCatalyst configurare l'utilizzo di un'immagine di build fornita da un registro pubblico o privato. Per ulteriori informazioni, consulta [Specificazione delle immagini dell'ambiente di runtime](build-images.md).
## Alternative all'azione di compilazione
Se utilizzi un'azione di compilazione per distribuire la tua applicazione, prendi in considerazione invece l'utilizzo di un'*azione di CodeCatalyst distribuzione.* Deploy Actions Esegui una behind-the-scenes configurazione che altrimenti dovresti scrivere manualmente se utilizzi un'azione di compilazione. Per ulteriori informazioni sulle azioni di distribuzione disponibili, consulta. [Elenco delle azioni di distribuzione](deploy.md#deploy-concepts-action-supported)
Puoi anche utilizzarlo AWS CodeBuild per creare le tue applicazioni. Per ulteriori informazioni, consulta la pagina [Che cos'è CodeBuild?](https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html)
# Aggiungere l'azione di compilazione
Utilizza la procedura seguente per aggiungere un'azione di compilazione al tuo CodeCatalyst flusso di lavoro.
------
#### [ Visual ]
**Per aggiungere un'azione di compilazione utilizzando l'editor visuale**
1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/).
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegli **Modifica**.
1. Scegli **Visual**.
1. Scegli **Azioni**.
1. In **Azioni**, scegli **Costruisci**.
1. Nelle schede **Input** e **Configurazione**, completa i campi in base alle tue esigenze. Per una descrizione di ogni campo, consulta. [Crea e testa azioni YAML](build-action-ref.md) Questo riferimento fornisce informazioni dettagliate su ogni campo (e sul valore della proprietà YAML corrispondente) così come appaiono sia nell'editor YAML che in quello visivo.
1. (Facoltativo) Scegliete **Convalida per convalidare il codice YAML** del flusso di lavoro prima di eseguire il commit.
1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.**
------
#### [ YAML ]
**Per aggiungere un'azione di compilazione utilizzando l'editor YAML**
1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. Scegli **Modifica**.
1. Scegli **YAML**.
1. Scegli **Azioni**.
1. **In **Azioni**, scegli Costruisci.**
1. Modifica le proprietà nel codice YAML in base alle tue esigenze. Una spiegazione di ogni proprietà disponibile è fornita in. [Crea e testa azioni YAML](build-action-ref.md)
1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit.
1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.**
------
## Crea la definizione dell'azione
L'azione di compilazione è definita come un insieme di proprietà YAML all'interno del file di definizione del flusso di lavoro. Per informazioni su queste proprietà, [Crea e testa azioni YAML](build-action-ref.md) consulta. [Definizione YAML del flusso di lavoro](workflow-reference.md)
# Visualizzazione dei risultati di un'azione di compilazione
Utilizza le seguenti istruzioni per visualizzare i risultati di un'azione di compilazione, inclusi i log, i report e le variabili generati.
**Per visualizzare i risultati di un'azione di compilazione**
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.
1. **Nel diagramma del flusso di lavoro, scegli il nome dell'azione di creazione, ad esempio Crea.**
1. **Per visualizzare i log per l'esecuzione della build, scegli Logs.** Vengono visualizzati i log delle varie fasi di compilazione. È possibile espandere o comprimere i registri in base alle esigenze.
1. Per visualizzare i report di test prodotti dall'azione di compilazione, scegli **Report** o nel riquadro di navigazione scegli **Report**. Per ulteriori informazioni, consulta [Tipi di report sulla qualità](test-workflow-actions.md#test-reporting).
1. Per visualizzare la configurazione utilizzata per l'azione di compilazione, scegli **Configurazione**. Per ulteriori informazioni, consulta [Aggiungere l'azione di compilazione](build-add-action.md).
1. Per visualizzare le variabili utilizzate dall'azione di compilazione, scegliete **Variabili**. Per ulteriori informazioni, consulta [Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).
# Tutorial: caricare artefatti su Amazon S3
[In questo tutorial, imparerai come caricare artefatti in un bucket Amazon S3 utilizzando un flusso di lavoro CodeCatalyst [Amazon che include un paio](workflows-concepts.md#workflows-concepts-workflows) di azioni di compilazione.](workflows-concepts.md#workflows-concepts-actions) Queste azioni vengono eseguite in serie all'avvio del flusso di lavoro. La prima azione di compilazione genera due file `Hello.txt` e `Goodbye.txt` li raggruppa in un elemento di compilazione. La seconda azione di compilazione carica l'artefatto su Amazon S3. Configurerai il flusso di lavoro in modo che venga eseguito ogni volta che invii un commit al tuo repository di origine.
**Topics**
+ [Prerequisiti](#build-deploy-tut-prereqs)
+ [Fase 1: Creare un AWS ruolo](#build-deploy-tut-role)
+ [Fase 2: creare un bucket Amazon S3](#build-deploy-tut-artifact)
+ [Fase 3: Creare un archivio di sorgenti](#deploy-tut-lambda-cfn-source)
+ [Fase 4: Creare un flusso di lavoro](#build-deploy-tut-workflow.title)
+ [Passaggio 5: verifica i risultati](#build-deploy.s3.verify)
+ [Eliminazione](#deploy-tut-lambda-cfn-clean-up)
## Prerequisiti
Prima di iniziare, avrai bisogno di:
+ È necessario uno CodeCatalyst **spazio** con un AWS account connesso. Per ulteriori informazioni, consulta [Creazione di uno spazio](spaces-create.md).
+ Nel tuo spazio, hai bisogno di un progetto vuoto chiamato:
```
codecatalyst-artifact-project
```
Usa l'opzione **Inizia da zero** per creare questo progetto.
Per ulteriori informazioni, consulta [Creare un progetto vuoto in Amazon CodeCatalyst](projects-create.md#projects-create-empty).
+ Nel tuo progetto, hai bisogno di un CodeCatalyst **ambiente** chiamato:
```
codecatalyst-artifact-environment
```
Configura questo ambiente come segue:
+ Scegli qualsiasi tipo, ad esempio **Development**.
+ Connect il tuo AWS account.
+ Per il **ruolo IAM predefinito**, scegli un ruolo qualsiasi. Specificherai un ruolo diverso in seguito.
Per ulteriori informazioni, consulta [Implementazione in e Account AWS VPCs](deploy-environments.md).
## Fase 1: Creare un AWS ruolo
In questo passaggio, crei un ruolo AWS IAM che successivamente assegnerai all'azione di compilazione nel tuo flusso di lavoro. Questo ruolo concede all'azione di CodeCatalyst compilazione l'autorizzazione ad accedere al tuo AWS account e scrivere su Amazon S3 dove verrà archiviato il tuo artefatto. **Il ruolo è chiamato ruolo Build.**
**Nota**
Se hai già un ruolo di costruzione che hai creato per un altro tutorial, puoi utilizzarlo anche per questo tutorial. Assicurati solo che disponga delle autorizzazioni e della politica di fiducia mostrate nella procedura seguente.
Per ulteriori informazioni sui ruoli IAM, consulta i [ruoli IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) nella *Guida per l'AWS AWS Identity and Access Management utente*.
**Per creare un ruolo di costruzione**
1. Crea una politica per il ruolo, come segue:
1. Accedi a AWS.
1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel riquadro di navigazione, scegli **Policy**.
1. Scegli **Create Policy** (Crea policy).
1. Scegliere la scheda **JSON**.
1. Eliminare il codice esistente.
1. Incolla il codice seguente:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:ListBucket"
],
"Resource": "*"
}
]
}
```
------
**Nota**
La prima volta che il ruolo viene utilizzato per eseguire azioni del flusso di lavoro, utilizza il carattere jolly nell'informativa sulla politica delle risorse, quindi definisci la politica inserendo il nome della risorsa dopo che è disponibile.
```
"Resource": "*"
```
1. Scegliere **Next: Tags (Successivo: Tag)**.
1. Scegliere **Next:Review (Successivo: Rivedi)**.
1. In **Nome**, inserisci:
```
codecatalyst-s3-build-policy
```
1. Scegli **Crea policy**.
Ora hai creato una politica di autorizzazioni.
1. Crea il ruolo di costruzione, come segue:
1. Nel pannello di navigazione, scegli **Ruoli** e quindi **Crea ruolo**.
1. Scegli una **politica di fiducia personalizzata**.
1. Elimina la politica di fiducia personalizzata esistente.
1. Aggiungi la seguente politica di fiducia personalizzata:
1. Scegli **Next (Successivo)**.
1. Nelle **politiche di autorizzazione**, cerca `codecatalyst-s3-build-policy` e seleziona la relativa casella di controllo.
1. Scegli **Next (Successivo)**.
1. Per il **nome del ruolo**, inserisci:
```
codecatalyst-s3-build-role
```
1. Per la **descrizione del ruolo**, inserisci:
```
CodeCatalyst build role
```
1. Scegli **Crea ruolo**.
Ora hai creato un ruolo di sviluppo con una politica di fiducia e una politica di autorizzazioni.
## Fase 2: creare un bucket Amazon S3
In questo passaggio, crei un bucket Amazon S3 in cui verranno caricati gli elementi `Hello.txt` e gli `Goodbye.txt` artefatti.
**Come creare un bucket Amazon S3.**
1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro principale, scegli **Crea bucket**.
1. Per il **nome del bucket, inserisci**:
```
codecatalyst-artifact-bucket
```
1. In **AWS Region (Regione)**, scegliere una Regione. Questo tutorial presuppone che tu abbia scelto **US West (Oregon) us-west-2**. Per informazioni sulle regioni supportate da Amazon S3, consulta gli [endpoint e le quote di Amazon Simple Storage Service](https://docs.aws.amazon.com/general/latest/gr/s3.html) nel. *Riferimenti generali di AWS*
1. **Nella parte inferiore della pagina, scegli Crea bucket.**
1. Copia il nome del bucket che hai appena creato, ad esempio:
```
codecatalyst-artifact-bucket
```
Ora hai creato un bucket chiamato **codecatalyst-artifact-bucket** nella regione us-west-2 degli Stati Uniti occidentali (Oregon).
## Fase 3: Creare un archivio di sorgenti
In questo passaggio, creerai un repository di origine in. CodeCatalyst Questo repository viene utilizzato per archiviare il file di definizione del flusso di lavoro del tutorial.
Per ulteriori informazioni sugli archivi di origine, vedere. [Creazione di un repository di sorgenti](source-repositories-create.md)
**Per creare un archivio dei sorgenti**
1. Apri la CodeCatalyst console all'indirizzo [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vai al tuo progetto,`codecatalyst-artifact-project`.
1. Nel riquadro di navigazione, scegli **Codice**, quindi scegli **Archivi di origine.**
1. Scegli **Aggiungi repository**, quindi scegli **Crea** repository.
1. Nel **nome del repository, inserisci:**
```
codecatalyst-artifact-source-repository
```
1. Scegli **Create** (Crea).
Ora hai creato un repository chiamato. `codecatalyst-artifact-source-repository`
## Fase 4: Creare un flusso di lavoro
In questo passaggio, crei un flusso di lavoro costituito dai seguenti elementi costitutivi eseguiti in sequenza:
+ Un trigger: questo trigger avvia l'esecuzione automatica del flusso di lavoro quando si invia una modifica all'archivio di origine. Per ulteriori informazioni sui trigger, consulta. [L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger](workflows-add-trigger.md)
+ Un'azione di compilazione chiamata`GenerateFiles`: al momento del trigger, l'`GenerateFiles`azione crea due file `Hello.txt` e `Goodbye.txt` li impacchetta in un elemento di output chiamato. `codecatalystArtifact`
+ Un'altra azione di compilazione chiamata`Upload`: al termine dell'`GenerateFiles`azione, l'`Upload`azione esegue il AWS CLI comando `aws s3 sync` per caricare i file nel `codecatalystArtifact` e nel repository di origine nel bucket Amazon S3. AWS CLI Viene fornito preinstallato e preconfigurato sulla piattaforma di CodeCatalyst elaborazione, quindi non è necessario installarlo o configurarlo.
Per ulteriori informazioni sul software preconfezionato sulla piattaforma di elaborazione, consulta CodeCatalyst . [Specificazione delle immagini dell'ambiente di runtime](build-images.md) *Per ulteriori informazioni sul `aws s3 sync` comando AWS CLI's, consulta [sync](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) nel Command Reference.AWS CLI *
Per ulteriori informazioni sull'azione di compilazione, consulta[Creazione con flussi di lavoro](build-workflow-actions.md).
**Come creare un flusso di lavoro**
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. **Scegli Crea flusso di lavoro.**
1. Elimina il codice di esempio YAML.
1. Aggiungi il seguente codice YAML:
**Nota**
Nel codice YAML che segue, puoi omettere la sezione se lo `Connections:` desideri. Se ometti questa sezione, devi assicurarti che il ruolo specificato nel campo **Default IAM role** nel tuo ambiente includa le autorizzazioni e le politiche di fiducia descritte in. [Fase 1: Creare un AWS ruolo](#build-deploy-tut-role) Per ulteriori informazioni sulla configurazione di un ambiente con un ruolo IAM predefinito, consulta. [Creazione di un ambiente](deploy-environments-creating-environment.md)
```
Name: codecatalyst-artifact-workflow
SchemaVersion: 1.0
Triggers:
- Type: Push
Branches:
- main
Actions:
GenerateFiles:
Identifier: aws/build@v1
Configuration:
Steps:
# Create the output files.
- Run: echo "Hello, World!" > "Hello.txt"
- Run: echo "Goodbye!" > "Goodbye.txt"
Outputs:
Artifacts:
- Name: codecatalystArtifact
Files:
- "**/*"
Upload:
Identifier: aws/build@v1
DependsOn:
- GenerateFiles
Environment:
Name: codecatalyst-artifact-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-s3-build-role
Inputs:
Artifacts:
- codecatalystArtifact
Configuration:
Steps:
# Upload the output artifact to the S3 bucket.
- Run: aws s3 sync . s3://codecatalyst-artifact-bucket
```
Nel codice precedente, sostituisci:
+ *codecatalyst-artifact-environment*con il nome dell'ambiente in cui hai creato[Prerequisiti](#build-deploy-tut-prereqs).
+ *codecatalyst-account-connection*con il nome della connessione all'account in cui hai creato[Prerequisiti](#build-deploy-tut-prereqs).
+ *codecatalyst-s3-build-role*con il nome del ruolo di build in cui hai creato[Fase 1: Creare un AWS ruolo](#build-deploy-tut-role).
+ *codecatalyst-artifact-bucket*con il nome dell'Amazon S3 in cui hai creato. [Fase 2: creare un bucket Amazon S3](#build-deploy-tut-artifact)
Per informazioni sulle proprietà di questo file, consulta[Crea e testa azioni YAML](build-action-ref.md).
1. (Facoltativo) Scegliete **Convalida** per assicurarvi che il codice YAML sia valido prima di eseguire il commit.
1. Scegli **Applica**.
1. Nella finestra di dialogo **Conferma flusso di lavoro**, inserisci quanto segue:
1. Per il **nome del file Workflow**, lasciate il valore predefinito,`codecatalyst-artifact-workflow`.
1. Per il **messaggio** di conferma, inserisci:
```
add initial workflow file
```
1. Per **Repository**, scegli **codecatalyst-artifact-source-repository**.
1. Per il **nome del ramo**, scegli **principale**.
1. Scegli **Applica**.
Ora hai creato un flusso di lavoro. L'esecuzione di un flusso di lavoro viene avviata automaticamente a causa del trigger definito nella parte superiore del flusso di lavoro. In particolare, quando hai eseguito il commit (e inviato) del `codecatalyst-artifact-workflow.yaml` file nell'archivio di origine, il trigger ha avviato l'esecuzione del flusso di lavoro.
**Per visualizzare il flusso di lavoro in corso**
1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**
1. Scegli il flusso di lavoro che hai appena creato:. `codecatalyst-artifact-workflow`
1. Scegli **GenerateFiles**di vedere lo stato di avanzamento della prima azione di costruzione.
1. Scegli **Carica** per vedere lo stato di avanzamento della seconda azione di build.
1. Al termine dell'azione di **caricamento**, procedi come segue:
+ Se l'esecuzione del flusso di lavoro è riuscita, passate alla procedura successiva.
+ Se l'esecuzione del flusso di lavoro non è riuscita, scegli **Registri** per risolvere il problema.
## Passaggio 5: verifica i risultati
Dopo l'esecuzione del flusso di lavoro, accedi al servizio Amazon S3 e cerca nel tuo *codecatalyst-artifact-bucket* bucket. Ora dovrebbe includere i seguenti file e cartelle:
```
.
|— .aws/
|— .git/
|Goodbye.txt
|Hello.txt
|REAME.md
```
I `Hello.txt` file `Goodbye.txt` e sono stati caricati perché facevano parte dell'`codecatalystArtifact`artefatto. I `README.md` file `.aws/``.git/`, e sono stati caricati perché erano presenti nel repository di origine.
## Eliminazione
Effettua la pulizia CodeCatalyst ed AWS evita che questi servizi vengano addebitati.
**Per pulire CodeCatalyst**
1. Apri la CodeCatalyst console all'[indirizzo https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Eliminare il repository di `codecatalyst-artifact-source-repository` origine.
1. Eliminare il `codecatalyst-artifact-workflow` flusso di lavoro.
**Per ripulire AWS**
1. Esegui la pulizia in Amazon S3, come segue:
1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Elimina i file nel `codecatalyst-artifact-bucket` bucket.
1. Eliminare il `codecatalyst-artifact-bucket` bucket.
1. Esegui la pulizia in IAM, come segue:
1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Eliminare il `codecatalyst-s3-build-policy`.
1. Eliminare il `codecatalyst-s3-build-role`.
# Crea e testa azioni YAML
Di seguito è riportata la definizione YAML delle azioni di compilazione e test. Esiste un riferimento per due azioni perché le loro proprietà YAML sono molto simili.
Questa definizione di azione esiste come sezione all'interno di un file di definizione del flusso di lavoro più ampio. Per ulteriori informazioni su questo file, consulta [Definizione YAML del flusso di lavoro](workflow-reference.md).
Scegliete una proprietà YAML nel codice seguente per vederne una descrizione.
**Nota**
La maggior parte delle proprietà YAML che seguono hanno elementi dell'interfaccia utente corrispondenti nell'editor visuale. **Per cercare un elemento dell'interfaccia utente, usa Ctrl\$1F.** L'elemento verrà elencato con la proprietà YAML associata.
```
# The workflow definition starts here.
# See Proprietà di primo livello for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
action-name:
Identifier: aws/build@v1 | aws/managed-test@v1
DependsOn:
- dependent-action-name-1
Compute:
Type: EC2 | Lambda
Fleet: fleet-name
Timeout: timeout-minutes
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: iam-role-name
Caching:
FileCaching:
key-name-1:
Path: file1.txt
RestoreKeys:
- restore-key-1
Inputs:
Sources:
- source-name-1
- source-name-2
Artifacts:
- artifact-name
Variables:
- Name: variable-name-1
Value: variable-value-1
- Name: variable-name-2
Value: variable-value-2
Outputs:
Artifacts:
- Name: output-artifact-1
Files:
- build-output/artifact-1.jar
- "build-output/build*"
- Name: output-artifact-2
Files:
- build-output/artifact-2.1.jar
- build-output/artifact-2.2.jar
Variables:
- variable-name-1
- variable-name-2
AutoDiscoverReports:
Enabled: true | false
ReportNamePrefix: AutoDiscovered
IncludePaths:
- "**/*"
ExcludePaths:
- node_modules/cdk/junit.xml
SuccessCriteria:
PassRate: percent
LineCoverage: percent
BranchCoverage: percent
Vulnerabilities:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisBug:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisSecurity:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisQuality:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisFinding:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
Reports:
report-name-1:
Format: format
IncludePaths:
- "*.xml"
ExcludePaths:
- report2.xml
- report3.xml
SuccessCriteria:
PassRate: percent
LineCoverage: percent
BranchCoverage: percent
Vulnerabilities:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisBug:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisSecurity:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisQuality:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisFinding:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
Configuration:
Container:
Registry: registry
Image: image
Steps:
- Run: "step 1"
- Run: "step 2"
Packages:
NpmConfiguration:
PackageRegistries:
- PackagesRepository: package-repository
Scopes:
- "@scope"
ExportAuthorizationToken: true | false
```
## nome dell'azione
(Obbligatorio)
Specificare il nome dell'azione. Tutti i nomi delle azioni devono essere univoci all'interno del flusso di lavoro. I nomi delle azioni sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9), trattini (-) e caratteri di sottolineatura (\$1). Gli spazi non sono consentiti. Non è possibile utilizzare le virgolette per abilitare caratteri e spazi speciali nei nomi delle azioni.
**Interfaccia utente corrispondente: scheda di configurazione/nome dell'azione**
## Identifier
(*action-name*/**Identifier**)
Identifica l'azione. Non modificate questa proprietà a meno che non vogliate cambiare la versione. Per ulteriori informazioni, consulta [Specificare la versione dell'azione da utilizzare](workflows-action-versions.md).
Da utilizzare `aws/build@v1` per le azioni di compilazione.
Utilizzare `aws/managed-test@v1` per azioni di test.
Interfaccia utente corrispondente: diagramma *aws/build@v1\$1aws/managed-test@v1* del workflow, nome dell'azione, etichetta
## DependsOn
(*action-name*/**DependsOn**)
(Facoltativo)
Specificate un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente per l'esecuzione di questa azione.
Per ulteriori informazioni sulla funzionalità «dipende da», vedere. [Azioni di sequenziamento](workflows-depends-on.md)
**Interfaccia utente corrispondente: scheda Ingressi/Dipende da - opzionale**
## Compute
(*action-name*/**Compute**)
(Facoltativo)
Il motore di calcolo utilizzato per eseguire le azioni del flusso di lavoro. È possibile specificare l'elaborazione a livello di flusso di lavoro o a livello di azione, ma non entrambi. Se specificata a livello di flusso di lavoro, la configurazione di calcolo si applica a tutte le azioni definite nel flusso di lavoro. A livello di flusso di lavoro, puoi anche eseguire più azioni sulla stessa istanza. Per ulteriori informazioni, consulta [Condivisione dell'elaborazione tra le azioni](compute-sharing.md).
Interfaccia utente corrispondente: *nessuna*
## Type
(*action-name*/Compute/**Tipo**)
(Obbligatorio se [Compute](#build.computename) incluso)
Il tipo di motore di calcolo. È possibile utilizzare uno dei seguenti valori:
+ **EC2** (editor visuale) o `EC2` (editor YAML)
Ottimizzato per la flessibilità durante le operazioni.
+ **Lambda** (editor visivo) o `Lambda` (editor YAML)
Velocità di avvio delle azioni ottimizzate.
Per ulteriori informazioni sui tipi di calcolo, consulta [Tipi di calcolo](workflows-working-compute.md#compute.types).
**Interfaccia utente corrispondente: scheda di configurazione/tipo di calcolo**
## Fleet
(*action-name*/Compute/**Fleet**)
(Facoltativo)
Specificate la macchina o il parco macchine che eseguiranno il flusso di lavoro o le azioni del flusso di lavoro. Con le flotte on-demand, all'avvio di un'azione, il flusso di lavoro fornisce le risorse necessarie e le macchine vengono distrutte al termine dell'azione. Esempi di flotte on-demand:,. `Linux.x86-64.Large` `Linux.x86-64.XLarge` Per ulteriori informazioni sulle flotte on-demand, vedere. [Proprietà del parco istanze on demand](workflows-working-compute.md#compute.on-demand)
Con le flotte assegnate, puoi configurare una serie di macchine dedicate per eseguire le azioni del flusso di lavoro. Queste macchine rimangono inattive, pronte a elaborare immediatamente le azioni. Per ulteriori informazioni sulle flotte rifornite, vedere. [Proprietà del parco istanze con provisioning](workflows-working-compute.md#compute.provisioned-fleets)
Se `Fleet` viene omesso, l'impostazione predefinita è. `Linux.x86-64.Large`
**Interfaccia utente corrispondente: scheda di configurazione/parco di calcolo**
## Timeout
(*action-name*/**Timeout**)
(Facoltativo)
Specificate il periodo di tempo, in minuti (editor YAML) o ore e minuti (editor visivo), che l'azione può essere eseguita prima CodeCatalyst che termini l'azione. Il minimo è 5 minuti e il massimo è descritto in. [Quote per i flussi di lavoro in CodeCatalyst](workflows-quotas.md) Il timeout predefinito è lo stesso del timeout massimo.
**Interfaccia utente corrispondente: scheda di configurazione/timeout - opzionale**
## Environment
(*action-name*/**Environment**)
(Facoltativo)
Specificare l' CodeCatalyst ambiente da utilizzare con l'azione. L'azione si connette Account AWS all'Amazon VPC opzionale specificato nell'ambiente scelto. L'azione utilizza il ruolo IAM predefinito specificato nell'ambiente per connettersi a e utilizza il ruolo IAM specificato nella [connessione Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) per connettersi ad Amazon VPC. Account AWS
**Nota**
Se il ruolo IAM predefinito non dispone delle autorizzazioni richieste dall'azione, puoi configurare l'azione per utilizzare un ruolo diverso. Per ulteriori informazioni, consulta [Modifica del ruolo IAM di un'azione](deploy-environments-switch-role.md).
Per ulteriori informazioni sugli ambienti, consulta [Implementazione in e Account AWS VPCs](deploy-environments.md) e[Creazione di un ambiente](deploy-environments-creating-environment.md).
**Interfaccia utente corrispondente: scheda di configurazione/ambiente**
## Name
(*action-name*/Environment/**Name**)
(Facoltativo)
Specificate il nome di un ambiente esistente che desiderate associare all'azione.
**Interfaccia utente corrispondente: scheda di configurazione/ambiente**
## Connections
(*action-name*/Environment/**Connections**)
(Facoltativo)
Specificare la connessione dell'account da associare all'azione. È possibile specificare al massimo una connessione a un account in`Environment`.
Se non si specifica una connessione all'account:
+ L'azione utilizza la Account AWS connessione e il ruolo IAM predefinito specificati nell'ambiente della CodeCatalyst console. Per informazioni sull'aggiunta di una connessione all'account e del ruolo IAM predefinito all'ambiente, consulta[Creazione di un ambiente](deploy-environments-creating-environment.md).
+ Il ruolo IAM predefinito deve includere le policy e le autorizzazioni richieste dall'azione. Per determinare quali sono tali politiche e autorizzazioni, consulta la descrizione della proprietà **Role nella documentazione** sulla definizione YAML dell'azione.
Per ulteriori informazioni sulle connessioni degli account, vedere. [Consentire l'accesso alle AWS risorse con connessione Account AWS](ipa-connect-account.md) Per informazioni sull'aggiunta di una connessione tramite account a un ambiente, vedere[Creazione di un ambiente](deploy-environments-creating-environment.md).
Interfaccia utente corrispondente: tab/Environment/What la configurazione è attiva*my-environment*? **/menu a tre punti/ Cambia ruolo**
## Name
(*action-name*/Environment/Connections/**Name**)
(Obbligatorio se incluso[Connections](#build.environment.connections))
Specificare il nome della connessione all'account.
Interfaccia utente corrispondente: tab/Environment/What la configurazione è attiva*my-environment*? **/menu a tre punti/ Cambia ruolo**
## Role
(*action-name*/Environment/Connections/**Role**)
(Obbligatorio se incluso[Connections](#build.environment.connections))
Specificate il nome del ruolo IAM utilizzato da questa azione per accedere e operare in AWS servizi come Amazon S3 e Amazon ECR. Assicurati che questo ruolo venga aggiunto alla tua Account AWS connessione nel tuo spazio. Per aggiungere un ruolo IAM alla connessione di un account, consulta[Aggiunta di ruoli IAM alle connessioni degli account](ipa-connect-account-addroles.md).
Se non specifichi un ruolo IAM, l'azione utilizza il ruolo IAM predefinito elencato nell'[ambiente](deploy-environments.md) nella CodeCatalyst console. Se utilizzi il ruolo predefinito nell'ambiente, assicurati che abbia le seguenti politiche.
**Nota**
Puoi usare il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo con questa azione. Per ulteriori informazioni su questo ruolo, consulta [Creazione del **CodeCatalystWorkflowDevelopmentRole-*spaceName***ruolo per il tuo account e il tuo spazio](ipa-iam-roles.md#ipa-iam-roles-service-create). Tieni presente che il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo dispone di autorizzazioni di accesso complete, il che può rappresentare un rischio per la sicurezza. Ti consigliamo di utilizzare questo ruolo solo in tutorial e scenari in cui la sicurezza è meno preoccupante.
**avvertimento**
Limita le autorizzazioni a quelle richieste dalle azioni di compilazione e test. L'utilizzo di un ruolo con autorizzazioni più ampie potrebbe rappresentare un rischio per la sicurezza.
Interfaccia utente corrispondente: la configurazione tab/Environment/What è attiva? *my-environment* **/menu a tre punti/ Cambia ruolo**
## Caching
(*action-name*/**Caching**)
(Facoltativo)
Una sezione in cui è possibile specificare una cache per salvare i file su disco e ripristinarli da tale cache nelle successive esecuzioni del flusso di lavoro.
Per ulteriori informazioni sulla memorizzazione nella cache dei file, vedere. [Memorizzazione nella cache dei file tra le esecuzioni del workflow](workflows-caching.md)
Interfaccia utente corrispondente: scheda di configurazione/memorizzazione nella **cache dei file - opzionale**
## FileCaching
(*action-name*/Caching/**FileCaching**)
(Facoltativo)
Una sezione che specifica la configurazione per una sequenza di cache.
**Interfaccia utente corrispondente: memorizzazione nella tab/File cache della configurazione - facoltativa/Aggiungi cache**
## nome-chiave 1
(*action-name*/Caching/FileCaching/***key-name-1***)
(Facoltativo)
Specificate il nome della proprietà della cache principale. I nomi delle proprietà della cache devono essere univoci all'interno del flusso di lavoro. Per ogni azione possono essere inserite fino a cinque voci`FileCaching`.
**Interfaccia utente corrispondente: tab/File memorizzazione nella cache della configurazione - Opzionale/Aggiungi cache/ Chiave**
## Path
(*action-name*/Caching/FileCaching/*key-name-1*/**Path**)
(Facoltativo)
Specificate il percorso associato per la cache.
**Interfaccia utente corrispondente: tab/File memorizzazione nella cache della configurazione - Opzionale/Aggiungi cache/percorso**
## RestoreKeys
(*action-name*/Caching/FileCaching/*key-name-1*/**RestoreKeys**)
(Facoltativo)
Specificare la chiave di ripristino da utilizzare come riserva quando non è possibile trovare la proprietà della cache principale. I nomi delle chiavi di ripristino devono essere univoci all'interno del flusso di lavoro. Ogni cache può contenere fino a cinque voci`RestoreKeys`.
**Interfaccia utente corrispondente: memorizzazione tab/File nella cache della configurazione - Opzionale/Aggiungi cache/chiavi di ripristino - opzionale**
## Inputs
(*action-name*/**Inputs**)
(Facoltativo)
La `Inputs` sezione definisce i dati necessari a un'azione durante l'esecuzione di un flusso di lavoro.
**Nota**
Sono consentiti un massimo di quattro input (una fonte e tre artefatti) per azione di compilazione o azione di test. Le variabili non vengono conteggiate per questo totale.
Se è necessario fare riferimento a file che risiedono in input diversi (ad esempio una sorgente e un artefatto), l'input di origine è l'input principale e l'artefatto è l'input secondario. I riferimenti ai file negli input secondari richiedono un prefisso speciale per distinguerli dal primario. Per informazioni dettagliate, vedi [Esempio: riferimento a file in più artefatti](workflows-working-artifacts-ex.md#workflows-working-artifacts-ex-ref-file).
**Interfaccia utente corrispondente: scheda Ingressi**
## Sources
(*action-name*/Inputs/**Sources**)
(Facoltativo)
Specificate le etichette che rappresentano i repository di origine che saranno necessari all'azione. Attualmente, l'unica etichetta supportata è`WorkflowSource`, che rappresenta l'archivio di origine in cui è archiviato il file di definizione del flusso di lavoro.
Se si omette una fonte, è necessario specificare almeno un elemento di input in. `action-name/Inputs/Artifacts`
Per ulteriori informazioni sulle origini, consulta [Connessione degli archivi di origine ai flussi di lavoro](workflows-sources.md).
*Interfaccia utente corrispondente: nessuna*
## Artifacts - input
(*action-name*/Inputs/**Artifacts**)
(Facoltativo)
Specificate gli artefatti delle azioni precedenti che desiderate fornire come input per questa azione. Questi artefatti devono essere già definiti come artefatti di output nelle azioni precedenti.
Se non si specifica alcun artefatto di input, è necessario specificare almeno un repository di origine in. `action-name/Inputs/Sources`
Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md)
**Nota**
Se l'elenco a discesa **Artifacts - opzionale** non è disponibile (editor visivo) o se si verificano errori durante la convalida di YAML (editor YAML), è possibile che l'azione supporti un solo input. In questo caso, prova a rimuovere l'input sorgente.
Interfaccia utente corrispondente: scheda **Ingressi/Artefatti - opzionale**
## Variables - input
(*action-name*/Inputs/**Variables**)
(Facoltativo)
Specificate una sequenza di name/value coppie che definisca le variabili di input che desiderate rendere disponibili all'azione. I nomi delle variabili sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9), trattini (-) e caratteri di sottolineatura (\$1). Gli spazi non sono consentiti. Non è possibile utilizzare le virgolette per abilitare caratteri e spazi speciali nei nomi delle variabili.
Per ulteriori informazioni sulle variabili, inclusi esempi, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).
Interfaccia utente corrispondente: scheda **Input/Variabili** - opzionale
## Outputs
(*action-name*/**Outputs**)
(Facoltativo)
Definisce i dati emessi dall'azione durante l'esecuzione di un flusso di lavoro.
Interfaccia utente corrispondente: **scheda Output**
## Artifacts - output
(*action-name*/Outputs/**Artifacts**)
(Facoltativo)
Specificate il nome di un artefatto generato dall'azione. I nomi degli Artifact devono essere univoci all'interno di un flusso di lavoro e sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9) e caratteri di sottolineatura (\$1). Spazi, trattini (-) e altri caratteri speciali non sono consentiti. Non è possibile utilizzare le virgolette per abilitare spazi, trattini e altri caratteri speciali nei nomi degli artefatti di output.
Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md)
**Interfaccia utente corrispondente: scheda Outputs/Artifacts**
## Name
(*action-name*/Outputs/Artifacts/**Name**)
(Richiesto se incluso) [Artifacts - output](#build.outputs.artifacts)
Specificate il nome di un artefatto generato dall'azione. I nomi degli Artifact devono essere univoci all'interno di un flusso di lavoro e sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9) e caratteri di sottolineatura (\$1). Spazi, trattini (-) e altri caratteri speciali non sono consentiti. Non è possibile utilizzare le virgolette per abilitare spazi, trattini e altri caratteri speciali nei nomi degli artefatti di output.
Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md)
**Interfaccia utente corrispondente: restituisce il nome dell'output/build dell'tab/Artifacts/Newartefatto**
## Files
(*action-name*/Outputs/Artifacts/**Files**)
(Obbligatorio se incluso) [Artifacts - output](#build.outputs.artifacts)
Specificate i file CodeCatalyst inclusi nell'artefatto generato dall'azione. Questi file vengono generati dall'azione del flusso di lavoro durante l'esecuzione e sono disponibili anche nell'archivio di origine. I percorsi dei file possono risiedere in un repository di origine o in un elemento di un'azione precedente e sono relativi al repository di origine o alla radice dell'elemento. È possibile utilizzare modelli a globo per specificare i percorsi. Esempi:
+ Per specificare un singolo file che si trova nella radice della posizione di creazione o della posizione del repository di origine, usa. `my-file.jar`
+ Per specificare un singolo file in una sottodirectory, usa `directory/my-file.jar` o. `directory/subdirectory/my-file.jar`
+ Per specificare tutti i file, utilizzare`"**/*"`. Il pattern a `**` glob indica che deve corrispondere a un numero qualsiasi di sottodirectory.
+ Per specificare tutti i file e le directory in una directory denominata, usa. `directory` `"directory/**/*"` Il pattern a `**` glob indica che deve corrispondere a un numero qualsiasi di sottodirectory.
+ Per specificare tutti i file in una directory denominata`directory`, ma non nessuna delle sue sottodirectory, usa. `"directory/*"`
**Nota**
Se il percorso del file include uno o più asterischi (`*`) o un altro carattere speciale, racchiudi il percorso tra virgolette doppie (). `""` Per ulteriori informazioni sui caratteri speciali, vedere. [Linee guida e convenzioni sulla sintassi](workflow-reference.md#workflow.terms.syntax.conv)
Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md)
**Nota**
Potrebbe essere necessario aggiungere un prefisso al percorso del file per indicare in quale elemento o fonte trovarlo. Per ulteriori informazioni, consultare [Riferimento ai file del repository di origine](workflows-sources-reference-files.md) e [Riferimento ai file in un artefatto](workflows-working-artifacts-refer-files.md).
**Interfaccia utente corrispondente: output in output/file prodotti tab/Artifacts/New da build**
## Variables - output
(*action-name*/Outputs/**Variables**)
(Facoltativo)
Specificate le variabili che desiderate che l'azione esporti in modo che siano disponibili per l'uso da parte delle azioni successive.
Per ulteriori informazioni sulle variabili, inclusi esempi, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).
**Interfaccia utente corrispondente: scheda Output/Variabili/ Aggiungi variabile**
## nome-variabile-1
(*action-name*/Outputs/Variables/*variable-name-1*)
(Facoltativo)
Specificate il nome di una variabile che desiderate che l'azione esporti. Questa variabile deve essere già definita nella `Steps` sezione `Inputs` o della stessa azione.
Per ulteriori informazioni sulle variabili, inclusi esempi, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).
**Interfaccia utente corrispondente: tab/Variables/Add variabile/nome degli output**
## AutoDiscoverReports
(*action-name*/Outputs/**AutoDiscoverReports**)
(Facoltativo)
Definisce la configurazione per la funzione di individuazione automatica.
Quando abiliti l'individuazione automatica, tutte le CodeCatalyst ricerche `Inputs` passano all'azione e tutti i file generati dall'azione stessa, alla ricerca di report di test, copertura del codice e analisi della composizione del software (SCA). Per ogni report trovato, lo CodeCatalyst trasforma in un report. CodeCatalyst Un *CodeCatalyst report* è un report completamente integrato nel CodeCatalyst servizio e che può essere visualizzato e manipolato tramite la CodeCatalyst console.
**Nota**
Per impostazione predefinita, la funzione di individuazione automatica ispeziona tutti i file. È possibile limitare i file da ispezionare utilizzando le [IncludePaths](#build.reports.includepaths) proprietà o. [ExcludePaths](#build.reports.excludepaths)
**Interfaccia utente corrispondente: scheda Outputs/Rapports/Auto-discover reports**
## Enabled
(*action-name*/Outputs/AutoDiscoverReports/**Enabled**)
(Facoltativo)
Abilita o disabilita la funzione di rilevamento automatico.
I valori validi sono `true` e `false`.
Se `Enabled` viene omesso, l'impostazione predefinita è. `true`
**Interfaccia utente corrispondente: scheda Outputs/Reports/ Auto-discover reports**
## ReportNamePrefix
(*action-name*/Outputs/AutoDiscoverReports/**ReportNamePrefix**)
(Richiesto se è incluso e abilitato) [AutoDiscoverReports](#build.outputs.autodiscover)
Specificate un prefisso che CodeCatalyst precede tutti i report trovati per assegnare un nome ai report associati. CodeCatalyst Ad esempio, se si specifica un prefisso di `AutoDiscovered` e CodeCatalyst rileva automaticamente due rapporti di test `TestSuiteOne.xml` e`TestSuiteTwo.xml`, i CodeCatalyst report associati verranno denominati e. `AutoDiscoveredTestSuiteOne` `AutoDiscoveredTestSuiteTwo`
**Interfaccia utente corrispondente: scheda Outputs/Reports/ Nome del prefisso**
## IncludePaths
(*action-name*/Outputs/AutoDiscoverReports/**IncludePaths**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/**IncludePaths**)
(Richiesto se [AutoDiscoverReports](#build.outputs.autodiscover) è incluso e abilitato o se è incluso) [Reports](#test.configuration.reports)
Specificate i file e i percorsi dei file da CodeCatalyst includere nella ricerca di report non elaborati. Ad esempio, se si specifica`"/test/report/*"`, CodeCatalyst cerca la directory nell'intera [immagine di build](build-images.md) utilizzata dall'azione per cercare la `/test/report/*` directory. Quando trova quella directory, cerca CodeCatalyst i report in quella directory.
**Nota**
Se il percorso del file include uno o più asterischi (`*`) o altri caratteri speciali, racchiudi il percorso tra virgolette doppie (). `""` Per ulteriori informazioni sui caratteri speciali, vedere. [Linee guida e convenzioni sulla sintassi](workflow-reference.md#workflow.terms.syntax.conv)
Se questa proprietà viene omessa, l'impostazione predefinita è`"**/*"`, ovvero la ricerca include tutti i file in tutti i percorsi.
**Nota**
Per i report configurati manualmente, `IncludePaths` deve essere presente uno schema a globo che corrisponda a un singolo file.
Interfaccia utente corrispondente:
+ **Percorsi di tab/Reports/Auto-discover reports/Include/exclude uscita/percorsi di inclusione**
+ **Gli output tab/Reports/Manually configurano i *report-name-1* rapporti/ /include/escludi percorsi/ Includi percorsi**
## ExcludePaths
(*action-name*/Outputs/AutoDiscoverReports/**ExcludePaths**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/**ExcludePaths**)
(Facoltativo)
Specificate i file e i percorsi dei file da escludere durante la ricerca di report non elaborati. CodeCatalyst Ad esempio, se si specifica`"/test/my-reports/**/*"`, non CodeCatalyst cercherà i file nella `/test/my-reports/` directory. Per ignorare tutti i file in una directory, utilizzate il pattern `**/*` glob.
**Nota**
Se il percorso del file include uno o più asterischi (`*`) o altri caratteri speciali, racchiudi il percorso tra virgolette doppie (). `""` Per ulteriori informazioni sui caratteri speciali, vedere. [Linee guida e convenzioni sulla sintassi](workflow-reference.md#workflow.terms.syntax.conv)
Interfaccia utente corrispondente:
+ **Percorsi di tab/Reports/Auto-discover reports/Include/exclude uscita/percorsi di esclusione**
+ **Gli output tab/Reports/Manually configurano i *report-name-1* report/ /include/escludi percorsi/ Escludi percorsi**
## SuccessCriteria
(*action-name*/Outputs/AutoDiscoverReports/**SuccessCriteria**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/**SuccessCriteria**)
(Facoltativo)
Specificate i criteri di successo per i report di test, copertura del codice, analisi della composizione del software (SCA) e analisi statica (SA).
Per ulteriori informazioni, consulta [Configurazione dei criteri di successo per i report](test-config-action.md#test.success-criteria).
**Interfaccia utente corrispondente: scheda Output/Rapporti/Criteri di successo**
## PassRate
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**PassRate**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**PassRate**)
(Facoltativo)
Specificate la percentuale di test da superare in un rapporto di prova affinché il CodeCatalyst rapporto associato venga contrassegnato come superato. I valori validi includono i numeri decimali. Ad esempio, `50`, `60.5`. I criteri relativi alla percentuale di superamento vengono applicati solo ai rapporti di prova. Per ulteriori informazioni sui rapporti di prova, vedere[Rapporti dei test](test-workflow-actions.md#test-reports).
**Interfaccia utente corrispondente: tab/Reports/Success criteri di uscita/velocità di passaggio**
## LineCoverage
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**LineCoverage**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**LineCoverage**)
(Facoltativo)
Specificate la percentuale di righe da coprire in un rapporto sulla copertura del codice affinché il CodeCatalyst rapporto associato venga contrassegnato come superato. I valori validi includono i numeri decimali. Ad esempio, `50`, `60.5`. I criteri di copertura delle linee vengono applicati solo ai report sulla copertura del codice. Per ulteriori informazioni sui rapporti sulla copertura del codice, vedere[Report di copertura del codice](test-workflow-actions.md#test-code-coverage-reports).
**Interfaccia utente corrispondente: tab/Reports/Success criteri di uscita/copertura di linea**
## BranchCoverage
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**BranchCoverage**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**BranchCoverage**)
(Facoltativo)
Specificate la percentuale di filiali in un rapporto sulla copertura del codice che deve essere coperta affinché il CodeCatalyst rapporto associato venga contrassegnato come superato. I valori validi includono i numeri decimali. Ad esempio, `50`, `60.5`. I criteri di copertura delle filiali vengono applicati solo ai report sulla copertura del codice. Per ulteriori informazioni sui rapporti sulla copertura del codice, vedere[Report di copertura del codice](test-workflow-actions.md#test-code-coverage-reports).
**Interfaccia utente corrispondente: tab/Reports/Success criteri di uscita/copertura delle filiali**
## Vulnerabilities
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**Vulnerabilities**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**Vulnerabilities**)
(Facoltativo)
Specificate il numero e la gravità massimi di vulnerabilità consentiti nel rapporto SCA affinché il CodeCatalyst rapporto associato venga contrassegnato come superato. Per specificare le vulnerabilità, è necessario specificare:
+ La gravità minima delle vulnerabilità da includere nel conteggio. I valori validi, dal più grave al meno grave, sono:`CRITICAL`,`HIGH`,, `MEDIUM``LOW`,`INFORMATIONAL`.
Ad esempio, se si sceglie`HIGH`, verranno `HIGH` `CRITICAL` conteggiate tutte le vulnerabilità.
+ Il numero massimo di vulnerabilità della gravità specificata che desideri consentire. Il superamento di questo numero fa sì che il CodeCatalyst rapporto venga contrassegnato come fallito. I valori validi sono numeri interi.
I criteri di vulnerabilità vengono applicati solo ai report SCA. Per ulteriori informazioni sui report SCA, vedere. [Rapporti di analisi della composizione del software](test-workflow-actions.md#test-sca-reports)
Per specificare la severità minima, utilizzare la `Severity` proprietà. Per specificare il numero massimo di vulnerabilità, utilizzare la `Number` proprietà.
**Interfaccia utente corrispondente: tab/Reports/Success criteri di uscita/vulnerabilità**
## StaticAnalysisBug
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**StaticAnalysisBug**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**StaticAnalysisBug**)
(Facoltativo)
Specificate il numero e la gravità massimi di bug consentiti nel rapporto SA affinché il CodeCatalyst rapporto associato venga contrassegnato come superato. Per specificare i bug, è necessario specificare:
+ La gravità minima dei bug da includere nel conteggio. I valori validi, dal più grave al meno grave, sono:`CRITICAL`,`HIGH`,, `MEDIUM``LOW`,`INFORMATIONAL`.
Ad esempio, se scegli`HIGH`, allora `HIGH` i `CRITICAL` bug verranno conteggiati.
+ Il numero massimo di bug della gravità specificata che desideri consentire. Il superamento di questo numero fa sì che il CodeCatalyst rapporto venga contrassegnato come fallito. I valori validi sono numeri interi.
I criteri relativi ai bug vengono applicati solo ai report PyLint e ESLint SA. Per ulteriori informazioni sui report SA, vedere[Rapporti di analisi statica](test-workflow-actions.md#test-static-analysis-reports).
Per specificare la severità minima, utilizzare la `Severity` proprietà. Per specificare il numero massimo di vulnerabilità, utilizzare la `Number` proprietà.
**Interfaccia utente corrispondente: tab/Reports/Success criteri di uscita/bug**
## StaticAnalysisSecurity
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**StaticAnalysisSecurity**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**StaticAnalysisSecurity**)
(Facoltativo)
Specificate il numero e la gravità massimi di vulnerabilità di sicurezza consentite nel rapporto SA affinché il CodeCatalyst rapporto associato venga contrassegnato come superato. Per specificare le vulnerabilità di sicurezza, è necessario specificare:
+ La gravità minima delle vulnerabilità di sicurezza che si desidera includere nel conteggio. I valori validi, dal più grave al meno grave, sono:`CRITICAL`,`HIGH`,, `MEDIUM``LOW`,`INFORMATIONAL`.
Ad esempio, se lo desideri`HIGH`, verranno `HIGH` conteggiate le vulnerabilità di `CRITICAL` sicurezza.
+ Il numero massimo di vulnerabilità di sicurezza della gravità specificata che desideri consentire. Il superamento di questo numero fa sì che il CodeCatalyst rapporto venga contrassegnato come fallito. I valori validi sono numeri interi.
I criteri di vulnerabilità di sicurezza vengono applicati solo ai report PyLint e ESLint SA. Per ulteriori informazioni sui report SA, vedere[Rapporti di analisi statica](test-workflow-actions.md#test-static-analysis-reports).
Per specificare la severità minima, utilizzare la `Severity` proprietà. Per specificare il numero massimo di vulnerabilità, utilizzare la `Number` proprietà.
**Interfaccia utente corrispondente: tab/Reports/Success criteri di uscita/vulnerabilità di sicurezza**
## StaticAnalysisQuality
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**StaticAnalysisQuality**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**StaticAnalysisQuality**)
(Facoltativo)
Specificate il numero e la gravità massimi dei problemi di qualità consentiti nel rapporto SA affinché il CodeCatalyst rapporto associato venga contrassegnato come superato. Per specificare i problemi di qualità, è necessario specificare:
+ La gravità minima dei problemi di qualità da includere nel conteggio. I valori validi, dal più grave al meno grave, sono: `CRITICAL``HIGH`,,`MEDIUM`,`LOW`,`INFORMATIONAL`.
Ad esempio, se si sceglie`HIGH`, verranno presi `HIGH` in `CRITICAL` considerazione i problemi di qualità.
+ Il numero massimo di problemi di qualità della gravità specificata che si desidera consentire. Il superamento di questo numero fa sì che il CodeCatalyst rapporto venga contrassegnato come fallito. I valori validi sono numeri interi.
I criteri relativi ai problemi di qualità vengono applicati solo PyLint ai report ESLint SA. Per ulteriori informazioni sui report SA, vedere[Rapporti di analisi statica](test-workflow-actions.md#test-static-analysis-reports).
Per specificare la severità minima, utilizzare la `Severity` proprietà. Per specificare il numero massimo di vulnerabilità, utilizzare la `Number` proprietà.
**Interfaccia utente corrispondente: tab/Reports/Success criteri di uscita/problemi di qualità**
## StaticAnalysisFinding
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**StaticAnalysisFinding**)
Or
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**StaticAnalysisFinding**)
(Facoltativo)
Specificare il numero e la gravità massimi dei risultati consentiti nel rapporto SA affinché il CodeCatalyst rapporto associato venga contrassegnato come superato. Per specificare i risultati, è necessario specificare:
+ La gravità minima dei risultati da includere nel conteggio. I valori validi, dal più grave al meno severo, sono: `CRITICAL``HIGH`,`MEDIUM`,,`LOW`,`INFORMATIONAL`.
Ad esempio, se scegli`HIGH`, allora `HIGH` i `CRITICAL` risultati verranno conteggiati.
+ Il numero massimo di risultati della gravità specificata che si desidera consentire. Il superamento di questo numero fa sì che il CodeCatalyst rapporto venga contrassegnato come fallito. I valori validi sono numeri interi.
I risultati si applicano solo ai rapporti SARIF SA. Per ulteriori informazioni sui rapporti SA, vedere[Rapporti di analisi statica](test-workflow-actions.md#test-static-analysis-reports).
Per specificare la severità minima, utilizzare la `Severity` proprietà. Per specificare il numero massimo di vulnerabilità, utilizzare la `Number` proprietà.
**Interfaccia utente corrispondente: tab/Reports/Success criteri di uscita/risultati**
## Reports
(*action-name*/Outputs/**Reports** )
(Facoltativo)
Una sezione che specifica la configurazione per i rapporti di prova.
**Interfaccia utente corrispondente: scheda Output/Report**
## nome-rapporto-1
**(nome-relazione-1) *action-name* /Outputs/Reports/**
(Obbligatorio se incluso) [Reports](#test.configuration.reports)
Il nome che vuoi dare al CodeCatalyst rapporto che verrà generato dai tuoi report non elaborati.
**Interfaccia utente corrispondente: Outputs tab/Reports/Manually configura report/nome del report**
## Format
(*action-name*/Outputs/Reports/*report-name-1*/**Format**)
(Obbligatorio se incluso[Reports](#test.configuration.reports))
Specificate il formato di file che state utilizzando per i report. I valori possibili sono i seguenti.
+ Per i rapporti sui test:
+ Per Cucumber JSON, specifica **Cucumber** (editor visivo) o `CUCUMBERJSON` (editor YAML).
+ Per JUnit XML, specifica **JUnit**(editor visivo) o `JUNITXML` (editor YAML).
+ Per NUnit XML, specificare **NUnit**(editor visuale) o `NUNITXML` (editor YAML).
+ Per NUnit 3 XML, specificare **NUnit3**(editor visuale) o `NUNIT3XML` (editor YAML).
+ Per Visual Studio TRX, specifica **Visual Studio TRX** (editor visivo) o `VISUALSTUDIOTRX` (editor YAML).
+ Per TestNg XML, specificare **TestNg (editor visivo) o `TESTNGXML` (editor YAML**).
+ Per i report sulla copertura del codice:
+ Per Clover XML, specifica **Clover** (editor visivo) o `CLOVERXML` (editor YAML).
+ Per Cobertura XML, specifica **Cobertura** (editor visivo) o (editor YAML). `COBERTURAXML`
+ Per JaCoCo XML, specifica **JaCoCo**(editor visivo) o (editor YAML). `JACOCOXML`
+ Per SimpleCov JSON generato da [simplecov, non da simplecov-json](https://github.com/simplecov-ruby/simplecov)[, specifica Simplecov](https://github.com/vicentllongo/simplecov-json) (editor visivo) o (editor **YAML**). `SIMPLECOV`
+ Per i report di analisi della composizione del software (SCA):
+ Per SARIF, specifica **SARIF** (editor visivo) o `SARIFSCA` (editor YAML).
****Interfaccia utente corrispondente: restituisce i tab/Reports/Manually configure reports/Add/configure *report-name-1* reports//Tipo di report e il formato del report****
## Configuration
(*action-name*/**Configuration**)
(Obbligatorio) Una sezione in cui è possibile definire le proprietà di configurazione dell'azione.
Interfaccia utente corrispondente: scheda **Configurazione**
## Container
(*action-name*/Configuration/**Container**)
(Facoltativo)
Specificate l'immagine Docker, o *contenitore*, che l'azione utilizza per completare l'elaborazione. È possibile specificare una delle [immagini attive](build-images.md#build-curated-images) fornite in CodeCatalyst dotazione oppure utilizzare un'immagine personalizzata. Se scegli di utilizzare la tua immagine, questa può risiedere in Amazon ECR, Docker Hub o in un altro registro. Se non specifichi un'immagine Docker, l'azione utilizza una delle immagini attive per l'elaborazione. Per informazioni su quale immagine attiva viene utilizzata per impostazione predefinita, consulta[Immagini attive](build-images.md#build-curated-images).
Per ulteriori informazioni su come specificare un'immagine Docker personalizzata, consulta. [Assegnazione di un'immagine Docker in un ambiente di runtime personalizzato a un'azione](build-images.md#build-images-specify)
Interfaccia utente corrispondente: immagine **Docker dell'ambiente di esecuzione** - opzionale
## Registry
(*action-name*/Configuration/Container/**Registry**)
(Obbligatorio se `Container` incluso)
Specificate il registro in cui è archiviata l'immagine. I valori validi includono:
+ `CODECATALYST`(Editor YAML)
L'immagine è memorizzata nel registro. CodeCatalyst
+ **Docker Hub** (editor visivo) o `DockerHub` (editor YAML)
L'immagine è memorizzata nel registro delle immagini di Docker Hub.
+ **Altro registro** (editor visivo) o `Other` (editor YAML)
L'immagine viene memorizzata in un registro di immagini personalizzato. È possibile utilizzare qualsiasi registro disponibile pubblicamente.
+ **Amazon Elastic Container Registry** (editor visivo) o `ECR` (editor YAML)
L'immagine è archiviata in un repository di immagini di Amazon Elastic Container Registry. Per utilizzare un'immagine in un repository Amazon ECR, questa azione richiede l'accesso ad Amazon ECR. Per abilitare questo accesso, devi creare un [ruolo IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) che includa le seguenti autorizzazioni e una politica di fiducia personalizzata. (Se lo desideri, puoi modificare un ruolo esistente per includere le autorizzazioni e la policy.)
Il ruolo IAM deve includere le seguenti autorizzazioni nella sua politica del ruolo:
+ `ecr:BatchCheckLayerAvailability`
+ `ecr:BatchGetImage`
+ `ecr:GetAuthorizationToken`
+ `ecr:GetDownloadUrlForLayer`
Il ruolo IAM deve includere la seguente politica di fiducia personalizzata:
Per ulteriori informazioni sulla creazione di ruoli IAM, consulta [Creating a role using custom trust policies (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html) nella *IAM User Guide*.
Una volta creato il ruolo, è necessario assegnarlo all'azione tramite un ambiente. Per ulteriori informazioni, consulta [Associare un ambiente a un'azione](deploy-environments-add-app-to-environment.md).
Interfaccia utente corrispondente: **Amazon Elastic Container Registry**, **Docker Hub** e **altre opzioni di registro**
## Image
(*action-name*/Configuration/Container/**Image**)
(Obbligatorio se `Container` incluso)
Specifica una delle seguenti proprietà:
+ Se utilizzate un `CODECATALYST` registro, impostate l'immagine su una delle seguenti [immagini attive](build-images.md#build-curated-images):
+ `CodeCatalystLinux_x86_64:2024_03`
+ `CodeCatalystLinux_x86_64:2022_11`
+ `CodeCatalystLinux_Arm64:2024_03`
+ `CodeCatalystLinux_Arm64:2022_11`
+ `CodeCatalystLinuxLambda_x86_64:2024_03`
+ `CodeCatalystLinuxLambda_x86_64:2022_11`
+ `CodeCatalystLinuxLambda_Arm64:2024_03`
+ `CodeCatalystLinuxLambda_Arm64:2022_11`
+ `CodeCatalystWindows_x86_64:2022_11`
+ Se utilizzi un registro Docker Hub, imposta l'immagine sul nome dell'immagine Docker Hub e sul tag opzionale.
Ad esempio: `postgres:latest`
+ Se utilizzi un registro Amazon ECR, imposta l'immagine sull'URI del registro Amazon ECR.
Ad esempio: `111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo`
+ Se utilizzi un registro personalizzato, imposta l'immagine sul valore previsto dal registro personalizzato.
**Interfaccia utente corrispondente: **immagine docker dell'ambiente di runtime** (se il registro è`CODECATALYST`), **immagine Docker Hub** (se il registro è **Docker Hub**), **URL dell'immagine ECR** (se il registro è **Amazon Elastic Container Registry) e **URL dell'immagine** (se il registro** è Other registry).**
## Steps
(*action-name*/Configuration/**Steps**)
(Obbligatorio)
Specificate i comandi di shell da eseguire durante l'operazione di installazione, configurazione ed esecuzione degli strumenti di compilazione.
Ecco un esempio di come creare un progetto npm:
```
Steps:
- Run: npm install
- Run: npm run build
```
Ecco un esempio di come specificare i percorsi dei file:
```
Steps:
- Run: cd $ACTION_BUILD_SOURCE_PATH_WorkflowSource/app && cat file2.txt
- Run: cd $ACTION_BUILD_SOURCE_PATH_MyBuildArtifact/build-output/ && cat file.txt
```
Per ulteriori informazioni sulla specificazione dei percorsi dei file, vedere [Riferimento ai file del repository di origine](workflows-sources-reference-files.md) e[Riferimento ai file in un artefatto](workflows-working-artifacts-refer-files.md).
**Interfaccia utente corrispondente: scheda di configurazione/comandi Shell**
## Packages
(*action-name*/Configuration/**Packages**)
(Facoltativo)
Una sezione in cui è possibile specificare un archivio di pacchetti utilizzato dall'azione per risolvere le dipendenze. I pacchetti consentono di archiviare e condividere in modo sicuro i pacchetti software utilizzati per lo sviluppo di applicazioni.
Per ulteriori informazioni sui pacchetti, vedere[Pubblica e condividi pacchetti software in CodeCatalyst](packages.md).
**Interfaccia utente corrispondente: scheda di configurazione/ Pacchetti**
## NpmConfiguration
(*action-name*/Configuration/Packages/**NpmConfiguration**)
(Richiesto se [Packages](#build.configuration.packages) incluso)
Una sezione che definisce la configurazione per il formato del pacchetto npm. Questa configurazione viene utilizzata da un'azione durante l'esecuzione di un flusso di lavoro.
Per ulteriori informazioni sulla configurazione del pacchetto npm, vedere[Utilizzo di npm](packages-npm.md).
**Interfaccia utente corrispondente: Configuration tab/Packages/Add configuration/ npm**
## PackageRegistries
(*action-name*/Configuration/Packages/NpmConfiguration/**PackageRegistries**)
(Richiesto se incluso[Packages](#build.configuration.packages))
Una sezione in cui è possibile definire le proprietà di configurazione di una sequenza di repository di pacchetti.
Interfaccia utente corrispondente: tab/Packages/Add configuration/npm **Configurazione/Aggiungi archivio di pacchetti**
## PackagesRepository
(*action-name*/Configuration/Packages/NpmConfiguration/PackageRegistries/**PackagesRepository**)
(Richiesto se [Packages](#build.configuration.packages) incluso)
Specificate il nome dell'*archivio dei CodeCatalyst pacchetti* che desiderate venga utilizzato dall'azione.
Se specificate più repository predefiniti, l'ultimo repository avrà la priorità.
Per ulteriori informazioni sugli archivi dei pacchetti, vedere. [Archivi di pacchetti](packages-concepts.md#packages-concepts-repository)
**Interfaccia utente corrispondente: archivio dei tab/Packages/Add configuration/npm/Add pacchetti di configurazione/archivio dei pacchetti**
## Scopes
(*action-name*/Configuration/Packages/NpmConfiguration/PackageRegistries/**Scopes**)
(Facoltativo)
Specificate una sequenza di *ambiti* che desiderate definire nel registro dei pacchetti. Quando si definiscono gli ambiti, l'archivio dei pacchetti specificato viene configurato come registro per tutti gli ambiti elencati. Se un pacchetto con l'ambito viene richiesto tramite il client npm, utilizzerà quel repository anziché quello predefinito. Ogni nome di ambito deve avere il prefisso «@».
Se includi gli ambiti di override, l'ultimo repository avrà la priorità.
Se `Scopes` viene omesso, l'archivio dei pacchetti specificato viene configurato come registro predefinito per tutti i pacchetti utilizzati dall'azione.
[Per ulteriori informazioni sugli ambiti, vedere i pacchetti and [Namespace dei pacchetti](packages-concepts.md#packages-concepts-package-namespaces) Scoped.](https://docs.npmjs.com/cli/v10/using-npm/scope)
**Interfaccia utente corrispondente: repository/ Scopes dei tab/Packages/Add configuration/npm/Add pacchetti di configurazione - opzionale**
## ExportAuthorizationToken
(*action-name*/Configuration/Packages/**ExportAuthorizationToken**)
(Facoltativo)
Abilita o disabilita la funzionalità del token di autorizzazione all'esportazione. Se abilitata, i token di autorizzazione esportati possono essere utilizzati per configurare manualmente un gestore di pacchetti per l'autenticazione con CodeCatalyst gli archivi di pacchetti. È possibile utilizzare il token come variabile di ambiente a cui fare riferimento nelle proprie azioni.
I valori validi sono `true` e `false`.
Se `ExportAuthorizationToken` viene omesso, l'impostazione predefinita è. `false`
Per ulteriori informazioni sul token di autorizzazione all'esportazione, vedere[Utilizzo dei token di autorizzazione nelle azioni del flusso di lavoro](workflows-package-export-token.md).
**Interfaccia utente corrispondente: scheda di configurazione/Pacchetti/ Token di autorizzazione all'esportazione**