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 untuk 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 rincian untuk setiap eksekusi tindakan untuk melihat nilai untuk setiap variabel output yang dihasilkan oleh tindakan dalam eksekusi waktu.

Untuk melihat contoh langkah demi langkah 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.

Mengkonfigurasi tindakan dengan variabel (konsol)

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

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

Cara membuat alur dengan variabel

  1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttp://console.aws.amazon.com/codesuite/codepipeline/home.

  2. MemiilihMembuat pipa. Masukkan nama untuk alur Anda, lalu pilihSelanjutnya.

  3. MasukSumber, diPenyedia, pilihCodeCommit. Pilih repositori CodeCommit dan cabang untuk tindakan sumber, dan kemudian pilihSelanjutnya.

  4. MasukMembangun, diPenyedia, pilihCodeBuild. Pilih nama proyek build CodeBuild yang ada atau pilihMembuat proyek. PadaMembuat proyek membangun, membuat proyek membangun, dan kemudian memilihKembali ke CodePipeline.

    Di bawahVariabel lingkungan, pilihMenambahkan variabel lingkungan. Sebagai contoh, masukkan ID eksekusi dengan sintaks variabel#{codepipeline.PipelineExecutionId}dan komit ID dengan sintaks variabel#{SourceVariables.CommitId}.

    catatan

    Anda dapat memasukkan sintaks variabel dalam bidang konfigurasi tindakan di wizard.

  5. Pilih Create (Buat).

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

    
                            Contoh: Layar Info Aksi

Mengedit namespace untuk tindakan yang ada

  1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttp://console.aws.amazon.com/codesuite/codepipeline/home.

  2. Pilih alur yang ingin Anda edit, lalu pilihMengedit. Untuk tahap sumber, pilihTahap edit. Tambahkan tindakan CodeCommit.

  3. PadaEdit tindakan, lihatNamespace variabelbidang. Jika tindakan yang ada dibuat sebelumnya atau tanpa menggunakan wizard, Anda harus menambahkan namespace. MasukNamespace variabel, masukkan nama namespace, lalu pilihSimpan.

Untuk melihat variabel output

  1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttp://console.aws.amazon.com/codesuite/codepipeline/home.

  2. Setelah pipa dibuat dan berjalan dengan sukses, Anda dapat melihat variabel padaDetail eksekusi tindakanhalaman. Untuk informasi, lihat Tampilkan variabel (konsol).

Mengkonfigurasi tindakan untuk variabel (CLI)

Bila Anda menggunakancreate-pipelineperintah untuk membuat pipa atauupdate-pipelineperintah untuk mengedit pipa, 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-langkah diBuat pipa di CodePipelineuntuk membuat alur menggunakan CLI. Mulai file input untuk menyediakancreate-pipelineperintah dengan--cli-input-jsonparameter. Dalam struktur pipa, tambahkannamespaceparameter dan menentukan 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. Di terminal (Linux, macOS, atau Unix) atau command prompt (Windows), jalankancreate-pipelineperintah dan buat alur.

    Panggil file yang Anda buat saat menjalankancreate-pipelineperintah. Misalnya:

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

Untuk mengkonfigurasi tindakan hilir untuk mengkonsumsi variabel

  1. Mengedit file input untuk menyediakanupdate-pipelineperintah dengan--cli-input-jsonparameter. Dalam tindakan hilir, tambahkan variabel ke konfigurasi untuk tindakan itu. Variabel terdiri dari namespace dan key, dipisahkan oleh periode. Misalnya, untuk menambahkan variabel untuk ID eksekusi pipa dan ID komit sumber, tentukan namespacecodepipelineuntuk variabel#{codepipeline.PipelineExecutionId}. Tentukan namespaceSourceVariablesuntuk 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. Di terminal (Linux, macOS, atau Unix) atau command prompt (Windows), jalankancreate-pipelineperintah dan buat alur.

    Panggil file yang Anda buat saat menjalankancreate-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 untuk melihat variabel untuk tindakan.

  1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttp://console.aws.amazon.com/codesuite/codepipeline/home.

    Nama-nama semua jaringan pipa yang terkait dengan AndaAWSakun ditampilkan.

  2. MasukNama, pilih nama alur.

  3. MemiilihMelihat riwayat.

  4. Setelah pipa berjalan dengan sukses, Anda dapat melihat variabel yang dihasilkan oleh aksi sumber. MemiilihMelihat riwayat. MemiilihSumberdalam daftar tindakan untuk eksekusi pipa untuk melihat rincian eksekusi tindakan untuk tindakan CodeCommit. Pada layar detail tindakan, lihat variabel di bawahVariabel keluaran.

    
                            Contoh: Variabel output sumber
  5. Setelah pipa berjalan dengan sukses, Anda dapat melihat variabel yang dikonsumsi oleh aksi build. MemiilihMelihat riwayat. Dalam daftar tindakan untuk eksekusi pipa, pilihMembangununtuk melihat rincian eksekusi tindakan untuk tindakan CodeBuild. Pada halaman detail tindakan, lihat variabel di bawahKonfigurasi tindakan. Namespace otomatis yang dihasilkan ditampilkan.

    
                            Contoh: Variabel konfigurasi

    Secara default,Konfigurasi tindakanmenampilkan sintaks variabel. Anda dapat memilihTampilkan konfigurasi yang telah diselesaikanuntuk beralih daftar untuk menampilkan nilai-nilai yang dihasilkan selama eksekusi tindakan.

    
                            Contoh: Variabel Konfigurasi Aksi Terselesaikan

Melihat variabel (CLI)

Anda dapat menggunakanlist-action-executionsperintah untuk melihat variabel untuk tindakan.

  1. Gunakan perintah berikut:

    aws codepipeline list-action-executions

    Output menunjukkanoutputVariablesparameter 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 tindakan CodeBuild, 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 Consoledan buka konsol CodePipeline dihttp://console.aws.amazon.com/codesuite/codepipeline/home.

    Nama-nama semua jaringan pipa yang terkait dengan AndaAWSakun ditampilkan. Pilih alur yang ingin Anda tambahkan persetujuan.

  2. Untuk mengedit pipa Anda, pilihMengedit. Tambahkan persetujuan manual setelah tindakan sumber. MasukNama tindakan, masukkan nama tindakan persetujuan.

  3. MasukPenyedia tindakan, pilihPersetujuan manual.

  4. MasukURL untuk ditinjau, tambahkan sintaks variabel untukCommitIdke URL CodeCommit Anda. Pastikan Anda menggunakan namespace yang ditetapkan ke tindakan sumber Anda. Misalnya, sintaks variabel untuk tindakan CodeCommit dengan namespace defaultSourceVariablesadalah#{SourceVariables.CommitId}.

    MasukKomentar, diCommitMessage, masukkan pesan komit:

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

Contoh: Menggunakan variabel BranchName dengan variabel lingkungan CodeBuild

Ketika Anda menambahkan tindakan CodeBuild ke pipeline Anda, Anda dapat menggunakan variabel lingkungan CodeBuild untuk referensiBranchNamevariabel output dari tindakan sumber hulu. Dengan variabel output dari tindakan di CodePipeline, Anda dapat membuat variabel lingkungan CodeBuild Anda sendiri untuk digunakan dalam perintah build Anda.

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

  1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttp://console.aws.amazon.com/codesuite/codepipeline/home.

    Nama-nama semua jaringan pipa yang terkait dengan AndaAWSakun ditampilkan. Pilih alur yang ingin Anda tambahkan persetujuan.

  2. Untuk mengedit pipa Anda, pilihMengedit. Di panggung yang berisi tindakan CodeBuild Anda, pilihTahap edit.

  3. Pilih ikon untuk mengedit tindakan CodeBuild Anda.

  4. PadaEdit tindakanhalaman, di bawahVariabel lingkungan, masukkan yang berikut ini:

    • MasukNama, masukkan nama untuk variabel lingkungan Anda.

    • MasukNilai, masukkan sintaks variabel untuk variabel output pipa Anda, yang mencakup namespace yang ditetapkan untuk tindakan sumber Anda. Misalnya, sintaks variabel output untuk tindakan GitHub dengan namespace defaultSourceVariablesadalah#{SourceVariables.BranchName}.

    • MasukJenis, pilihTeks biasa.

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

    • Konsol CodePipeline: Pilih alur Anda, lalu pilihRiwayat. Pilih eksekusi pipa terbaru.

      • Di bawahTimeline, pilih pemilih untukSumber. Ini adalah tindakan sumber yang menghasilkan variabel output GitHub. MemiilihMelihat detail eksekusi. Di bawahVariabel keluaran, melihat daftar variabel output yang dihasilkan oleh tindakan ini.

      • Di bawahTimeline, pilih pemilih untukMembangun. Ini adalah aksi build yang menentukan variabel lingkungan CodeBuild untuk proyek build Anda. MemiilihMelihat detail eksekusi. Di bawahKonfigurasi tindakan, lihat variabel lingkungan CodeBuild Anda. MemiilihTampilkan konfigurasi yang telah diselesaikan. Nilai variabel lingkungan Anda adalah terselesaikanBranchNamevariabel output dari aksi sumber GitHub. Dalam contoh ini, nilai terselesaikan adalahmain.

        Untuk informasi selengkapnya, lihat Tampilkan variabel (konsol).

    • Konsol CodeBuild: Pilih proyek build Anda dan pilih tautan untuk build run Anda. Di bawahVariabel lingkungan, variabel output terselesaikan Anda adalah nilai untuk variabel lingkungan CodeBuild. Dalam contoh ini, variabel lingkunganNamaadalahBranchNamedanNilaiadalah teratasiBranchNamevariabel output dari aksi sumber GitHub. Dalam contoh ini, nilai terselesaikan adalahmain.