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à.
# Pubblicazione di file su Amazon S3 con un flusso di lavoro
Questa sezione descrive come pubblicare file su Amazon S3 utilizzando un CodeCatalyst flusso di lavoro. A tale scopo, devi aggiungere l'azione di pubblicazione di **Amazon S3** al tuo flusso di lavoro. L'azione di **pubblicazione di Amazon S3** copia i file da una directory di origine a un bucket Amazon S3. La directory dei sorgenti può risiedere in:
+ Un [repository di origine](source.md), oppure
+ Un [artefatto di output](workflows-working-artifacts.md) generato da un'altra azione del flusso di lavoro
**Topics**
+ [Quando usare l'azione «Pubblica su Amazon S3»](#s3-pub-action-when-to-use)
+ [Immagine di runtime utilizzata dall'azione 'Amazon S3 publish'](#s3-pub-action-runtime)
+ [Esempio: pubblicazione di file su Amazon S3](s3-pub-action-example-workflow.md)
+ [Aggiungere l'azione «Amazon S3 publish»](s3-pub-action-add.md)
+ [Azione «pubblicazione Amazon S3» YAML](s3-pub-action-ref.md)
## Quando usare l'azione «Pubblica su Amazon S3»
Usa questa azione se:
+ Hai un flusso di lavoro che genera file che desideri archiviare in Amazon S3.
Ad esempio, potresti avere un flusso di lavoro che crea un sito Web statico da ospitare in Amazon S3. In questo caso, il flusso di lavoro includerebbe un'[azione di compilazione](build-add-action.md) per creare il codice HTML e i file di supporto del sito e un'azione di **pubblicazione di Amazon S3** per copiare i file su Amazon S3.
+ Hai un repository di origine che contiene i file che desideri archiviare in Amazon S3.
Ad esempio, potresti avere un repository di sorgenti con i file sorgente delle applicazioni che desideri archiviare ogni notte su Amazon S3.
## Immagine di runtime utilizzata dall'azione 'Amazon S3 publish'
L'azione di **pubblicazione di Amazon S3** viene eseguita su un'immagine di [novembre 2022](build-images.md#build.previous-image). Per ulteriori informazioni, consulta [Immagini attive](build-images.md#build-curated-images).
# Esempio: pubblicazione di file su Amazon S3
Il seguente flusso di lavoro di esempio include l'azione di **pubblicazione di Amazon S3**, insieme a un'azione di compilazione. Il flusso di lavoro crea un sito Web di documentazione statico e quindi lo pubblica su Amazon S3, dove è ospitato. Il flusso di lavoro è costituito dai seguenti elementi costitutivi eseguiti in sequenza:
+ Un **trigger**: questo trigger avvia l'esecuzione automatica del flusso di lavoro quando invii una modifica al tuo repository 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** (`BuildDocs`): all'attivazione, l'azione crea un sito Web di documentazione statico (`mkdocs build`) e aggiunge i file HTML associati e i metadati di supporto a un elemento chiamato. `MyDocsSite` Per ulteriori informazioni sull'azione di compilazione, consulta. [Creazione con flussi di lavoro](build-workflow-actions.md)
+ Un'azione di **pubblicazione di Amazon S3** (`PublishToS3`): al termine dell'azione di creazione, questa azione copia il sito nell'`MyDocsSite`artefatto su Amazon S3 per l'hosting.
**Nota**
Il seguente esempio di flusso di lavoro è a scopo illustrativo e non funzionerà senza una configurazione aggiuntiva.
**Nota**
Nel codice YAML che segue, puoi omettere la `Connections:` sezione se lo desideri. Se ometti questa sezione, devi assicurarti che il ruolo specificato nel campo Ruolo **IAM predefinito** nel tuo ambiente includa le autorizzazioni e le policy di fiducia richieste dall'azione di pubblicazione di **Amazon S3**. Per ulteriori informazioni sulla configurazione di un ambiente con un ruolo IAM predefinito, consulta. [Creazione di un ambiente](deploy-environments-creating-environment.md) Per ulteriori informazioni sulle autorizzazioni e sulle politiche di attendibilità richieste dall'azione di pubblicazione di **Amazon S3**, consulta la descrizione della proprietà [Role](s3-pub-action-ref.md#s3.pub.environment.connections.role) nel. [Azione «pubblicazione Amazon S3» YAML](s3-pub-action-ref.md)
```
Name: codecatalyst-s3-publish-workflow
SchemaVersion: 1.0
Triggers:
- Type: PUSH
Branches:
- main
Actions:
BuildDocs:
Identifier: aws/build@v1
Inputs:
Sources:
- WorkflowSource
Configuration:
Steps:
- Run: echo BuildDocs started on `date`
- Run: pip install --upgrade pip
- Run: pip install mkdocs
- Run: mkdocs build
- Run: echo BuildDocs completed on `date`
Outputs:
Artifacts:
- Name: MyDocsSite
Files:
- "site/**/*"
PublishToS3:
Identifier: aws/s3-publish@v1
Environment:
Name: codecatalyst-s3-publish-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-s3-publish-build-role
Inputs:
Sources:
- WorkflowSource
Artifacts:
- MyDocsSite
Configuration:
DestinationBucketName: amzn-s3-demo-bucket
SourcePath: /artifacts/PublishToS3/MyDocSite/site
TargetPath: my/docs/site
```
# Aggiungere l'azione «Amazon S3 publish»
Utilizza le seguenti istruzioni per aggiungere l'azione di **pubblicazione di Amazon S3** al tuo flusso di lavoro.
------
#### [ Visual ]
**Per aggiungere l'azione «Amazon S3 publish» utilizzando l'editor visuale**
1. [Apri la console all'indirizzo https://codecatalyst.aws/ CodeCatalyst .](https://codecatalyst.aws/)
1. Scegliere il progetto.
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. In alto a sinistra, scegli **\$1 Azioni** per aprire il catalogo delle azioni.
1. **Dall'elenco a discesa, scegli Amazon. CodeCatalyst**
1. Cerca l'azione di **pubblicazione di Amazon S3** ed esegui una delle seguenti operazioni:
+ Scegli il segno più (**\$1**) per aggiungere l'azione al diagramma del flusso di lavoro e apri il relativo riquadro di configurazione.
Or
+ Scegli **Amazon S3** Publish. Viene visualizzata la finestra di dialogo con i dettagli dell'azione. In questa finestra di dialogo:
+ (Facoltativo) Scegliete **Visualizza sorgente** per [visualizzare il codice sorgente dell'azione](workflows-view-source.md#workflows-view-source.title).
+ Scegli **Aggiungi al flusso di lavoro** per aggiungere l'azione al diagramma del flusso di lavoro e aprire il relativo riquadro di configurazione.
1. Nelle schede **Ingressi**, **Configurazione** e **Uscite**, completa i campi in base alle tue esigenze. Per una descrizione di ogni campo, consulta la. [Azione «pubblicazione Amazon S3» YAML](s3-pub-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, quindi scegliete nuovamente Commit.**
------
#### [ YAML ]
**Per aggiungere l'azione «Amazon S3 publish» utilizzando l'editor YAML**
1. [Apri la console all'indirizzo https://codecatalyst.aws/. CodeCatalyst ](https://codecatalyst.aws/)
1. Scegliere il progetto.
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. In alto a sinistra, scegli **\$1 Azioni per aprire il catalogo delle azioni**.
1. **Dall'elenco a discesa, scegli Amazon. CodeCatalyst**
1. Cerca l'azione di **pubblicazione di Amazon S3** ed esegui una delle seguenti operazioni:
+ Scegli il segno più (**\$1**) per aggiungere l'azione al diagramma del flusso di lavoro e apri il relativo riquadro di configurazione.
Or
+ Scegli **Amazon S3** Publish. Viene visualizzata la finestra di dialogo con i dettagli dell'azione. In questa finestra di dialogo:
+ (Facoltativo) Scegliete **Visualizza sorgente** per [visualizzare il codice sorgente dell'azione](workflows-view-source.md#workflows-view-source.title).
+ Scegli **Aggiungi al flusso di lavoro** per aggiungere l'azione al diagramma del flusso di lavoro e aprire il relativo riquadro di configurazione.
1. Modifica le proprietà del codice YAML in base alle tue esigenze. Una spiegazione di ogni proprietà disponibile è fornita in. [Azione «pubblicazione Amazon S3» YAML](s3-pub-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, quindi scegliete nuovamente Commit.**
------
# Azione «pubblicazione Amazon S3» YAML
Di seguito è riportata la definizione YAML dell'azione di pubblicazione di **Amazon S3**. Per informazioni su come utilizzare questa azione, consulta. [Pubblicazione di file su Amazon S3 con un flusso di lavoro](s3-pub-action.md)
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).
**Nota**
La maggior parte delle proprietà YAML che seguono hanno elementi dell'interfaccia utente corrispondenti nell'editor visivo. **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.
S3Publish\$1nn:
Identifier: aws/s3-publish@v1
DependsOn:
- build-action
Compute:
Type: EC2 | Lambda
Fleet: fleet-name
Timeout: timeout-minutes
Inputs:
Sources:
- source-name-1
Artifacts:
- artifact-name
Variables:
- Name: variable-name-1
Value: variable-value-1
- Name: variable-name-2
Value: variable-value-2
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: iam-role-name
Configuration:
SourcePath: my/source
DestinationBucketName: amzn-s3-demo-bucket
TargetPath: my/target
```
## S3Publish
(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.
Default: `S3Publish_nn`.
**Interfaccia utente corrispondente: scheda di configurazione/nome dell'azione**
## Identifier
(*S3Publish*/**Identifier**)
(Obbligatorio)
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).
Default: `aws/s3-publish@v1`.
**Interfaccia utente corrispondente: Workflow diagram/ S3Publish \$1nn/ aws/s3-publish @v1 label**
## DependsOn
(*S3Publish*/**DependsOn**)
(Facoltativo)
Specificate un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente affinché questa azione venga eseguita.
Per ulteriori informazioni sulla funzionalità «dipende da», vedere. [Azioni di sequenziamento](workflows-depends-on.md)
**Interfaccia utente corrispondente: scheda Input/Dipende da - opzionale**
## Compute
(*S3Publish*/**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
(*S3Publish*/Compute/**Type**)
(Obbligatorio se [Compute](#s3.pub.computename) incluso)
Il tipo di motore di calcolo. È possibile utilizzare uno dei seguenti valori:
+ **EC2**(editor visivo) 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
(*S3Publish*/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
(*S3Publish*/**Timeout**)
(Obbligatorio)
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**
## Inputs
(*S3Publish*/**Inputs**)
(Facoltativo)
La `Inputs` sezione definisce i dati `S3Publish` necessari durante l'esecuzione di un flusso di lavoro.
**Nota**
**Sono consentiti un massimo di quattro input (una fonte e tre artefatti) per ogni AWS CDK azione di distribuzione.** 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
(*S3Publish*/Inputs/**Sources**)
(Obbligatorio se i file che desideri pubblicare su Amazon S3 sono archiviati in un repository di origine)
Se i file che desideri pubblicare su Amazon S3 sono archiviati in un repository di origine, specifica l'etichetta di tale repository di origine. Attualmente, l'unica etichetta supportata è. `WorkflowSource`
Se i file che desideri pubblicare su Amazon S3 non sono contenuti in un repository di origine, devono risiedere in un artefatto generato da un'altra azione.
Per ulteriori informazioni sulle origini, consulta [Connessione degli archivi di origine ai flussi di lavoro](workflows-sources.md).
**Interfaccia utente corrispondente: scheda Input/Sources - opzionale**
## Artifacts - input
(*S3Publish*/Inputs/**Artifacts**)
(Obbligatorio se i file che desideri pubblicare su Amazon S3 sono archiviati in un elemento [di output di un'azione precedente](workflows-working-artifacts-output.md))
Se i file che desideri pubblicare su Amazon S3 sono contenuti in un artefatto generato da un'azione precedente, specifica tale elemento qui. Se i tuoi file non sono contenuti in un artefatto, devono risiedere nel tuo repository di origine.
Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md)
**Interfaccia utente corrispondente: scheda di configurazione/artefatti - opzionale**
## Variables - input
(*S3Publish*/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
## Environment
(*S3Publish*/**Environment**)
(Obbligatorio)
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
(*S3Publish*/Environment/**Name**)
(Richiesto se [Environment](#s3.pub.environment) incluso)
Specificate il nome di un ambiente esistente che desiderate associare all'azione.
**Interfaccia utente corrispondente: scheda di configurazione/ambiente**
## Connections
(*S3Publish*/Environment/**Connections**)
(Facoltativo nelle versioni più recenti dell'azione; richiesto nelle versioni precedenti)
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: una delle seguenti a seconda della versione dell'azione:
+ (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo**
+ **(Versioni precedenti) Scheda di configurazione/' '/ connessione all'account Environment/account/role AWS **
## Name
(*S3Publish*/Environment/Connections/**Name**)
(Richiesto se è incluso[Connections](#s3.pub.environment.connections))
Specificare il nome della connessione all'account.
Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione:
+ (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo**
+ **(Versioni precedenti) Scheda di configurazione/' '/ connessione all'account Environment/account/role AWS **
## Role
(*S3Publish*/Environment/Connections/**Role**)
(Richiesto se è incluso[Connections](#s3.pub.environment.connections))
Specificare il nome del ruolo IAM utilizzato dall'azione di **pubblicazione di Amazon S3** per accedere AWS e copiare i file su Amazon S3. Assicurati di aver [aggiunto il ruolo al tuo CodeCatalyst spazio](ipa-connect-account-addroles.md) e che il ruolo includa le seguenti politiche.
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.
+ La seguente politica di autorizzazioni:
**avvertimento**
Limita le autorizzazioni a quelle mostrate nella seguente politica. L'utilizzo di un ruolo con autorizzazioni più ampie potrebbe rappresentare un rischio per la sicurezza.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:ListBucket",
"s3:DeleteObject"
],
"Resource": [
"arn:aws:s3:::bucket-name",
"arn:aws:s3:::bucket-name/*"
]
}
]
}
```
------
+ La seguente politica di fiducia personalizzata:
**Nota**
Puoi usare il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo con questa azione, se lo desideri. 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.
Interfaccia utente corrispondente: una delle seguenti a seconda della versione di azione:
+ (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo**
+ **(Versioni precedenti) Scheda di configurazione/' '/ Ruolo Environment/account/role**
## Configuration
(*S3Publish*/**Configuration**)
(Obbligatorio)
Una sezione in cui è possibile definire le proprietà di configurazione dell'azione.
Interfaccia utente corrispondente: scheda **Configurazione**
## SourcePath
(*S3Publish*/Configuration/**SourcePath**)
(Obbligatorio)
Specificare il nome e il percorso di una directory o di un file che si desidera pubblicare su Amazon S3. La directory o il file possono risiedere in un repository di origine o in un elemento di un'azione precedente ed è relativo al repository di origine o alla radice dell'artefatto.
Esempi:
Specificando `./myFolder/` copia il contenuto di su Amazon S3 e `/myFolder` preserva la struttura di directory sottostante.
Specificare `./myFolder/myfile.txt` copie *solo* `myfile.txt` su Amazon S3. (La struttura delle cartelle viene rimossa).
Non è possibile utilizzare i caratteri jolly.
**Nota**
Potrebbe essere necessario aggiungere un prefisso alla directory o 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: scheda di configurazione/percorso di origine**
## DestinationBucketName
(*S3Publish*/Configuration/**DestinationBucketName**)
(Obbligatorio)
Specificate il nome del bucket Amazon S3 in cui desiderate pubblicare i file.
Interfaccia utente corrispondente: scheda di configurazione/bucket di **destinazione** - opzionale
## TargetPath
(*S3Publish*/Configuration/**TargetPath**)
(Facoltativo)
Specificate il nome e il percorso della directory in Amazon S3 in cui desiderate pubblicare i file. Se la directory non esiste, verrà creata. Il percorso della directory non deve includere il nome del bucket.
Esempi:
`myS3Folder`
`./myS3Folder/myS3Subfolder`
Interfaccia utente corrispondente: scheda di **configurazione/directory di destinazione** - opzionale