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à.
Riferimento all'azione del codice sorgente di Amazon S3
Un'azione di origine attiva la pipeline quando un nuovo oggetto viene caricato nel bucket e nella chiave dell'oggetto configurati.
Questo argomento di riferimento descrive l'azione sorgente di Amazon S3 per CodePipeline cui la posizione di origine è un bucket Amazon S3 configurato per il controllo delle versioni. Per informazioni di riferimento sull'azione di distribuzione di Amazon S3 in CodePipeline, consulta. Riferimento alle azioni di distribuzione di Amazon S3
Prima di collegare la pipeline, crea un bucket di origine Amazon S3, abilita il controllo delle versioni e carica i file di origine come un unico file ZIP.
Puoi creare un nuovo bucket in Amazon S3 o selezionare un bucket Amazon S3 esistente da utilizzare come posizione di origine per i file dell'applicazione. Per ulteriori informazioni sull'abilitazione del controllo delle versioni, consulta Using versioning nella Amazon S3 User Guide.
Se Amazon S3 è il fornitore di origine per la tua pipeline, puoi comprimere il file o i file di origine in un unico .zip e caricare il file.zip nel tuo bucket di origine. Puoi anche caricare un singolo file decompresso; tuttavia, le azioni a valle che prevedono un file.zip falliranno.
Se utilizzi la console per creare o modificare la pipeline, CodePipeline crea una EventBridge regola che avvia la pipeline quando si verifica una modifica nel bucket di origine di Amazon S3.
Puoi anche creare un'override del codice sorgente utilizzando l'input transform entry per utilizzare l'elemento revisionValue in EventBridge per l'evento pipeline, in cui revisionValue è derivato dalla variabile dell'evento source per la chiave dell'oggetto, il commit o l'ID dell'immagine. Per ulteriori informazioni, consultate il passaggio facoltativo per l'immissione della trasformazione di input incluso nelle procedure riportate di seguito. Connessione alle azioni di origine di Amazon S3 con una fonte abilitata per gli eventi
Argomenti
Tipo di operazione
-
Categoria:
Source -
Proprietario:
AWS -
Provider:
S3 -
Versione:
1
Parametri di configurazione
- S3Bucket
-
Obbligatorio: sì
Il nome del bucket Amazon S3 in cui devono essere rilevate le modifiche all'origine.
- S3ObjectKey
-
Obbligatorio: sì
Il nome della chiave oggetto Amazon S3 in cui devono essere rilevate le modifiche all'origine.
- AllowOverrideForS3ObjectKey
-
Obbligatorio: no
AllowOverrideForS3ObjectKeycontrolla se l'override della fonteStartPipelineExecutionpuò sovrascrivere quello già configuratoS3ObjectKeynell'azione di origine. Per ulteriori informazioni sulle sostituzioni dei sorgenti con la chiave S3 Object, consulta. Avvia una pipeline con una modifica della revisione del codice sorgenteImportante
Se ometti
AllowOverrideForS3ObjectKey, per CodePipeline impostazione predefinita la possibilità di sovrascrivere S3 ObjectKey nell'azione di origine impostando questo parametro su.falseI valori validi per questo parametro sono:
-
true: Se impostata, la chiave oggetto S3 preconfigurata può essere sostituita dalle sostituzioni delle revisioni del codice sorgente durante l'esecuzione di una pipeline.Nota
Se intendi consentire a tutti CodePipeline gli utenti la possibilità di sovrascrivere la chiave oggetto S3 preconfigurata durante l'avvio di una nuova esecuzione della pipeline, devi impostare su.
AllowOverrideForS3ObjectKeytrue -
false:Se impostata, non CodePipeline consentirà la sovrascrittura della chiave oggetto S3 utilizzando le sostituzioni delle revisioni del codice sorgente. Questo è anche il valore predefinito per questo parametro.
-
- PollForSourceChanges
-
Obbligatorio: no
PollForSourceChangescontrolla se interroga CodePipeline il bucket di origine di Amazon S3 per verificare eventuali modifiche alla fonte. Ti consigliamo invece di utilizzare CloudWatch Events e di rilevare CloudTrail le modifiche all'origine. Per ulteriori informazioni sulla configurazione CloudWatch degli eventi, consulta Migra le pipeline di polling con un codice sorgente e trail CloudTrail (CLI) S3 oMigra le pipeline di polling con una sorgente e un trail S3 (modello) CloudTrail CloudFormation.Importante
Se intendi configurare gli CloudWatch eventi, devi impostarlo su
PollForSourceChangesperfalseevitare esecuzioni duplicate della pipeline.I valori validi per questo parametro sono:
-
true: Se impostata, verifica la posizione di origine per CodePipeline verificare se sono state apportate modifiche alla fonte.Nota
Se si omette
PollForSourceChanges, per CodePipeline impostazione predefinita esegue il sondaggio della posizione di origine per verificare eventuali modifiche alla fonte. Questo comportamento è lo stesso sePollForSourceChangesè incluso e impostato sutrue. -
false: se impostata, CodePipeline non esegue il sondaggio della posizione di origine per verificare eventuali modifiche alla fonte. Utilizza questa impostazione se intendi configurare una regola CloudWatch Events per rilevare le modifiche all'origine.
-
Input artifact (Artefatti di input)
-
Numero di artefatti:
0 -
Descrizione: gli artefatti di input non si applicano a questo tipo di azione.
Artefatti di output
-
Numero di artefatti:
1 -
Descrizione: fornisce gli artefatti disponibili nel bucket di origine configurato per connettersi alla pipeline. Gli artefatti generati dal bucket sono gli artefatti di output per l'azione Amazon S3. I metadati degli oggetti Amazon S3 (ETag e ID di versione) vengono visualizzati CodePipeline come revisione di origine per l'esecuzione della pipeline attivata.
Variabili di output
Quando è configurata, questa azione produce variabili che possono essere referenziate dalla configurazione dell'azione di un'azione downstream nella pipeline. Questa azione produce variabili che possono essere viste come variabili di output, anche se l'azione non ha uno spazio dei nomi. È possibile configurare un'azione con uno spazio dei nomi per rendere tali variabili disponibili per la configurazione delle azioni downstream.
Per ulteriori informazioni sulle variabili in, consulta. CodePipeline Riferimento alle variabili
- BucketName
-
Il nome del bucket Amazon S3 relativo alla modifica dell'origine che ha attivato la pipeline.
- ETag
-
Il tag entità per l'oggetto correlato alla modifica di origine che ha attivato la pipeline. L'ETag è un hash MD5 dell'oggetto. L'ETag riflette solo i cambiamenti ai contenuti di un oggetto, non i suoi metadata.
- ObjectKey
-
Il nome della chiave oggetto Amazon S3 correlato alla modifica dell'origine che ha attivato la pipeline.
- VersionId
-
L'ID di versione per la versione dell'oggetto correlata alla modifica di origine che ha attivato la pipeline.
Autorizzazioni per i ruoli di servizio: S3 source action
Per il supporto di S3 source action, aggiungi quanto segue alla tua dichiarazione politica:
Dichiarazione dell'operazione
Consulta anche
Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione.
-
Tutorial: creazione di una semplice pipeline (bucket S3)— Questo tutorial fornisce un esempio di file di specifiche dell'app e un esempio di CodeDeploy applicazione e gruppo di distribuzione. Usa questo tutorial per creare una pipeline con un sorgente Amazon S3 da distribuire su istanze Amazon EC2.