View a markdown version of this page

Referensi tindakan penyebaran Amazon S3 - AWS CodePipeline
Tipe tindakanParameter konfigurasiArtefak masukanArtefak keluaranIzin peran layanan: Tindakan penyebaran S3Contoh 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 penyebaran Amazon S3

Anda menggunakan tindakan penyebaran 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 diunggah ke bucket Anda.

catatan

Topik referensi ini menjelaskan tindakan penyebaran 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, lihatReferensi 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, tentukan bahwa file akan diekstraksi sebelum diunggah. 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. 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 kunci ARN untuk mengidentifikasi kunci. Cross-account tindakan melibatkan penggunaan peran dari akun lain (accountB), jadi menentukan ID kunci akan menggunakan kunci dari akun lain (accountB).

penting

CodePipeline hanya mendukung kunci 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 digunakan ke Amazon S3. Ini mengganti ACL yang ada yang diterapkan ke objek.

CacheControl

Wajib: Tidak

CacheControlParameter mengontrol perilaku caching requests/responses untuk objek dalam bucket. Untuk daftar nilai yang valid, lihat bidang Cache-Control header 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 penerapan 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 penyebaran S3

Untuk dukungan tindakan penerapan S3, tambahkan 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 penyebaran S3, jika objek S3 Anda 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 Ekstrak disetel ke false

Contoh berikut menunjukkan konfigurasi tindakan default saat tindakan dibuat dengan Extract bidang 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'
      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 Ekstrak disetel ke true

Contoh berikut menunjukkan konfigurasi tindakan default saat tindakan dibuat dengan Extract bidang 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'
    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"
        }
    ]
},

Sumber daya terkait berikut dapat membantu Anda saat Anda mengerjakan tindakan ini.

  • Tutorial: Membuat pipeline yang menggunakan Amazon S3 sebagai penyedia penerapan— Tutorial ini memandu Anda melalui dua contoh untuk membuat pipeline dengan tindakan penyebaran S3. Anda mengunduh file sampel, mengunggah file ke CodeCommit repositori Anda, membuat bucket S3 Anda, dan mengonfigurasi bucket Anda 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.