Tindakan sumber Amazon S3 - AWS CodePipeline

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

Tindakan sumber Amazon S3

Memicu pipa saat objek baru diunggah ke bucket dan kunci objek yang dikonfigurasi.

catatan

Topik referensi ini menjelaskan tindakan sumber Amazon S3 untuk CodePipeline di mana lokasi sumber adalah bucket Amazon S3 yang dikonfigurasi untuk versi. Untuk informasi referensi tentang tindakan penyebaran Amazon S3 di CodePipeline, lihatTindakan penerapan Amazon S3.

Anda dapat membuat bucket Amazon S3 untuk digunakan sebagai lokasi sumber untuk file aplikasi Anda.

catatan

Saat Anda membuat bucket sumber Anda, pastikan Anda mengaktifkan versi pada bucket. Jika Anda ingin menggunakan bucket Amazon S3 yang sudah ada, lihatMenggunakan versioninguntuk mengaktifkan versi pada bucket yang sudah ada.

Jika Anda menggunakan konsol untuk membuat atau mengedit saluran Anda, CodePipeline menciptakan CloudWatch Aturan peristiwa yang memulai pipa Anda saat terjadi perubahan di bucket sumber S3.

Anda harus telah membuat bucket sumber Amazon S3 dan mengunggah file sumber sebagai file ZIP tunggal sebelum menghubungkan pipeline melalui tindakan Amazon S3.

catatan

Ketika Amazon S3 adalah penyedia sumber untuk pipeline Anda, Anda dapat zip file sumber atau file ke dalam satu .zip dan mengunggah .zip ke bucket sumber Anda. Anda juga dapat mengunggah satu file unzip; namun, tindakan hilir yang mengharapkan file.zip akan gagal.

Tipe tindakan

  • Kategori:Source

  • Pemilik:AWS

  • Penyedia:S3

  • Versi:1

Parameter konfigurasi

S3Bucket

Diperlukan: Ya

Nama bucket Amazon S3 tempat perubahan sumber harus dideteksi.

S3ObjectKey

Diperlukan: Ya

Nama kunci objek Amazon S3 tempat perubahan sumber harus dideteksi.

PollForSourceChanges

Diperlukan: Tidak

PollForSourceChangesmengontrol apakah CodePipeline Jajak pendapat bucket sumber Amazon S3 untuk perubahan sumber. Sebaiknya Anda menggunakan CloudWatch Acara dan CloudTrail untuk mendeteksi perubahan sumber sebagai gantinya. Untuk informasi lebih lanjut tentang konfigurasi CloudWatch Acara, lihatMigrasi jaringan pemungutan suara dengan sumber dan jejak CloudTrail S3 (CLI)atauMigrasikan jalur pemungutan suara dengan sumber dan CloudTrail jejak S3 (templat) AWS CloudFormation.

penting

Jika Anda berniat untuk mengkonfigurasi CloudWatch Acara, Anda harus mengaturPollForSourceChangeskepadafalseuntuk menghindari eksekusi pipa duplikat.

Nilai yang valid untuk parameter ini:

  • true: Jika diatur, CodePipeline jajak pendapat lokasi sumber Anda untuk perubahan sumber.

    catatan

    Jika Anda menghilangkanPollForSourceChanges, CodePipeline default untuk polling lokasi sumber Anda untuk perubahan sumber. Ini adalah perilaku yang sama seperti jikaPollForSourceChangesdisertakan dan diatur ketrue.

  • false: Jika diatur, CodePipeline tidak memilih lokasi sumber Anda untuk perubahan sumber. Gunakan pengaturan ini jika Anda berniat untuk mengkonfigurasi CloudWatch Acara aturan untuk mendeteksi perubahan sumber.

artefak masukan

  • Jumlah artefak: 0

  • Deskripsi: Artefak masukan tidak berlaku untuk jenis tindakan ini.

artefak keluaran

  • Jumlah artefak: 1

  • Deskripsi: Menyediakan artefak yang tersedia dalam ember sumber yang dikonfigurasi untuk terhubung ke pipa. Artefak yang dihasilkan dari bucket adalah artefak keluaran untuk aksi Amazon S3. Metadata objek Amazon S3 (ETag dan ID versi) ditampilkan di CodePipeline sebagai revisi sumber untuk eksekusi pipa dipicu.

Variabel output

Ketika dikonfigurasi, tindakan ini menghasilkan variabel yang dapat direferensikan oleh konfigurasi aksi aksi hilir dalam pipa. Tindakan ini menghasilkan variabel yang dapat dilihat sebagai variabel output, bahkan jika tindakan tidak memiliki namespace. Anda mengkonfigurasi tindakan dengan namespace untuk membuat variabel tersebut tersedia untuk konfigurasi tindakan hilir.

Untuk informasi lebih lanjut tentang variabel di CodePipeline, lihatVariabel.

ETag

Tag entitas untuk objek yang terkait dengan perubahan sumber yang memicu pipa. ETag adalah hash MD5 dari objek. ETag mencerminkan perubahan pada konten suatu objek, bukan metadatanya.

VersionId

Versi ID untuk versi objek yang terkait dengan perubahan sumber yang memicu pipa.

Deklarasi aksi

YAML
Name: Source Actions: - RunOrder: 1 OutputArtifacts: - Name: SourceArtifact ActionTypeId: Provider: S3 Owner: AWS Version: '1' Category: Source Region: us-west-2 Name: Source Configuration: S3Bucket: my-bucket-oregon S3ObjectKey: my-application.zip PollForSourceChanges: 'false' InputArtifacts: []
JSON
{ "Name": "Source", "Actions": [ { "RunOrder": 1, "OutputArtifacts": [ { "Name": "SourceArtifact" } ], "ActionTypeId": { "Provider": "S3", "Owner": "AWS", "Version": "1", "Category": "Source" }, "Region": "us-west-2", "Name": "Source", "Configuration": { "S3Bucket": "my-bucket-oregon", "S3ObjectKey": "my-application.zip", "PollForSourceChanges": "false" }, "InputArtifacts": [] } ] },

Sumber daya terkait berikut dapat membantu Anda saat bekerja dengan tindakan ini.

  • Tutorial: Buat pipeline sederhana (ember S3)- Tutorial ini menyediakan file spesifikasi aplikasi sampel dan aplikasi CodeDeploy sampel dan grup penyebaran. Gunakan tutorial ini untuk membuat pipeline dengan sumber Amazon S3 yang menyebarkan ke instans Amazon EC2.