Riferimento alle azioni di distribuzione di Amazon S3

Utilizzi un'azione di distribuzione di Amazon S3 per distribuire file in un bucket Amazon S3 per l'hosting o l'archiviazione di siti Web statici. Puoi specificare se estrarre i file di distribuzione prima di caricarli nel tuo bucket.

Nota

Questo argomento di riferimento descrive l'azione di distribuzione di Amazon S3 per i CodePipeline casi in cui la piattaforma di distribuzione è un bucket Amazon S3 configurato per l'hosting. Per informazioni di riferimento sull'azione del codice sorgente di Amazon S3 in CodePipeline, consulta. Riferimento all'azione del codice sorgente di Amazon S3

Tipo di operazione

• Categoria: Deploy

• Proprietario: AWS

• Provider: S3

• Versione: 1

Parametri di configurazione

BucketName

Campo obbligatorio: sì

Il nome del bucket Amazon S3 in cui devono essere distribuiti i file.

Estrarre

Campo obbligatorio: sì

Se true, specifica che i file devono essere estratti prima del caricamento. In caso contrario, i file dell'applicazione rimangono compressi durante il caricamento, ad esempio nel caso di un sito Web statico ospitato. Se false, allora ObjectKey è necessario.

ObjectKey

Condizionale. Obbligatoria se Extract = false

Il nome della chiave oggetto Amazon S3 che identifica in modo univoco l'oggetto nel bucket S3.

KMSEncryptionKeyARN

Campo obbligatorio: no

La chiave ARN di AWS KMS crittografia per il bucket host. Il KMSEncryptionKeyARN parametro crittografa gli artefatti caricati con quanto fornito. AWS KMS key Per una KMS chiave, è possibile utilizzare l'ID della chiave, la chiave o l'ARNalias. ARN

Nota

Gli alias vengono riconosciuti solo nell'account che ha creato la KMS chiave. Per le azioni tra account, puoi utilizzare solo l'ID o la chiave ARN per identificare la chiave. Le operazioni tra account comportano l'utilizzo del ruolo dell'altro account (AccountB), pertanto specificando l'ID chiave verrà utilizzata la chiave dell'altro account (AccountB).

Importante

CodePipeline supporta solo chiavi simmetricheKMS. Non utilizzare una KMS chiave asimmetrica per crittografare i dati nel bucket S3.

In scatola ACL

Campo obbligatorio: no

Il CannedACL parametro applica il valore predefinito specificato ACL agli oggetti distribuiti su Amazon S3. Questo sovrascrive qualsiasi elemento esistente ACL applicato all'oggetto.

CacheControl

Campo obbligatorio: no

Il CacheControl parametro controlla il comportamento di memorizzazione nella cache per le richieste/risposte per gli oggetti nel bucket. Per un elenco di valori validi, consultate il campo di Cache-Controlintestazione per le operazioni. HTTP Per inserire più valori in CacheControl, utilizzare una virgola tra ogni valore. È possibile aggiungere uno spazio dopo ogni virgola (opzionale), come mostrato in questo esempio per: CLI

"CacheControl": "public, max-age=0, no-transform"

Input artifact (Artefatti di input)

• Numero di artefatti: 1

• Descrizione: i file per la distribuzione o l'archiviazione sono ottenuti dal repository di origine, compressi e caricati da. CodePipeline

Artefatti di output

• Numero di artefatti: 0

• Descrizione: gli artefatti di output non si applicano a questo tipo di azione.

Esempio di configurazione dell'operazione

Di seguito sono riportati alcuni esempi per la configurazione dell'azione.

Esempio di configurazione quando Extract è impostato su false

L'esempio seguente mostra la configurazione dell'azione predefinita quando l'azione viene creata con il Extract campo impostato sufalse.

YAML

Name: Deploy
Actions:
  - Name: Deploy
    ActionTypeId:
      Category: Deploy
      Owner: AWS
      Provider: S3
      Version: '1'
    RunOrder: 1
    Configuration:
      BucketName: website-bucket
      Extract: 'false'
    OutputArtifacts: []
    InputArtifacts:
      - Name: SourceArtifact
    Region: us-west-2
    Namespace: DeployVariables

JSON

{
    "Name": "Deploy",
    "Actions": [
        {
            "Name": "Deploy",
            "ActionTypeId": {
                "Category": "Deploy",
                "Owner": "AWS",
                "Provider": "S3",
                "Version": "1"
            },
            "RunOrder": 1,
            "Configuration": {
                "BucketName": "website-bucket",
                "Extract": "false"
                },
            "OutputArtifacts": [],
            "InputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "Region": "us-west-2",
            "Namespace": "DeployVariables"
        }
    ]
},

Esempio di configurazione quando Extract è impostato su true

L'esempio seguente mostra la configurazione dell'azione predefinita quando l'azione viene creata con il Extract campo impostato sutrue.

YAML

Name: Deploy
Actions:
  - Name: Deploy
    ActionTypeId:
      Category: Deploy
      Owner: AWS
      Provider: S3
      Version: '1'
    RunOrder: 1
    Configuration:
      BucketName: website-bucket
      Extract: 'true'
      ObjectKey: MyWebsite
    OutputArtifacts: []
    InputArtifacts:
      - Name: SourceArtifact
    Region: us-west-2
    Namespace: DeployVariables

JSON

{
    "Name": "Deploy",
    "Actions": [
        {
            "Name": "Deploy",
            "ActionTypeId": {
                "Category": "Deploy",
                "Owner": "AWS",
                "Provider": "S3",
                "Version": "1"
            },
            "RunOrder": 1,
            "Configuration": {
                "BucketName": "website-bucket",
                "Extract": "true",
                "ObjectKey": "MyWebsite"
                },
            "OutputArtifacts": [],
            "InputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "Region": "us-west-2",
            "Namespace": "DeployVariables"
        }
    ]
},

Consulta anche

Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione.

• Tutorial: crea una pipeline che utilizzi Amazon S3 come provider di distribuzione— Questo tutorial illustra due esempi di creazione di una pipeline con un'azione di distribuzione di S3. Scarichi file di esempio, carichi i file nel tuo CodeCommit repository, crei il tuo bucket S3 e configuri il bucket per l'hosting. Successivamente, usi la CodePipeline console per creare la pipeline e specificare una configurazione di distribuzione di Amazon S3.

• Riferimento all'azione del codice sorgente di Amazon S3— Questo riferimento all'azione fornisce informazioni di riferimento ed esempi per le azioni di origine di Amazon S3 in. CodePipeline