View a markdown version of this page

Referenz zur Amazon S3-Bereitstellungsaktion - AWS CodePipeline
AktionstypKonfigurationsparameterInput artifacts (Eingabeartefakte)AusgabeartefakteBerechtigungen für Servicerollen: Aktion „S3-Bereitstellung“BeispielaktionskonfigurationWeitere Informationen finden Sie auch unter

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Referenz zur Amazon S3-Bereitstellungsaktion

Sie verwenden eine Amazon S3-Bereitstellungsaktion, um Dateien für das Hosting oder die Archivierung statischer Websites in einem Amazon S3-Bucket bereitzustellen. Sie können angeben, ob die Bereitstellungsdateien vor dem Hochladen in Ihren Bucket extrahiert werden sollen.

Anmerkung

Dieses Referenzthema beschreibt die Amazon S3-Bereitstellungsaktion für den Fall, dass es CodePipeline sich bei der Bereitstellungsplattform um einen Amazon S3-Bucket handelt, der für das Hosting konfiguriert ist. Referenzinformationen zur Amazon S3-Quellaktion in CodePipeline finden Sie unterReferenz zur Amazon S3-Quellaktion.

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

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

ObjectKey

Bedingt. Erforderlich, wenn Extract = false

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

KMSEncryptionKeyARN

Erforderlich: Nein

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 KMS-Schlüssel können Sie die Schlüssel-ID, den Schlüssel-ARN oder den Alias-ARN verwenden.

Anmerkung

Aliase werden nur in dem Konto erkannt, das den KMS-Schlüssel erstellt hat. Bei kontoübergreifenden Aktionen können Sie nur die Schlüssel-ID oder den Schlüssel-ARN verwenden, um den Schlüssel zu identifizieren. Cross-account Bei Aktionen wird die Rolle des anderen Kontos (AccountB) verwendet. Wenn Sie also die Schlüssel-ID angeben, wird der Schlüssel des anderen Kontos (accounB) verwendet.

Wichtig

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

CannedACL

Erforderlich: Nein

Der CannedACL Parameter wendet die angegebene vordefinierte ACL https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl auf Objekte an, die in Amazon S3 bereitgestellt werden. Dadurch werden alle auf das Objekt angewandten vorhandenen ACLs überschrieben.

CacheControl

Erforderlich: Nein

Der CacheControl Parameter steuert das Caching-Verhalten requests/responses 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 Archivierung werden aus dem Quell-Repository abgerufen, gezippt und von hochgeladen. CodePipeline

Ausgabeartefakte

  • Anzahl der Artefakte: 0

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

Berechtigungen für Servicerollen: Aktion „S3-Bereitstellung“

Für die Unterstützung von S3-Bereitstellungsaktionen fügen Sie Ihrer Grundsatzerklärung Folgendes hinzu:

JSON
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:PutObjectAcl",
        "s3:PutObjectVersionAcl",
        "s3:GetBucketVersioning",
        "s3:GetBucketAcl",
        "s3:GetBucketLocation"
      ],
      "Resource": [
        "arn:aws:s3:::[[s3DeployBuckets]]",
        "arn:aws:s3:::[[s3DeployBuckets]]/*"
      ],
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "111122223333"
        }
      }
    }
  ]
}

Für die Unterstützung von S3-Bereitstellungsaktionen müssen Sie Ihrer Richtlinienerklärung außerdem die folgenden Berechtigungen hinzufügen, wenn Ihre S3-Objekte über Tags verfügen:

"s3:GetObjectTagging",
"s3:GetObjectVersionTagging",
"s3:PutObjectTagging"

Beispielaktionskonfiguration

Im Folgenden finden Sie Beispiele für die Aktionskonfiguration.

Beispielkonfiguration, wenn Extract auf false gesetzt ist

Das folgende Beispiel zeigt die Standardaktionskonfiguration, wenn die Aktion mit dem Wert Extract auf erstellt wirdfalse.

YAML
Name: Deploy
Actions:
  - Name: Deploy
    ActionTypeId:
      Category: Deploy
      Owner: AWS
      Provider: S3
      Version: '1'
    RunOrder: 1
    Configuration:
      BucketName: website-bucket
      Extract: 'false'
      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": "false",
                "ObjectKey": "MyWebsite"
                },
            "OutputArtifacts": [],
            "InputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "Region": "us-west-2",
            "Namespace": "DeployVariables"
        }
    ]
},

Beispielkonfiguration, wenn Extract auf true gesetzt ist

Das folgende Beispiel zeigt die Standardaktionskonfiguration, wenn die Aktion mit dem Wert Extract auf erstellt wirdtrue.

YAML
Name: Deploy
Actions:
  - Name: Deploy
    ActionTypeId:
      Category: Deploy
      Owner: AWS
      Provider: S3
      Version: '1'
    RunOrder: 1
    Configuration:
      BucketName: website-bucket
      Extract: 'true'
    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"
                },
            "OutputArtifacts": [],
            "InputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "Region": "us-west-2",
            "Namespace": "DeployVariables"
        }
    ]
},

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-Bereitstellungskonfiguration anzugeben.

  • Referenz zur Amazon S3-Quellaktion— Diese Aktionsreferenz enthält Referenzinformationen und Beispiele für Amazon S3-Quellaktionen in CodePipeline.