Tindakan sumber Amazon S3

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

catatan

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

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

catatan

Saat membuat bucket sumber, pastikan Anda mengaktifkan pembuatan versi di bucket. Jika Anda ingin menggunakan bucket Amazon S3 yang sudah ada, lihat Menggunakan pembuatan versi untuk mengaktifkan pembuatan versi pada bucket yang ada.

Jika Anda menggunakan konsol untuk membuat atau mengedit pipeline, CodePipeline buat aturan CloudWatch Acara yang memulai pipeline saat terjadi perubahan di bucket sumber S3.

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

catatan

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

Tipe tindakan

• Kategori: Source

• Pemilik: AWS

• Penyedia: S3

• Versi: 1

Parameter konfigurasi

S3Bucket

Wajib: Ya

Nama bucket Amazon S3 tempat perubahan sumber harus dideteksi.

S3 ObjectKey

Wajib: Ya

Nama kunci objek Amazon S3 tempat perubahan sumber akan dideteksi.

AllowOverrideForS3 ObjectKey

Wajib: Tidak

AllowOverrideForS3ObjectKeymengontrol apakah penggantian sumber dari StartPipelineExecution dapat mengganti yang sudah dikonfigurasi S3ObjectKey dalam aksi sumber. Untuk informasi selengkapnya tentang penggantian sumber dengan Kunci Objek S3, lihat. Mulai pipeline dengan penggantian revisi sumber

penting

Jika Anda menghilangkanAllowOverrideForS3ObjectKey, CodePipeline default kemampuan untuk mengganti S3 ObjectKey dalam aksi sumber dengan menyetel parameter ini ke. false

Nilai yang valid untuk parameter ini:

• true: Jika disetel, Kunci Objek S3 yang telah dikonfigurasi sebelumnya dapat diganti dengan penggantian revisi sumber selama eksekusi pipeline.

  catatan

  Jika Anda bermaksud mengizinkan semua CodePipeline pengguna kemampuan untuk mengganti Kunci Objek S3 yang telah dikonfigurasi sebelumnya saat memulai eksekusi pipeline baru, Anda harus menyetelnya. AllowOverrideForS3ObjectKey true

• false:

  Jika disetel, tidak CodePipeline akan mengizinkan Kunci Objek S3 diganti menggunakan penggantian revisi sumber. Ini juga merupakan nilai default untuk parameter ini.

PollForSourceChanges

Wajib: Tidak

PollForSourceChangesmengontrol apakah CodePipeline polling bucket sumber Amazon S3 untuk perubahan sumber. Kami menyarankan Anda menggunakan CloudWatch Acara dan CloudTrail untuk mendeteksi perubahan sumber sebagai gantinya. Untuk informasi selengkapnya tentang mengonfigurasi CloudWatch Acara, lihat Migrasi 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 ingin mengonfigurasi CloudWatch Peristiwa, Anda harus mengatur PollForSourceChanges false untuk menghindari eksekusi pipeline duplikat.

Nilai yang valid untuk parameter ini:

• true: Jika disetel, CodePipeline polling lokasi sumber Anda untuk perubahan sumber.

  catatan

  Jika Anda menghilangkanPollForSourceChanges, CodePipeline default untuk polling lokasi sumber Anda untuk perubahan sumber. Perilaku ini sama seperti jika PollForSourceChanges disertakan dan disetel ketrue.

• false: Jika disetel CodePipeline , jangan polling lokasi sumber Anda untuk perubahan sumber. Gunakan setelan ini jika Anda ingin mengonfigurasi aturan CloudWatch Peristiwa 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 di bucket sumber yang dikonfigurasi untuk terhubung ke pipeline. Artefak yang dihasilkan dari bucket adalah artefak keluaran untuk aksi Amazon S3. Metadata objek Amazon S3 (ETag dan ID versi) ditampilkan CodePipeline sebagai revisi sumber untuk eksekusi pipeline yang dipicu.

Variabel keluaran

Ketika dikonfigurasi, tindakan ini menghasilkan variabel yang dapat direferensikan oleh konfigurasi tindakan tindakan hilir dalam pipeline. Tindakan ini menghasilkan variabel yang dapat dilihat sebagai variabel keluaran, bahkan jika tindakan tidak memiliki namespace. Anda mengonfigurasi tindakan dengan namespace untuk membuat variabel-variabel tersebut tersedia untuk konfigurasi tindakan hilir.

Untuk informasi lebih lanjut tentang variabel di CodePipeline, lihatVariabel.

BucketName

Nama bucket Amazon S3 terkait dengan perubahan sumber yang memicu pipeline.

ETag

Tag entitas untuk objek yang terkait dengan perubahan sumber yang memicu pipeline. ETag adalah hash MD5 dari objek. ETag hanya mencerminkan perubahan pada isi objek, bukan metadata-nya.

ObjectKey

Nama kunci objek Amazon S3 terkait dengan perubahan sumber yang memicu pipeline.

VersionId

ID versi untuk versi objek yang terkait dengan perubahan sumber yang memicu pipeline.

Deklarasi tindakan

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

Lihat juga

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

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