Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Referensi tindakan penerapan Amazon S3
Referensi tindakan penerapan Amazon S3

Anda menggunakan tindakan penerapan Amazon S3 untuk menyebarkan file ke bucket Amazon S3 untuk hosting atau arsip situs web statis. Anda dapat menentukan apakah akan mengekstrak file penerapan sebelum mengunggah ke bucket.

**catatan**  
Topik referensi ini menjelaskan tindakan penerapan Amazon S3 CodePipeline di mana platform penerapan adalah bucket Amazon S3 yang dikonfigurasi untuk hosting. Untuk informasi referensi tentang tindakan sumber Amazon S3 di CodePipeline, lihat. [Referensi tindakan sumber Amazon S3](action-reference-S3.md)

**Topics**
+ [

## Tipe tindakan
](#action-reference-S3Deploy-type)
+ [

## Parameter konfigurasi
](#action-reference-S3Deploy-config)
+ [

## Artefak masukan
](#action-reference-S3Deploy-input)
+ [

## Artefak keluaran
](#action-reference-S3Deploy-output)
+ [

## Izin peran layanan: Tindakan penerapan S3
](#edit-role-s3deploy)
+ [

## Contoh konfigurasi tindakan
](#action-reference-S3Deploy-example)
+ [

## Lihat juga
](#action-reference-S3Deploy-links)

## Tipe tindakan

+ Kategori: `Deploy`
+ Pemilik: `AWS`
+ Penyedia: `S3`
+ Versi: `1`

## Parameter konfigurasi


**BucketName**  
Wajib: Ya  
Nama bucket Amazon S3 tempat file akan digunakan.

**Ekstrak**  
Wajib: Ya  
Jika benar, menentukan bahwa file yang akan diekstraksi sebelum meng-upload. Jika tidak, file aplikasi tetap di-zip untuk diunggah, seperti dalam kasus situs web statis yang dihosting. Jika salah, maka `ObjectKey` diperlukan.

**ObjectKey**  
Bersyarat. Diperlukan jika `Extract` = salah  
Nama kunci objek Amazon S3 yang secara unik mengidentifikasi objek di bucket S3.

**KMSEncryptionkeYarn**  
Wajib: Tidak  
ARN dari kunci AWS KMS enkripsi untuk bucket host. `KMSEncryptionKeyARN`Parameter mengenkripsi artefak yang diunggah dengan yang disediakan. AWS KMS key Untuk kunci KMS, Anda dapat menggunakan ID kunci, kunci ARN, atau alias ARN.  
Alias hanya dikenali di akun yang membuat kunci KMS. Untuk tindakan lintas akun, Anda hanya dapat menggunakan ID kunci atau ARN kunci untuk mengidentifikasi kunci. Tindakan lintas akun melibatkan penggunaan peran dari akun lain (accountB), sehingga menentukan ID kunci akan menggunakan kunci dari akun lain (accounTB).
CodePipeline hanya mendukung tombol KMS simetris. Jangan gunakan kunci KMS asimetris untuk mengenkripsi data di bucket S3 Anda.

**CannedACL**  
Wajib: Tidak  
`CannedACL`Parameter menerapkan [ACL kalengan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl) yang ditentukan ke objek yang diterapkan ke Amazon S3. Ini menimpa ACL yang ada yang diterapkan ke objek.

**CacheControl**  
Wajib: Tidak  
`CacheControl`Parameter mengontrol perilaku caching requests/responses untuk objek di bucket. Untuk daftar nilai yang valid, lihat bidang [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9)header untuk operasi HTTP. Untuk memasukkan beberapa nilai`CacheControl`, gunakan koma di antara setiap nilai. Anda dapat menambahkan spasi setelah setiap koma (opsional), seperti yang ditunjukkan dalam contoh ini untuk CLI:  

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

## Artefak masukan

+ **Jumlah Artefak:** `1`
+ **Deskripsi:** File untuk penyebaran atau arsip diperoleh dari repositori sumber, di-zip, dan diunggah oleh. CodePipeline

## Artefak keluaran

+ **Jumlah artefak:** `0` 
+ **Deskripsi:** Artefak keluaran tidak berlaku untuk jenis tindakan ini.

## Izin peran layanan: Tindakan penerapan S3


Untuk dukungan tindakan penerapan S3, tambahkan yang berikut ini ke pernyataan kebijakan Anda:

------
#### [ 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"
        }
      }
    }
  ]
}
```

------

Untuk dukungan tindakan penerapan S3, jika objek S3 memiliki tag, Anda juga harus menambahkan izin berikut ke pernyataan kebijakan Anda:

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

## Contoh konfigurasi tindakan


Berikut ini menunjukkan contoh untuk konfigurasi tindakan.

### Contoh konfigurasi saat `Extract` diatur ke `false`


Contoh berikut menunjukkan konfigurasi tindakan default ketika tindakan dibuat dengan `Extract` bidang diatur ke`false`.

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

------

### Contoh konfigurasi saat `Extract` diatur ke `true`


Contoh berikut menunjukkan konfigurasi tindakan default ketika tindakan dibuat dengan `Extract` bidang diatur ke`true`.

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

------

## Lihat juga


Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan tindakan ini.
+ [Tutorial: Membuat pipeline yang menggunakan Amazon S3 sebagai penyedia penerapan](tutorials-s3deploy.md)— Tutorial ini memandu Anda melalui dua contoh untuk membuat pipeline dengan tindakan penerapan S3. Anda mengunduh file sampel, mengunggah file ke CodeCommit repositori, membuat bucket S3, dan mengonfigurasi bucket untuk hosting. Selanjutnya, Anda menggunakan CodePipeline konsol untuk membuat pipeline dan menentukan konfigurasi penerapan Amazon S3.
+ [Referensi tindakan sumber Amazon S3](action-reference-S3.md)— Referensi tindakan ini memberikan informasi referensi dan contoh untuk tindakan sumber Amazon S3 di. CodePipeline