View a markdown version of this page

Riferimento all'azione sorgente di Amazon S3 - AWS CodePipeline
Tipo di operazioneParametri di configurazioneInput artifact (Artefatti di input)Artefatti di outputVariabili di outputAutorizzazioni del ruolo di servizio: azione sorgente S3Dichiarazione dell'operazioneConsulta anche

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 sorgente di Amazon S3

Un'azione sorgente attiva la pipeline quando un nuovo oggetto viene caricato nel bucket configurato e nella chiave dell'oggetto.

Questo argomento di riferimento descrive l'azione sorgente di Amazon S3 la CodePipeline cui 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, consulta. CodePipeline Riferimento all'azione di distribuzione di Amazon S3

Prima di connettere la pipeline, crea un bucket di origine di Amazon S3, abilita il controllo delle versioni e carica i file sorgente come un singolo 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 sorgente in un unico file .zip e caricarlo nel 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 source override utilizzando la voce input transform per utilizzare l'evento revisionValue in EventBridge for your pipeline, derivato dalla variabile dell'evento source per la revisionValue chiave dell'oggetto, il commit o l'ID dell'immagine. Per ulteriori informazioni, consultate il passaggio facoltativo relativo alla voce di trasformazione di input incluso nelle procedure riportate di seguito. Connessione alle azioni di origine di Amazon S3 con una fonte abilitata per gli eventi

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 alla fonte.

S3ObjectKey

Obbligatorio: sì

Il nome della chiave oggetto Amazon S3 in cui devono essere rilevate le modifiche alla fonte.

AllowOverrideForS3ObjectKey

Obbligatorio: no

AllowOverrideForS3ObjectKeycontrolla se le sostituzioni alla sorgente StartPipelineExecution possono sovrascrivere quelle già configurate S3ObjectKey nell'azione di origine. Per ulteriori informazioni sulle sostituzioni dei sorgenti con la chiave oggetto S3, vedere. Avvia una pipeline con una sostituzione della revisione del codice sorgente

Importante

Se si ometteAllowOverrideForS3ObjectKey, per CodePipeline impostazione predefinita viene impostata la capacità di sovrascrivere S3 ObjectKey nell'azione sorgente impostando questo parametro su. false

I valori validi per questo parametro sono:

  • true: se impostata, la chiave oggetto S3 preconfigurata può essere sovrascritta dalle sostituzioni della revisione del codice sorgente durante l'esecuzione di una pipeline.

    Nota

    Se intendete consentire a tutti CodePipeline gli utenti di sovrascrivere la chiave oggetto S3 preconfigurata durante l'avvio di una nuova esecuzione della pipeline, dovete impostare su. AllowOverrideForS3ObjectKey true

  • false:

    Se impostata, non CodePipeline consentirà la sovrascrittura della chiave oggetto S3 utilizzando le sostituzioni della revisione del codice sorgente. Questo è anche il valore predefinito per questo parametro.

PollForSourceChanges

Obbligatorio: no

PollForSourceChangescontrolla se esegue il CodePipeline polling del bucket di origine di Amazon S3 per individuare eventuali modifiche ai sorgenti. Ti consigliamo invece di utilizzare CloudWatch Events e di rilevare CloudTrail le modifiche alla fonte. Per ulteriori informazioni sulla configurazione CloudWatch degli eventi, consulta Migra le pipeline di polling con un source and trail (CLI) S3 CloudTrail oEsegui la migrazione delle pipeline di polling con una sorgente e un percorso S3 ( CloudTrail CloudFormation modello).

Importante

Se intendete configurare CloudWatch Events, dovete impostarlo PollForSourceChanges per false evitare esecuzioni duplicate della pipeline.

I valori validi per questo parametro sono:

  • true: se impostato, esegue il CodePipeline polling della posizione di origine per eventuali modifiche all'origine.

    Nota

    Se omettiPollForSourceChanges, per CodePipeline impostazione predefinita esegue il polling della posizione di origine per eventuali modifiche alla fonte. Questo comportamento è lo stesso se PollForSourceChanges è incluso e impostato su true.

  • false: se impostato, CodePipeline non esegue il polling della posizione di origine per eventuali modifiche alla fonte. Usa 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 (ETag e ID di versione) vengono visualizzati come revisione di origine per l'esecuzione della pipeline attivata CodePipeline .

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 correlato alla modifica all'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 correlata alla modifica alla fonte 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 del ruolo di servizio: azione sorgente S3

Per il supporto delle azioni di origine S3, aggiungi quanto segue alla tua dichiarazione politica:

JSON
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectVersion",
        "s3:GetBucketVersioning",
        "s3:GetBucketAcl",
        "s3:GetBucketLocation",
        "s3:GetObjectTagging",
        "s3:GetObjectVersionTagging"
      ],
      "Resource": [
        "arn:aws:s3:::[[S3Bucket]]",
        "arn:aws:s3:::[[S3Bucket]]/*"
      ],
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "111122223333"
        }
      }
    }
  ]
}

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: amzn-s3-demo-source-bucket
      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": "amzn-s3-demo-source-bucket",
                "S3ObjectKey": "my-application.zip",
                "PollForSourceChanges": "false"
            },
            "InputArtifacts": []
        }
    ]
},

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 AppSpec file di esempio e un' CodeDeployapplicazione e un gruppo di distribuzione di esempio. Usa questo tutorial per creare una pipeline con una fonte Amazon S3 da distribuire su istanze Amazon EC2.