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à.
Attiva la pipeline quando un nuovo oggetto viene caricato nel bucket e nella chiave oggetto configurati.
Nota
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
Puoi creare un bucket Amazon S3 da utilizzare come posizione di origine per i file dell'applicazione.
Nota
Quando crei il bucket di origine, assicurati di abilitare il controllo delle versioni nel bucket. Se desideri utilizzare un bucket Amazon S3 esistente, consulta Usare il controllo delle versioni per abilitare il controllo delle versioni su un bucket esistente.
Se utilizzi la console per creare o modificare la pipeline, CodePipeline crea una regola CloudWatch Events che avvia la pipeline quando si verifica una modifica nel bucket di origine S3.
È necessario aver già creato un bucket di origine Amazon S3 e aver caricato i file di origine come ZIP file singolo prima di connettere la pipeline tramite un'azione Amazon S3.
Nota
Se Amazon S3 è il fornitore di origine per la tua pipeline, puoi comprimere il file o i file sorgente in un unico .zip e caricare il file.zip nel tuo bucket di origine. È inoltre possibile caricare un singolo file decompresso; tuttavia, le operazioni a valle che si aspettano un file con estensione .zip avranno esito negativo.
Argomenti
Tipo di operazione
-
Categoria:
Source
-
Proprietario:
AWS
-
Provider:
S3
-
Versione:
1
Parametri di configurazione
- S3Bucket
-
Campo obbligatorio: sì
Il nome del bucket Amazon S3 in cui devono essere rilevate le modifiche all'origine.
- S3 ObjectKey
-
Campo obbligatorio: sì
Il nome della chiave oggetto Amazon S3 in cui devono essere rilevate le modifiche all'origine.
- AllowOverrideForS3 ObjectKey
-
Campo obbligatorio: no
AllowOverrideForS3ObjectKey
controlla se source overrides fromStartPipelineExecution
può sovrascrivere quello già configuratoS3ObjectKey
nell'azione source. 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.false
I 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.
AllowOverrideForS3ObjectKey
true
-
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
-
Campo obbligatorio: no
PollForSourceChanges
controlla 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 AWS CloudFormation.Importante
Se intendi configurare gli CloudWatch eventi, devi impostarlo su
PollForSourceChanges
perfalse
evitare 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 dell'oggetto Amazon S3 (ETage l'ID della 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. ETagÈ un MD5 hash dell'oggetto. ETagriflette solo le modifiche al contenuto di un oggetto, non ai relativi metadati.
- 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.
Dichiarazione dell'operazione
Name: Source
Actions:
- RunOrder: 1
OutputArtifacts:
- Name: SourceArtifact
ActionTypeId:
Provider: S3
Owner: AWS
Version: '1'
Category: Source
Region: us-west-2
Name: Source
Configuration:
S3Bucket: amzn-s3-demo-source-bucket
S3ObjectKey: my-application.zip
PollForSourceChanges: 'false'
InputArtifacts: []
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