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

Deklarasi tindakan

Tingkat tindakan pipeline memiliki struktur dasar yang mencakup parameter dan sintaks berikut. Untuk informasi selengkapnya, lihat ActionDeclaration objek di Panduan CodePipeline API.

Contoh berikut menunjukkan tingkat tindakan dari struktur pipeline di JSON dan YAML.

YAML

 
. . . 

  stages:
    - name: Source
      actions:
        - name: Source
          actionTypeId:
            category: Source
            owner: AWS
            provider: S3
            version: '1'
          runOrder: 1
          configuration:
            PollForSourceChanges: 'false'
            S3Bucket: amzn-s3-demo-bucket
            S3ObjectKey: codedeploy_linux.zip
          outputArtifacts:
            - name: SourceArtifact
          inputArtifacts: []
          region: us-west-2
          namespace: SourceVariables
    - name: Build
      actions:
        - name: Build
          actionTypeId:
            category: Build
            owner: AWS
            provider: CodeBuild
            version: '1'
          runOrder: 1
          configuration:
            EnvironmentVariables: >-
              [{"name":"ETag","value":"#{SourceVariables.ETag}","type":"PLAINTEXT"}]
            ProjectName: my-project
          outputArtifacts:
            - name: BuildArtifact
          inputArtifacts:
            - name: SourceArtifact
          region: us-west-2
          namespace: BuildVariables
          runOrder: 1
          configuration:
            CustomData: >-
              Here are the exported variables from the build action: S3 ETAG:
              #{BuildVariables.ETag}
          outputArtifacts: []
          inputArtifacts: []
          region: us-west-2

JSON

 
. . . 

        "stages": [
            {
                "name": "Source",
                "actions": [
                    {
                        "name": "Source",
                        "actionTypeId": {
                            "category": "Source",
                            "owner": "AWS",
                            "provider": "S3",
                            "version": "1"
                        },
                        "runOrder": 1,
                        "configuration": {
                            "PollForSourceChanges": "false",
                            "S3Bucket": "amzn-s3-demo-bucket",
                            "S3ObjectKey": "aws-codepipeline-s3-aws-codedeploy_linux.zip"
                        },
                        "outputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "inputArtifacts": [],
                        "region": "us-west-2",
                        "namespace": "SourceVariables"
                    }
                ]
            },
            {
                "name": "Build",
                "actions": [
                    {
                        "name": "Build",
                        "actionTypeId": {
                            "category": "Build",
                            "owner": "AWS",
                            "provider": "CodeBuild",
                            "version": "1"
                        },
                        "runOrder": 1,
                        "configuration": {
                            "EnvironmentVariables": "[{\"name\":\"ETag\",\"value\":\"#{SourceVariables.ETag}\",\"type\":\"PLAINTEXT\"}]",
                            "ProjectName": "my-build-project"
                        },
                        "outputArtifacts": [
                            {
                                "name": "BuildArtifact"
                            }
                        ],
                        "inputArtifacts": [
                            {
                                "name": "SourceArtifact"
                            }
                        ],
                        "region": "us-west-2",
                        "namespace": "BuildVariables"
                    }
                ]
      
. . . 

Untuk daftar configuration detail contoh yang sesuai dengan jenis penyedia, lihatParameter konfigurasi yang valid untuk setiap jenis penyedia.

Struktur tindakan memiliki persyaratan sebagai berikut:

name

Nama aksinya.

region

Untuk tindakan di mana penyedia adalah Layanan AWS Wilayah AWS sumber daya.

Cross-Region tindakan menggunakan Region bidang untuk menentukan Wilayah AWS tempat tindakan akan dibuat. Sumber AWS daya yang dibuat untuk tindakan ini harus dibuat di Wilayah yang sama yang disediakan di region lapangan. Anda tidak dapat membuat tindakan lintas wilayah untuk jenis tindakan berikut:

Pelajari

ARN dari peran layanan IAM yang melakukan tindakan yang dinyatakan. Ini diasumsikan melalui roLearn yang ditentukan pada tingkat pipeline.

namespace

Tindakan dapat dikonfigurasi dengan variabel. Anda menggunakan namespace bidang untuk mengatur namespace dan informasi variabel untuk variabel eksekusi. Untuk informasi referensi tentang variabel eksekusi dan variabel keluaran tindakan, lihatReferensi variabel.

aksi TypeId

ID tipe tindakan diidentifikasi sebagai kombinasi dari empat bidang berikut.

kategori

Jenis tindakan, atau langkah, dalam pipeline, seperti tindakan sumber. Setiap jenis tindakan memiliki serangkaian penyedia tindakan yang valid tertentu. Untuk daftar penyedia yang valid berdasarkan jenis tindakan, lihatReferensi struktur aksi.

Ini adalah actionTypeId kategori yang valid (tipe tindakan) untuk CodePipeline:

owner

Untuk semua jenis tindakan yang saat ini didukung, satu-satunya string pemilik yang valid adalahAWS,ThirdParty, atauCustom. Untuk string pemilik yang valid untuk tindakan tertentu, lihatReferensi struktur aksi.

Untuk informasi lebih lanjut, lihat Referensi API CodePipeline .

versi

Versi aksinya.

penyedia

Penyedia tindakan, seperti CodeBuild.

InputArtifacts

Bidang ini berisi struktur artefak masukan, jika didukung untuk kategori tindakan. Artefak input dari suatu tindakan harus sama persis dengan artefak keluaran yang dinyatakan dalam tindakan sebelumnya. Misalnya, jika tindakan sebelumnya menyertakan deklarasi berikut:

"outputArtifacts": [
    {
    "MyApp"
    }
],

dan tidak ada artefak keluaran lainnya, maka artefak input dari tindakan berikut harus:

"inputArtifacts": [
    {
    "MyApp"
    }
],

Misalnya, tindakan sumber tidak dapat memiliki artefak input karena ini adalah tindakan pertama dalam pipeline. Namun, tindakan sumber akan selalu memiliki artefak keluaran yang diproses oleh tindakan berikut. Artefak keluaran untuk tindakan sumber adalah file aplikasi dari repositori sumber, di-zip dan disediakan melalui bucket artefak, yang diproses oleh tindakan berikut, seperti CodeBuild tindakan yang bertindak pada file aplikasi dengan perintah build.

Sebagai contoh tindakan yang tidak dapat memiliki artefak keluaran, tindakan penerapan tidak memiliki artefak keluaran karena tindakan ini umumnya merupakan tindakan terakhir dalam pipeline.

name

Nama artefak untuk artefak masukan tindakan.

KeluaranArtefak

Nama artefak keluaran harus unik dalam pipeline. Misalnya, pipeline dapat menyertakan satu tindakan yang memiliki artefak keluaran bernama "MyApp" dan tindakan lain yang memiliki artefak keluaran bernama. "MyBuiltApp" Namun, pipeline tidak dapat menyertakan dua tindakan yang keduanya memiliki artefak keluaran bernama"MyApp".

Bidang ini berisi struktur artefak keluaran, jika didukung untuk kategori tindakan. Artefak keluaran suatu tindakan harus sama persis dengan artefak keluaran yang dinyatakan dalam tindakan sebelumnya. Misalnya, jika tindakan sebelumnya menyertakan deklarasi berikut:

"outputArtifacts": [
    {
    "MyApp"
    }
],

dan tidak ada artefak keluaran lainnya, maka artefak input dari tindakan berikut harus:

"inputArtifacts": [
    {
    "MyApp"
    }
],

Misalnya, tindakan sumber tidak dapat memiliki artefak input karena ini adalah tindakan pertama dalam pipeline. Namun, tindakan sumber akan selalu memiliki artefak keluaran yang diproses oleh tindakan berikut. Artefak keluaran untuk tindakan sumber adalah file aplikasi dari repositori sumber, di-zip dan disediakan melalui bucket artefak, yang diproses oleh tindakan berikut, seperti CodeBuild tindakan yang bertindak pada file aplikasi dengan perintah build.

Sebagai contoh tindakan yang tidak dapat memiliki artefak keluaran, tindakan penerapan tidak memiliki artefak keluaran karena tindakan ini umumnya merupakan tindakan terakhir dalam pipeline.

name

Nama artefak untuk artefak keluaran tindakan.

konfigurasi (oleh penyedia tindakan)

Konfigurasi tindakan berisi detail dan parameter yang sesuai dengan jenis penyedia. Pada bagian di bawah ini, contoh parameter konfigurasi tindakan khusus untuk aksi sumber S3.

Konfigurasi tindakan dan batas input/output artefak dapat bervariasi menurut penyedia tindakan. Untuk daftar contoh konfigurasi tindakan berdasarkan penyedia tindakan, lihat Referensi struktur aksi dan tabel diParameter konfigurasi yang valid untuk setiap jenis penyedia. Tabel ini menyediakan tautan ke referensi tindakan untuk setiap jenis penyedia, yang mencantumkan parameter konfigurasi untuk setiap tindakan secara rinci. Untuk tabel dengan batas artefak input dan output untuk setiap penyedia tindakan, lihatArtefak input dan output yang valid untuk setiap jenis tindakan.

Pertimbangan berikut berlaku untuk bekerja dengan tindakan:

Jalankan Pesanan

Bilangan bulat positif yang menunjukkan urutan menjalankan tindakan dalam tahap. Tindakan paralel dalam tahap ditampilkan memiliki bilangan bulat yang sama. Misalnya, dua tindakan dengan urutan run dua akan berjalan secara paralel setelah tindakan pertama dalam tahap berjalan.

runOrderNilai default untuk suatu tindakan adalah 1. Nilai harus berupa bilangan bulat positif (bilangan alami). Anda tidak dapat menggunakan pecahan, desimal, angka negatif, atau nol. Untuk menentukan urutan tindakan seri, gunakan angka terkecil untuk tindakan pertama dan angka yang lebih besar untuk masing-masing tindakan lainnya secara berurutan. Untuk menentukan tindakan paralel, gunakan bilangan bulat yang sama untuk setiap tindakan yang ingin Anda jalankan secara paralel. Di konsol, Anda dapat menentukan urutan serial untuk tindakan dengan memilih Tambahkan grup tindakan pada tingkat di tahap tempat Anda ingin menjalankannya, atau Anda dapat menentukan urutan paralel dengan memilih Tam bah tindakan. Kelompok tindakan mengacu pada urutan menjalankan satu atau lebih tindakan pada tingkat yang sama.

Misalnya, jika Anda ingin tiga tindakan dijalankan secara berurutan dalam tahap, Anda akan memberikan tindakan pertama runOrder nilai 1, tindakan kedua runOrder nilai 2, dan yang ketiga runOrder nilai 3. Namun, jika Anda ingin tindakan kedua dan ketiga berjalan secara paralel, Anda akan memberikan tindakan pertama runOrder nilai 1 dan tindakan kedua dan ketiga runOrder nilai 2.