Azione all'origine di Amazon S3

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. Azione 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 singolo file ZIP 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.

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

AllowOverrideForS3ObjectKeycontrolla se source overrides from StartPipelineExecution può sovrascrivere quello già configurato S3ObjectKey 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 sorgente

Importante

Se omettiAllowOverrideForS3ObjectKey, 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

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 AWS CloudFormation.

Importante

Se intendi configurare gli CloudWatch eventi, devi impostarlo su PollForSourceChanges per false 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 omettePollForSourceChanges, per CodePipeline impostazione predefinita esegue il sondaggio della posizione di origine per verificare eventuali modifiche alla fonte. Questo comportamento è lo stesso se PollForSourceChanges è incluso e impostato su true.

• 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 Variables

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.

Dichiarazione dell'operazione

YAML

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: my-bucket-oregon
      S3ObjectKey: my-application.zip
      PollForSourceChanges: 'false'
    InputArtifacts: []

JSON

{
    "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": "my-bucket-oregon",
                "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.