Bekerja dengan variabel - AWS CodePipeline

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

Bekerja dengan variabel

Beberapa tindakan dalam CodePipeline menghasilkan variabel. Untuk menggunakan variabel:

  • Anda menetapkan namespace ke tindakan untuk membuat variabel yang dihasilkannya tersedia untuk konfigurasi tindakan hilir.

  • Anda mengkonfigurasi tindakan hilir untuk mengkonsumsi variabel yang dihasilkan oleh tindakan.

    Anda dapat melihat detail untuk setiap eksekusi tindakan untuk melihat nilai untuk setiap variabel keluaran yang dihasilkan oleh tindakan dalam waktu eksekusi.

Untuk melihat step-by-step contoh menggunakan variabel:

Mengkonfigurasi tindakan untuk variabel

Ketika Anda menambahkan tindakan ke pipeline Anda, Anda dapat menetapkan namespace dan mengkonfigurasinya untuk mengkonsumsi variabel dari tindakan sebelumnya.

Konfigurasikan tindakan dengan variabel (konsol)

Contoh ini membuat pipeline dengan aksi CodeCommit sumber dan aksi CodeBuild build. CodeBuild Tindakan ini dikonfigurasi untuk mengkonsumsi variabel yang dihasilkan oleh CodeCommit tindakan.

Jika namespace tidak ditentukan, variabel tidak tersedia untuk referensi dalam konfigurasi tindakan. Saat Anda menggunakan konsol untuk membuat pipeline, namespace untuk setiap tindakan akan dibuat secara otomatis.

Untuk membuat alur dengan variabel
  1. Masuk keAWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

  2. Pilih Buat pipeline. Masukkan nama untuk alur Anda, lalu pilih Selanjutnya.

  3. Di Sumber, di Penyedia, pilih CodeCommit. Pilih CodeCommit repositori dan cabang untuk tindakan sumber, dan kemudian pilih Berikutnya.

  4. Di Build, di Provider, pilih CodeBuild. Pilih nama proyek CodeBuild build yang ada atau pilih Create project. Pada Create build project, buat proyek build, lalu pilih Return to CodePipeline.

    Di bawah Variabel lingkungan, pilih Tambahkan variabel lingkungan. Misalnya, masukkan ID eksekusi dengan sintaks variabel#{codepipeline.PipelineExecutionId} dan komit ID dengan sintaks variabel#{SourceVariables.CommitId}.

    catatan

    Anda dapat memasukkan sintaks variabel di bidang konfigurasi tindakan apa pun di wizard.

  5. Pilih Create (Buat).

  6. Setelah pipeline dibuat, Anda dapat melihat namespace yang dibuat oleh wizard. Pada pipeline, pilih ikon untuk tahap yang ingin Anda lihat namespace. Dalam contoh ini, namespace yang dihasilkan secara otomatis tindakan sumberSourceVariables,, ditampilkan.

    
                            Contoh: Layar Info Aksi
Untuk mengedit namespace untuk tindakan yang ada
  1. Masuk keAWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

  2. Pilih alur yang ingin An Untuk tahap sumber, pilih Edit stage. Tambahkan CodeCommit tindakan.

  3. Pada tindakan Edit, lihat kolom Namespace variabel. Jika tindakan yang ada dibuat sebelumnya atau tanpa menggunakan wizard, Anda harus menambahkan namespace. Di Namespace variabel, masukkan nama namespace, lalu pilih Simpan.

Untuk melihat variabel keluaran
  1. Masuk keAWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

  2. Setelah pipeline dibuat dan berjalan dengan sukses, Anda dapat melihat variabel di halaman detail eksekusi tindakan. Untuk informasi, lihat Tampilkan variabel (konsol).

Mengkonfigurasi tindakan untuk variabel (CLI)

Bila Anda menggunakancreate-pipeline perintah untuk membuat pipeline atauupdate-pipeline perintah untuk mengedit pipeline, Anda dapat mereferensi/menggunakan variabel dalam konfigurasi tindakan.

Jika namespace tidak ditentukan, variabel yang dihasilkan oleh tindakan tidak tersedia untuk direferensikan dalam konfigurasi tindakan hilir apa pun.

Untuk mengkonfigurasi tindakan dengan namespace
  1. Ikuti langkah-langkahBuat pipeline di CodePipeline untuk membuat pipeline menggunakan CLI. Mulai file input untuk memberikancreate-pipeline perintah dengan--cli-input-json parameter. Dalam struktur pipa, tambahkannamespace parameter dan tentukan nama, sepertiSourceVariables.

    . . . { "inputArtifacts": [], "name": "Source", "region": "us-west-2", "namespace": "SourceVariables", "actionTypeId": { "category": "Source", "owner": "AWS", "version": "1", "provider": "CodeCommit" }, "outputArtifacts": [ . . .
  2. Simpan file dengan nama sepertiMyPipeline.json.

  3. Pada terminal (Linux, macOS, atau Unix) atau command prompt (Windows), jalankan create-pipelineperintah dan buat alur.

    Panggil file yang Anda buat saat menjalankan create-pipelineperintah. Misalnya:

    aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json
Untuk mengkonfigurasi tindakan hilir untuk mengkonsumsi variabel
  1. Edit file input untuk memberikanupdate-pipeline perintah dengan--cli-input-json parameter. Dalam aksi hilir, tambahkan variabel ke konfigurasi untuk tindakan itu. Sebuah variabel terdiri dari namespace dan kunci, dipisahkan oleh periode. Misalnya, untuk menambahkan variabel untuk ID eksekusi pipeline dan ID komit sumber, tentukan namespacecodepipeline untuk variabel#{codepipeline.PipelineExecutionId}. Tentukan namespaceSourceVariables untuk variabel#{SourceVariables.CommitId}.

    { "name": "Build", "actions": [ { "outputArtifacts": [ { "name": "BuildArtifacts" } ], "name": "Build", "configuration": { "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]", "ProjectName": "env-var-test" }, "inputArtifacts": [ { "name": "SourceArtifact" } ], "region": "us-west-2", "actionTypeId": { "provider": "CodeBuild", "category": "Build", "version": "1", "owner": "AWS" }, "runOrder": 1 } ] },
  2. Simpan file dengan nama sepertiMyPipeline.json.

  3. Pada terminal (Linux, macOS, atau Unix) atau command prompt (Windows), jalankan create-pipelineperintah dan buat alur.

    Panggil file yang Anda buat saat menjalankan create-pipelineperintah. Misalnya:

    aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

Tampilkan variabel keluaran

Anda dapat melihat rincian eksekusi tindakan untuk melihat variabel untuk tindakan itu, khusus untuk setiap eksekusi.

Tampilkan variabel (konsol)

Anda dapat menggunakan konsol tersebut untuk melihat variabel untuk suatu tindakan.

  1. Masuk keAWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

    Nama-nama dari semua alur yang terkait denganAWS akun Anda akan ditampilkan.

  2. Di Nama, pilih nama alur.

  3. Pilih Lihat riwayat.

  4. Setelah pipeline berjalan dengan sukses, Anda dapat melihat variabel yang dihasilkan oleh aksi sumber. Pilih Lihat riwayat. Pilih Sumber dalam daftar tindakan untuk eksekusi pipeline untuk melihat detail eksekusi tindakan untuk CodeCommit tindakan tersebut. Pada layar detail tindakan, lihat variabel di bawah Variabel keluaran.

    
                            Contoh: Variabel keluaran sumber
  5. Setelah pipeline berjalan dengan sukses, Anda dapat melihat variabel yang dikonsumsi oleh aksi build. Pilih Lihat riwayat. Dalam daftar tindakan untuk eksekusi pipeline, pilih Build untuk melihat detail eksekusi tindakan untuk CodeBuild tindakan tersebut. Pada halaman detail tindakan, lihat variabel di bawah Konfigurasi tindakan. Namespace yang dihasilkan secara otomatis ditampilkan.

    
                            Contoh: Variabel Konfigurasi Aksi

    Secara default, konfigurasi Action menampilkan sintaks variabel. Anda dapat memilih Tampilkan konfigurasi yang diselesaikan untuk beralih daftar untuk menampilkan nilai yang dihasilkan selama eksekusi tindakan.

    
                            Contoh: Variabel Konfigurasi Tindakan Terselesaikan

Tampilkan variabel (CLI)

Anda dapat menggunakanlist-action-executions perintah untuk melihat variabel untuk tindakan.

  1. Gunakan perintah berikut:

    aws codepipeline list-action-executions

    Output menunjukkanoutputVariables parameter seperti yang ditunjukkan di sini.

    "outputVariables": { "BranchName": "main", "CommitMessage": "Updated files for test", "AuthorDate": "2019-11-08T22:24:34Z", "CommitId": "d99b0083cc10EXAMPLE", "CommitterDate": "2019-11-08T22:24:34Z", "RepositoryName": "variables-repo" },
  2. Gunakan perintah berikut:

    aws codepipeline get-pipeline --name <pipeline-name>

    Dalam konfigurasi tindakan untuk CodeBuild tindakan, Anda dapat melihat variabel:

    { "name": "Build", "actions": [ { "outputArtifacts": [ { "name": "BuildArtifact" } ], "name": "Build", "configuration": { "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]", "ProjectName": "env-var-test" }, "inputArtifacts": [ { "name": "SourceArtifact" } ], "region": "us-west-2", "actionTypeId": { "provider": "CodeBuild", "category": "Build", "version": "1", "owner": "AWS" }, "runOrder": 1 } ] },

Contoh: Gunakan variabel dalam persetujuan manual

Ketika Anda menentukan namespace untuk tindakan, dan tindakan yang menghasilkan variabel output, Anda dapat menambahkan persetujuan manual yang menampilkan variabel dalam pesan persetujuan. Contoh ini menunjukkan cara menambahkan sintaks variabel ke pesan persetujuan manual.

  1. Masuk keAWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

    Nama-nama dari semua alur yang terkait denganAWS akun Anda akan ditampilkan. Pilih alur yang ingin Anda tambahkan persetujuan.

  2. Untuk mengedit pipeline, pilih Edit. Tambahkan persetujuan manual setelah tindakan sumber. Di Nama tindakan, masukkan nama tindakan persetujuan.

  3. Di Penyedia tindakan, pilih Persetujuan manual.

  4. Di URL untuk ditinjau, tambahkan sintaks variabelCommitId untuk CodeCommit URL Anda. Pastikan Anda menggunakan namespace yang ditetapkan untuk tindakan sumber Anda. Misalnya, sintaks variabel untuk CodeCommit tindakan dengan namespace defaultSourceVariables adalah#{SourceVariables.CommitId}.

    Di Komentar, diCommitMessage, masukkan pesan komit:

    Please approve this change. Commit message: #{SourceVariables.CommitMessage}
  5. Setelah pipeline berjalan dengan sukses, Anda dapat melihat nilai variabel dalam pesan persetujuan.

Contoh: Gunakan BranchName variabel dengan variabel CodeBuild lingkungan

Saat menambahkan CodeBuild tindakan ke pipeline, Anda dapat menggunakan variabel CodeBuild lingkungan untuk mereferensikan variabelBranchName keluaran dari aksi sumber hulu. Dengan variabel keluaran dari tindakan CodePipeline, Anda dapat membuat variabel CodeBuild lingkungan Anda sendiri untuk digunakan dalam perintah build Anda.

Contoh ini menunjukkan cara menambahkan sintaks variabel keluaran dari aksi GitHub sumber ke variabel CodeBuild lingkungan. Sintaks variabel output dalam contoh ini merupakan variabel output aksi GitHub sumber untukBranchName. Setelah tindakan berjalan dengan sukses, variabel memutuskan untuk menunjukkan nama GitHub cabang.

  1. Masuk keAWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

    Nama-nama dari semua alur yang terkait denganAWS akun Anda akan ditampilkan. Pilih alur yang ingin Anda tambahkan persetujuan.

  2. Untuk mengedit pipeline, pilih Edit. Di panggung yang berisi CodeBuild tindakan Anda, pilih Edit stage.

  3. Pilih ikon untuk mengedit CodeBuild tindakan Anda.

  4. Pada halaman tindakan Edit, di bawah variabel lingkungan, masukkan berikut ini:

    • Di Nama, masukkan nama untuk variabel lingkungan Anda.

    • Di Value, masukkan sintaks variabel untuk variabel output pipeline Anda, yang mencakup namespace yang ditetapkan ke aksi sumber Anda. Misalnya, sintaks variabel keluaran untuk GitHub tindakan dengan namespace defaultSourceVariables adalah#{SourceVariables.BranchName}.

    • Di Tipe, pilih Plaintext.

  5. Setelah pipeline berjalan dengan sukses, Anda dapat melihat bagaimana variabel output yang diselesaikan adalah nilai dalam variabel lingkungan. Pilih salah satu dari berikut:

    • CodePipeline console: Pilih pipeline Anda, lalu pilih History. Pilih eksekusi pipeline terbaru.

      • Di bawah Timeline, pilih pemilih untuk Sumber. Ini adalah tindakan sumber yang menghasilkan variabel GitHub output. Pilih Lihat detail eksekusi. Di bawah variabel Output, melihat daftar variabel output yang dihasilkan oleh tindakan ini.

      • Di bawah Timeline, pilih pemilih untuk Build. Ini adalah aksi build yang menentukan variabel CodeBuild lingkungan untuk proyek build Anda. Pilih Lihat detail eksekusi. Di bawah Konfigurasi tindakan, lihat variabel CodeBuild lingkungan Anda. Pilih Tampilkan konfigurasi yang diselesaikan. Nilai variabel lingkungan Anda adalah variabelBranchName keluaran yang diselesaikan dari aksi GitHub sumber. Dalam contoh ini, nilai diselesaikan adalahmain.

        Untuk informasi selengkapnya, lihat Tampilkan variabel (konsol).

    • CodeBuild console: Pilih proyek build Anda dan pilih tautan untuk build run Anda. Di bawah variabel Environment, variabel output yang diselesaikan adalah nilai untuk variabel CodeBuild lingkungan. Dalam contoh ini, variabel lingkungan Nama adalahBranchName dan Nilai adalah variabelBranchName keluaran yang diselesaikan dari aksi GitHub sumber. Dalam contoh ini, nilai diselesaikan adalahmain.