Referensi tindakan penerapan Amazon S3 - AWS CodePipeline
Tipe tindakanParameter konfigurasi Artefak masukanArtefak keluaranContoh konfigurasi tindakanLihat juga

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

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

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

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

catatan

Alias hanya dikenali di akun yang membuat KMS kunci. Untuk tindakan lintas akun, Anda hanya dapat menggunakan ID kunci atau kunci ARN 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 KMS tombol simetris. Jangan gunakan KMS kunci asimetris untuk mengenkripsi data di bucket S3 Anda.

Kalengan ACL

Wajib: Tidak

CannedACLParameter menerapkan kaleng yang ditentukan ACL ke objek yang diterapkan ke Amazon S3. Ini menimpa semua ACL yang ada yang diterapkan pada 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 HTTP operasi. 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"
        }
    ]
},

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.

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