Amazon S3 S3-Aktionen

Sie verwenden eine Amazon S3 S3-Bereitstellungsaktion, um Dateien in einem Amazon S3 S3-Bucket bereitzustellen, um statische Websites zu hosten oder zu archivieren. Sie können angeben, ob Bereitstellungsdateien vor dem Hochladen in Ihren Bucket extrahiert werden sollen.

Anmerkung

In diesem Referenzthema wird die Amazon S3 S3-Bereitstellungsaktion beschrieben, CodePipeline bei der die Bereitstellungsplattform ein für das Hosting konfigurierter Amazon S3 S3-Bucket ist. Referenzinformationen zur Amazon S3 S3-Quellaktion in CodePipeline finden Sie unterQuellaktion für Amazon S3.

Aktionstyp

• Kategorie: Deploy

• Eigentümer: AWS

• Anbieter: S3

• Version: 1

Konfigurationsparameter

BucketName

Erforderlich: Ja

Der Name des Amazon-S3-Buckets, in dem Dateien bereitgestellt werden sollen.

Extrahieren

Erforderlich: Ja

Falls wahr, gibt dies an, dass Dateien vor dem Upload extrahiert werden sollen. Andernfalls bleiben die Anwendungsdateien für den Upload komprimiert, z. B. im Fall einer gehosteten statischen Website. Wenn falsch, ObjectKey ist der erforderlich.

ObjectKey

Bedingt. Erforderlich, wenn Extract = false

Der Name des Amazon-S3-Objektschlüssels, der das Objekt im S3-Bucket eindeutig identifiziert.

KM ARN EncryptionKey

Required: No

Der ARN des AWS KMS Verschlüsselungsschlüssels für den Host-Bucket. Der KMSEncryptionKeyARN Parameter verschlüsselt hochgeladene Artefakte mit den bereitgestellten. AWS KMS key Für einen -Schlüssel können Sie die Schlüssel-ID, den Schlüssel-ARN oder den Alias-ARN verwenden.

Anmerkung

Aliasnamen werden nur in dem zum Erstellen des KMS-Schlüssel verwendeten Konto erkannt. Für kontoübergreifende Aktionen können Sie zum Identifizieren des Schlüssels nur die Schlüssel-ID oder den Schlüssel-ARN vewenden. Bei kontoübergreifenden Aktionen wird die Rolle des anderen Kontos (AccountB) verwendet, sodass bei Angabe der Schlüssel-ID der Schlüssel des anderen Kontos (AccountB) verwendet wird.

Wichtig

CodePipelineunterstützt nur symmetrische KMS-Schlüssel. Verwenden Sie keinen asymmetrischen KMS-Schlüssel, um die Daten in Ihrem S3-Bucket zu verschlüsseln.

CannedACL

Required: No

Der CannedACL Parameter wendet die angegebene vordefinierte ACL auf Objekte an, die in Amazon S3 bereitgestellt werden. Dadurch werden alle auf das Objekt angewandten vorhandenen ACLs überschrieben.

CacheControl

Required: No

Der CacheControl Parameter steuert das Caching-Verhalten für Anforderungen/Antworten für Objekte im Bucket. Eine Liste der gültigen Werte finden Sie im Cache-Control-Header-Feld für HTTP-Operationen. Um mehrere Werte in CacheControl einzugeben, verwenden Sie ein Komma zwischen den einzelnen Werten. Sie können nach jedem Komma ein Leerzeichen hinzufügen (optional), wie in diesem Beispiel für die CLI gezeigt:

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

Input artifacts (Eingabeartefakte)

• Anzahl der Artefakte: 1

• Beschreibung: Die Dateien für die Bereitstellung oder das Archiv werden aus dem Quell-Repository abgerufen, komprimiert und von CodePipeline hochgeladen.

Ausgabeartefakte

• Anzahl der Artefakte: 0

• Beschreibung: Ausgabeartefakte gelten für diesen Aktionstyp nicht.

Beispielaktionskonfiguration

Im Folgenden werden Beispiele für die Aktionskonfiguration gezeigt.

Beispielkonfiguration, wenn eingestellt Extract ist auf false

Das folgende Beispiel zeigt die Standardaktionskonfiguration, wenn die Aktion erstellt wird und das Extract Feld auf gesetzt istfalse.

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"
        }
    ]
},

Beispielkonfiguration, wenn eingestellt Extract ist auf true

Das folgende Beispiel zeigt die Standardaktionskonfiguration, wenn die Aktion erstellt wird und das Extract Feld auf gesetzt isttrue.

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"
        }
    ]
},

Weitere Informationen finden Sie auch unter

Die folgenden verwandten Ressourcen bieten Ihnen nützliche Informationen für die Arbeit mit dieser Aktion.

• Tutorial: Erstellen Sie eine Pipeline, die Amazon S3 als Bereitstellungsanbieter verwendet— Dieses Tutorial führt Sie durch zwei Beispiele für die Erstellung einer Pipeline mit einer S3-Bereitstellungsaktion. Sie laden Beispieldateien herunter, laden die Dateien in Ihr CodeCommit Repository hoch, erstellen Ihren S3-Bucket und konfigurieren Ihren Bucket für das Hosting. Als Nächstes verwenden Sie die CodePipeline Konsole, um Ihre Pipeline zu erstellen und eine Amazon S3 S3-Bereitstellungskonfiguration anzugeben.

• Quellaktion für Amazon S3— Diese Aktionsreferenz enthält Referenzinformationen und Beispiele für Amazon S3 S3-Quellaktionen inCodePipeline.