Menggunakan variabel yang telah ditentukan

Variabel yang telah ditentukan adalah pasangan nilai kunci yang dipancarkan oleh alur kerja secara otomatis, dan tersedia untuk Anda gunakan dalam tindakan alur kerja.

Anda dapat menggunakan variabel yang telah ditentukan dalam tindakan alur kerja apa pun.

Mereferensikan variabel yang telah ditentukan

Gunakan petunjuk berikut untuk referensi variabel yang telah ditentukan.

Prasyarat

Tentukan nama variabel yang telah ditentukan yang ingin Anda referensikan, sepertiCommitId. Untuk informasi selengkapnya, lihat Menentukan variabel standar mana yang dipancarkan alur kerja Anda.

Visual

Tidak tersedia. Pilih YAMG untuk melihat instruksi YAMG.

YAML

Untuk mereferensikan variabel yang telah ditentukan (editor YAMG)

1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

2. Pilih proyek Anda.

3. Di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.

4. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama alur kerja.

5. Pilih Edit.

6. Pilih YAMG.

7. Dalam CodeCatalyst tindakan, tambahkan referensi variabel yang telah ditentukan menggunakan sintaks berikut:

   ${action-group-name.action-name-or-WorkflowSource.variable-name}

   Ganti:

   • action-group-namedengan nama grup aksi.

     catatan

     Anda dapat menghilangkan action-group-namejika tidak ada grup tindakan, atau jika variabel dihasilkan oleh tindakan dalam grup tindakan yang sama.

   • action-name-or- WorkflowSource dengan:

     Nama tindakan yang mengeluarkan variabel.

     atau

     WorkflowSource, jika variabelnya adalah BranchName atau CommitId variabel.

   • variabel-nama dengan nama variabel.

   Sebagai contoh:

   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${MyFirstECSAction.cluster}

   Contoh lain:

   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${WorkflowSource.CommitId}

   Untuk contoh lainnya, lihat Contoh variabel yang telah ditentukan. Untuk informasi selengkapnya, lihat Alur kerja definisi YAMAL untuk tindakan Anda.

8. (Opsional) Pilih Validasi untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.

9. Pilih Komit, masukkan pesan komit, dan pilih Komit lagi.

Menentukan variabel standar mana yang dipancarkan alur kerja Anda

Anda dapat menentukan variabel standar mana yang dipancarkan alur kerja Anda dengan dua cara:

• Jalankan alur kerja sekali. Setelah proses selesai, variabel yang dipancarkan oleh alur kerja ditampilkan pada tab Variabel pada halaman rincian jalankan. Untuk informasi selengkapnya, lihat Melihat alur kerja menjalankan status dan detail.

• Konsultasikan Daftar variabel yang telah ditentukan. Referensi ini mencantumkan nama variabel (kunci) dan nilai untuk setiap variabel yang telah ditentukan.

catatan

Ukuran total maksimum variabel alur kerja tercantum dalamKuota untuk alur kerja. Jika ukuran total melebihi maksimum, tindakan yang terjadi setelah maksimum tercapai mungkin gagal.

Contoh variabel yang telah ditentukan

Contoh berikut menunjukkan cara mereferensikan variabel yang telah ditentukan dalam file definisi alur kerja.

Contoh

• Contoh: Mereferensikan variabel CommitId standar ""
• Contoh: Mereferensikan variabel BranchName standar ""

Contoh: Mereferensikan variabel CommitId standar ""

Contoh berikut menunjukkan kepada Anda bagaimana merujuk ke variabel yang CommitId telah ditentukan dalam MyBuildAction tindakan. CommitIdVariabel adalah output secara otomatis oleh CodeCatalyst.

Meskipun contoh menunjukkan variabel yang digunakan dalam aksi build, Anda dapat menggunakannya CommitId dalam tindakan apa pun.

MyBuildAction:
    Identifier: aws/build@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      Steps:
      #Build Docker image and tag it with a commit ID
        - Run: docker build -t image-repo/my-docker-image:latest .
        - Run: docker tag image-repo/my-docker-image:${WorkflowSource.CommitId}

Contoh: Mereferensikan variabel BranchName standar ""

Contoh berikut menunjukkan kepada Anda bagaimana merujuk ke variabel yang BranchName telah ditentukan dalam CDKDeploy tindakan. BranchNameVariabel adalah output secara otomatis oleh CodeCatalyst.

Meskipun contoh menunjukkan variabel yang digunakan dalam tindakan AWS CDK penerapan, Anda dapat menggunakan BranchName dalam tindakan apa pun.

CDKDeploy:
    Identifier: aws/cdk-deploy@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      StackName: app-stack-${WorkflowSource.BranchName}