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. Tindakan sumber Amazon S3

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.

KMS ARN EncryptionKey

Wajib: Tidak

ARN dari kunci AWS KMS enkripsi untuk bucket host. KMSEncryptionKeyARNParameter mengenkripsi artefak yang diunggah dengan yang disediakan. AWS KMS key Untuk kunci KMS, Anda dapat menggunakan ID kunci, kunci ARN, atau alias ARN.

catatan

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).

penting

CodePipeline hanya mendukung tombol KMS simetris. Jangan gunakan kunci KMS asimetris untuk mengenkripsi data di bucket S3 Anda.

CannedACL

Wajib: Tidak

CannedACLParameter menerapkan ACL kalengan yang ditentukan ke objek yang diterapkan ke Amazon S3. Ini menimpa ACL yang ada yang diterapkan ke objek.

CacheControl

Wajib: Tidak

CacheControlParameter mengontrol perilaku caching untuk permintaan/tanggapan untuk objek di bucket. Untuk daftar nilai yang valid, lihat bidang Cache-Controlheader untuk operasi HTTP. Untuk memasukkan beberapa nilaiCacheControl, 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.

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 yang disetel kefalse.

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

Contoh konfigurasi saat Extract diatur ke true

Contoh berikut menunjukkan konfigurasi tindakan default ketika tindakan dibuat dengan Extract bidang yang disetel ketrue.

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

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— 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.

• Tindakan sumber Amazon S3— Referensi tindakan ini memberikan informasi referensi dan contoh untuk tindakan sumber Amazon S3 di. CodePipeline