

Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).

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

# Menggunakan variabel dalam alur kerja
<a name="workflows-working-with-variables"></a>

 *Variabel* adalah pasangan kunci-nilai yang berisi informasi yang dapat Anda referensikan dalam alur kerja Amazon CodeCatalyst Anda. Bagian nilai variabel diganti dengan nilai aktual ketika alur kerja berjalan.

Ada dua jenis variabel yang dapat Anda gunakan dalam alur kerja:
+ **Variabel yang ditentukan pengguna** - Ini adalah pasangan nilai kunci yang Anda tentukan.
+ **Variabel yang telah ditentukan** - Ini adalah pasangan kunci-nilai yang dipancarkan oleh alur kerja secara otomatis. Tidak perlu bagi Anda untuk mendefinisikannya.

Untuk informasi lebih lanjut tentang alur kerja, lihat [Bangun, uji, dan terapkan dengan alur kerjaBangun, uji, dan terapkan dengan alur kerja](workflow.md).

**catatan**  
CodeCatalyst juga mendukung [parameter GitHub output](https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#setting-an-output-parameter), yang berperilaku seperti variabel dan dapat direferensikan dalam tindakan lain. Untuk informasi selengkapnya, lihat [Mengekspor parameter GitHub output](integrations-github-action-export.md) dan [Merujuk parameter GitHub keluaran](integrations-github-action-referencing.md)

**Topics**
+ [Menggunakan variabel yang ditentukan pengguna](workflows-using-variables.md)
+ [Menggunakan variabel yang telah ditentukan](workflows-using-predefined-variables.md)

# Menggunakan variabel yang ditentukan pengguna
<a name="workflows-using-variables"></a>

*Variabel yang ditentukan pengguna* adalah pasangan nilai kunci yang Anda tentukan. Ada dua jenis:
+ **Variabel teks biasa**, atau hanya **variabel** - Ini adalah pasangan nilai kunci yang Anda tentukan dalam teks biasa dalam file definisi alur kerja.
+ **Rahasia** — Ini adalah pasangan nilai kunci yang Anda tentukan di halaman **Rahasia** terpisah di konsol Amazon CodeCatalyst . *Kunci* (nama) adalah label publik, dan *nilainya* berisi informasi yang ingin Anda jaga kerahasiaannya. Anda hanya menentukan kunci dalam file definisi alur kerja. Gunakan rahasia sebagai pengganti kata sandi dan informasi sensitif lainnya dalam file definisi alur kerja.

**catatan**  
Untuk singkatnya, panduan ini menggunakan istilah *variabel untuk berarti variabel* *plaintext*.

Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).

**Topics**
+ [Contoh variabel](workflows-working-with-variables-ex.md)
+ [Mendefinisikan variabel](workflows-working-with-variables-define-input.md)
+ [Mendefinisikan rahasia](workflows-working-with-variables-define-secret.md)
+ [Mengekspor variabel sehingga tindakan lain dapat menggunakannya](workflows-working-with-variables-export-input.md)
+ [Merujuk variabel dalam tindakan yang mendefinisikannya](workflows-working-with-variables-reference-input.md)
+ [Mereferensikan output variabel dengan tindakan lain](workflows-working-with-variables-reference-action.md)
+ [Mereferensikan rahasia](workflows-working-with-variables-reference-secret.md)

# Contoh variabel
<a name="workflows-working-with-variables-ex"></a>

Contoh berikut menunjukkan bagaimana mendefinisikan dan referensi variabel dalam file definisi alur kerja.

Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).

**Topics**
+ [Contoh: Mendefinisikan variabel menggunakan properti Input](#workflows-working-with-variables-ex-define-inputs)
+ [Contoh: Mendefinisikan variabel menggunakan properti Steps](#workflows-working-with-variables-ex-define-steps)
+ [Contoh: Mengekspor variabel menggunakan properti Output](#workflows-working-with-variables-ex-export-outputs)
+ [Contoh: Mereferensikan variabel yang didefinisikan dalam tindakan yang sama](#workflows-working-with-variables-ex-refer-current)
+ [Contoh: Mereferensikan variabel yang didefinisikan dalam tindakan lain](#workflows-working-with-variables-ex-refer-other)
+ [Contoh: Mereferensikan rahasia](#workflows-working-with-variables-ex-refer-secret)

## Contoh: Mendefinisikan variabel menggunakan properti Input
<a name="workflows-working-with-variables-ex-define-inputs"></a>

Contoh berikut menunjukkan kepada Anda bagaimana mendefinisikan dua variabel, `VAR1` dan`VAR2`, di `Inputs` bagian.

```
Actions:
  Build:
    Identifier: aws/build@v1
    Inputs:
      Variables:
      - Name: VAR1
        Value: "My variable 1"
      - Name: VAR2
        Value: "My variable 2"
```

## Contoh: Mendefinisikan variabel menggunakan properti Steps
<a name="workflows-working-with-variables-ex-define-steps"></a>

Contoh berikut menunjukkan kepada Anda bagaimana mendefinisikan `DATE` variabel di `Steps` bagian secara eksplisit.

```
Actions:
  Build:
    Identifier: aws/build@v1
    Configuration:    
      Steps:
        - Run: DATE=$(date +%m-%d-%y)
```

## Contoh: Mengekspor variabel menggunakan properti Output
<a name="workflows-working-with-variables-ex-export-outputs"></a>

Contoh berikut menunjukkan kepada Anda bagaimana mendefinisikan dua variabel, `REPOSITORY-URI` dan`TIMESTAMP`, dan mengekspornya menggunakan `Outputs` bagian.

```
Actions:
  Build:
    Identifier: aws/build@v1
    Inputs:
      Variables:
        - Name: REPOSITORY-URI
          Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo
    Configuration:
      Steps:
        - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) 
    Outputs:
      Variables:
        - REPOSITORY-URI
        - TIMESTAMP
```

## Contoh: Mereferensikan variabel yang didefinisikan dalam tindakan yang sama
<a name="workflows-working-with-variables-ex-refer-current"></a>

Contoh berikut menunjukkan cara menentukan `VAR1` variabel dalam`MyBuildAction`, dan kemudian referensi dalam tindakan yang sama menggunakan`$VAR1`.

```
Actions:
  MyBuildAction:
    Identifier: aws/build@v1
    Inputs:
      Variables:
        - Name: VAR1
          Value: my-value
    Configuration:
      Steps:
        - Run: $VAR1
```

## Contoh: Mereferensikan variabel yang didefinisikan dalam tindakan lain
<a name="workflows-working-with-variables-ex-refer-other"></a>

Contoh berikut menunjukkan cara menentukan `TIMESTAMP` variabel`BuildActionA`, mengekspornya menggunakan `Outputs` properti, dan kemudian mereferensikannya dalam `BuildActionB` menggunakan`${BuildActionA.TIMESTAMP}`.

```
Actions:
  BuildActionA:
    Identifier: aws/build@v1
    Configuration:    
      Steps:
        - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) 
    Outputs:
      Variables:
        - TIMESTAMP
  BuildActionB:
    Identifier: aws/build@v1
    Configuration:
      Steps:
        - Run: docker build -t my-ecr-repo/image-repo:latest .      
        - Run: docker tag my-ecr-repo/image-repo:${BuildActionA.TIMESTAMP}
        
        # Specifying just '$TIMESTAMP' here will not work 
        # because TIMESTAMP is not a variable 
        # in the BuildActionB action.
```

## Contoh: Mereferensikan rahasia
<a name="workflows-working-with-variables-ex-refer-secret"></a>

Contoh berikut menunjukkan kepada Anda cara mereferensikan `my-password` rahasia. `my-password`Itu adalah kunci rahasianya. Kunci rahasia ini dan nilai kata sandi yang sesuai harus ditentukan pada halaman **Rahasia** CodeCatalyst konsol sebelum digunakan dalam file definisi alur kerja. Lihat informasi yang lebih lengkap di [Menyembunyikan data menggunakan rahasia](workflows-secrets.md).

```
Actions:
  BuildActionA:
    Identifier: aws/build@v1
    Configuration:    
      Steps:
        - Run: curl -u LiJuan:${Secrets.my-password} https://example.com
```

# Mendefinisikan variabel
<a name="workflows-working-with-variables-define-input"></a>

Anda dapat menentukan variabel dengan dua cara:
+ Di `Inputs` bagian tindakan alur kerja - lihat [Untuk menentukan variabel di bagian 'Input](#workflows-to-define-variable-input)'
+ Di `Steps` bagian tindakan alur kerja - lihat [Untuk menentukan variabel di bagian 'Langkah-langkah'](#workflows-to-define-variable-steps)
**catatan**  
`Steps`Metode ini hanya berfungsi dengan **GitHub tindakan CodeCatalyst ** build, test, dan Actions, karena ini adalah satu-satunya tindakan yang menyertakan `Steps` bagian.

Sebagai contoh, lihat [Contoh variabel](workflows-working-with-variables-ex.md).

Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).

------
#### [ Visual ]

**Untuk menentukan variabel di bagian 'Input' (editor visual)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **Visual**.

1. Dalam diagram alur kerja, pilih tindakan di mana Anda ingin mengatur variabel.

1. Pilih **Input**.

1. Dalam **Variabel - opsional**, pilih **Tambahkan variabel**, dan kemudian lakukan hal berikut:

   Tentukan urutan name/value pasangan yang menentukan variabel input yang ingin Anda sediakan untuk tindakan. Nama variabel terbatas pada karakter alfanumerik (a-z, A-Z, 0-9), tanda hubung (-), dan garis bawah (\$1). Spasi tidak diizinkan. Anda tidak dapat menggunakan tanda kutip untuk mengaktifkan karakter dan spasi khusus dalam nama variabel.

   Untuk informasi selengkapnya tentang variabel, termasuk contoh, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).

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

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------
#### [ YAML ]

**Untuk menentukan variabel di bagian 'Input' (editor YAMAL)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **YAMAL.**

1. Dalam tindakan alur kerja, tambahkan kode yang mirip dengan berikut ini:

   ```
   action-name:
     Inputs:
       Variables:
         - Name: variable-name
           Value: variable-value
   ```

   Untuk contoh lainnya, lihat [Contoh variabel](workflows-working-with-variables-ex.md). Untuk informasi selengkapnya, lihat [Alur kerja definisi YAMAL](workflow-reference.md) untuk tindakan Anda.

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

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------

------
#### [ Visual ]

**Untuk menentukan variabel di bagian 'Langkah' (editor visual)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **Visual**.

1. Dalam diagram alur kerja, pilih tindakan di mana Anda ingin mengatur variabel.

1. Pilih **Konfigurasi**.

1. Dalam **perintah Shell** atau **GitHubActions YAMAL**, mana pun yang tersedia, tentukan variabel dalam tindakan, baik secara eksplisit maupun `Steps` implisit.
   + Untuk mendefinisikan variabel secara eksplisit, sertakan dalam perintah bash langsung ke bagian. `Steps`
   + Untuk mendefinisikan variabel secara implisit, tentukan dalam file yang direferensikan di bagian tindakan. `Steps`

     Sebagai contoh, lihat [Contoh variabel](workflows-working-with-variables-ex.md). Untuk informasi lebih lanjut, lihat [Alur kerja definisi YAMAL](workflow-reference.md) untuk tindakan.

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

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------
#### [ YAML ]

**Untuk menentukan variabel di bagian 'Langkah' (editor YAMAL)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **YAMAL.**

1. Dalam tindakan alur kerja, tentukan variabel di `Steps` bagian tindakan, baik secara eksplisit maupun implisit.
   + Untuk mendefinisikan variabel secara eksplisit, sertakan dalam perintah bash langsung ke bagian. `Steps`
   + Untuk mendefinisikan variabel secara implisit, tentukan dalam file yang direferensikan di bagian tindakan. `Steps`

     Sebagai contoh, lihat [Contoh variabel](workflows-working-with-variables-ex.md). Untuk informasi lebih lanjut, lihat [Alur kerja definisi YAMAL](workflow-reference.md) untuk tindakan.

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

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------

# Mendefinisikan rahasia
<a name="workflows-working-with-variables-define-secret"></a>

Anda mendefinisikan rahasia di halaman **Rahasia** CodeCatalyst konsol. Untuk informasi selengkapnya, lihat [Menyembunyikan data menggunakan rahasia](workflows-secrets.md).

Misalnya, Anda mungkin mendefinisikan rahasia yang terlihat seperti ini:
+ Nama (kunci): **my-password**
+ Nilai: **^\$1H3\$1\$1b9**

Setelah rahasia didefinisikan, Anda dapat menentukan kunci rahasia (**my-password**) dalam file definisi alur kerja. Untuk contoh cara melakukannya, lihat [Contoh: Mereferensikan rahasia](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret).

# Mengekspor variabel sehingga tindakan lain dapat menggunakannya
<a name="workflows-working-with-variables-export-input"></a>

Gunakan petunjuk berikut untuk mengekspor variabel dari tindakan sehingga Anda dapat mereferensikannya dalam tindakan lain.

Sebelum Anda mengekspor variabel, perhatikan hal berikut:
+ Jika Anda hanya perlu mereferensikan variabel dalam tindakan yang ditentukan, maka Anda tidak perlu mengekspornya.
+ Tidak semua tindakan mendukung variabel ekspor. Untuk menentukan apakah tindakan Anda mendukung fitur ini, jalankan melalui instruksi editor visual yang mengikuti, dan lihat apakah tindakan menyertakan tombol **Variabel** pada tab **Output**. Jika ya, variabel ekspor didukung. 
+ Untuk mengekspor variabel dari GitHub Action, lihat[Mengekspor parameter GitHub output](integrations-github-action-export.md).

Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).

**Prasyarat**  
Pastikan Anda telah menentukan variabel yang ingin Anda ekspor. Untuk informasi selengkapnya, lihat [Mendefinisikan variabel](workflows-working-with-variables-define-input.md).

------
#### [ Visual ]

**Untuk mengekspor variabel (editor visual)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **Visual**.

1. Dalam diagram alur kerja, pilih tindakan yang ingin Anda ekspor variabelnya.

1. Pilih **Output**.

1. Dalam **Variabel - opsional**, pilih **Tambahkan variabel**, dan kemudian lakukan hal berikut:

   Tentukan nama variabel yang ingin Anda ekspor tindakan. Variabel ini harus sudah didefinisikan dalam `Inputs` atau `Steps` bagian dari tindakan yang sama.

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMM alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------
#### [ YAML ]

**Untuk mengekspor variabel (editor YAMM)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **YAMAL.**

1. Dalam tindakan yang ingin Anda ekspor variabel dari, tambahkan kode yang mirip dengan berikut ini:

   ```
   action-name:
     Outputs:
       Variables:
         - Name: variable-name
   ```

   Untuk contoh lainnya, lihat [Contoh variabel](workflows-working-with-variables-ex.md).

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMM alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------

# Merujuk variabel dalam tindakan yang mendefinisikannya
<a name="workflows-working-with-variables-reference-input"></a>

Gunakan instruksi berikut untuk mereferensikan variabel dalam tindakan yang mendefinisikannya.

**catatan**  
Untuk mereferensikan variabel yang dihasilkan oleh GitHub Action, lihat[Merujuk parameter GitHub keluaran](integrations-github-action-referencing.md).

Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).

**Prasyarat**  
Pastikan Anda telah menentukan variabel yang ingin Anda referensikan. Untuk informasi selengkapnya, lihat [Mendefinisikan variabel](workflows-working-with-variables-define-input.md).

------
#### [ Visual ]

*Tidak tersedia. Pilih YAMAL untuk melihat instruksi YAMAL.*

------
#### [ YAML ]

**Untuk mereferensikan variabel dalam tindakan yang mendefinisikannya**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **YAMAL.**

1. Dalam CodeCatalyst tindakan yang mendefinisikan variabel yang ingin Anda rujuk, tambahkan variabel menggunakan sintaks bash berikut:

   ```
   $variable-name
   ```

   Contoh:

   ```
   MyAction:
       Configuration:
         Steps:
           - Run: $variable-name
   ```

   Untuk contoh lainnya, lihat [Contoh variabel](workflows-working-with-variables-ex.md). Untuk informasi selengkapnya, lihat informasi referensi untuk tindakan Anda di[Alur kerja definisi YAMAL](workflow-reference.md).

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

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------

# Mereferensikan output variabel dengan tindakan lain
<a name="workflows-working-with-variables-reference-action"></a>

Gunakan instruksi berikut untuk referensi variabel output oleh tindakan lain.

**catatan**  
 Untuk mereferensikan output variabel dari GitHub Action, lihat[Merujuk parameter GitHub keluaran](integrations-github-action-referencing.md).

Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).

**Prasyarat**  
Pastikan Anda telah mengekspor variabel yang ingin Anda referensikan. Untuk informasi selengkapnya, lihat [Mengekspor variabel sehingga tindakan lain dapat menggunakannya](workflows-working-with-variables-export-input.md).

------
#### [ Visual ]

*Tidak tersedia. Pilih YAMG untuk melihat instruksi YAMG.*

------
#### [ YAML ]

**Untuk mereferensikan output variabel dengan tindakan lain (editor YAMG)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **YAMAL.**

1. Dalam CodeCatalyst tindakan, tambahkan referensi ke variabel menggunakan sintaks berikut:

   ```
   ${action-group-name.action-name.variable-name}
   ```

   Ganti:
   + *action-group-name*dengan nama grup aksi yang berisi tindakan yang menghasilkan variabel.
**catatan**  
Anda dapat menghilangkan *action-group-name* jika tidak ada grup tindakan, atau jika variabel dihasilkan oleh tindakan dalam grup tindakan yang sama.
   + *action-name*dengan nama tindakan yang mengeluarkan variabel.
   + *variable-name*dengan nama variabel.

   Contoh:

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: ${MyFirstAction.TIMESTAMP}
   ```

   Untuk contoh lainnya, lihat [Contoh variabel](workflows-working-with-variables-ex.md). Untuk informasi selengkapnya, lihat [Alur kerja definisi YAMAL](workflow-reference.md) untuk tindakan Anda.

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

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------

# Mereferensikan rahasia
<a name="workflows-working-with-variables-reference-secret"></a>

Untuk petunjuk tentang mereferensikan rahasia dalam file definisi alur kerja, lihat. [Menggunakan rahasia](workflows-secrets.using.md)

Sebagai contoh, lihat [Contoh: Mereferensikan rahasia](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret).

# Menggunakan variabel yang telah ditentukan
<a name="workflows-using-predefined-variables"></a>

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

Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).

**Topics**
+ [Contoh referensi variabel yang telah ditentukan](workflows-predefined-examples.md)
+ [Merujuk variabel yang telah ditentukan](workflows-working-with-variables-reference-output-vars.md)
+ [Menentukan variabel standar mana yang dipancarkan alur kerja Anda](workflows-working-with-variables-determine-output-vars.md)
+ [Daftar variabel yang telah ditentukan](workflow-ref-action-variables.md)

# Contoh referensi variabel yang telah ditentukan
<a name="workflows-predefined-examples"></a>

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

Untuk informasi selengkapnya tentang variabel yang telah ditentukan, lihat[Menggunakan variabel yang telah ditentukan](workflows-using-predefined-variables.md).

**Topics**
+ [Contoh: Mereferensikan variabel CommitId standar ""](#workflows-working-with-variables-ex-refer-action)
+ [Contoh: Mereferensikan variabel BranchName standar ""](#workflows-working-with-variables-ex-branch)

## Contoh: Mereferensikan variabel CommitId standar ""
<a name="workflows-working-with-variables-ex-refer-action"></a>

Contoh berikut menunjukkan kepada Anda bagaimana merujuk ke variabel yang `CommitId` telah ditentukan dalam `MyBuildAction` tindakan. `CommitId`Variabel adalah output secara otomatis oleh CodeCatalyst. Untuk informasi selengkapnya, lihat [Daftar variabel yang telah ditentukan](workflow-ref-action-variables.md).

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 ""
<a name="workflows-working-with-variables-ex-branch"></a>

Contoh berikut menunjukkan kepada Anda bagaimana merujuk ke variabel yang `BranchName` telah ditentukan dalam `CDKDeploy` tindakan. `BranchName`Variabel adalah output secara otomatis oleh CodeCatalyst. Untuk informasi selengkapnya, lihat [Daftar variabel yang telah ditentukan](workflow-ref-action-variables.md).

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

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

# Merujuk variabel yang telah ditentukan
<a name="workflows-working-with-variables-reference-output-vars"></a>

Anda dapat mereferensikan variabel yang telah ditentukan dalam tindakan apa pun dalam CodeCatalyst alur kerja Amazon.

Gunakan petunjuk berikut untuk referensi variabel yang telah ditentukan dalam alur kerja.

Untuk informasi selengkapnya tentang variabel yang telah ditentukan, lihat[Menggunakan variabel yang telah ditentukan](workflows-using-predefined-variables.md).

**Prasyarat**  
Tentukan nama variabel standar yang ingin Anda referensikan, seperti`CommitId`. Untuk informasi selengkapnya, lihat [Menentukan variabel standar mana yang dipancarkan alur kerja Anda](workflows-working-with-variables-determine-output-vars.md).

------
#### [ 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/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

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

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

1. Pilih **Edit**.

1. Pilih **YAMG.**

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

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

   Ganti:
   + *action-group-name*dengan nama grup aksi.
**catatan**  
Anda dapat menghilangkan *action-group-name* jika 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.
   + *variable-name*dengan nama variabel.

   Contoh:

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

   Contoh lain:

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

   Untuk contoh lainnya, lihat [Contoh referensi variabel yang telah ditentukan](workflows-predefined-examples.md). Untuk informasi selengkapnya, lihat [Alur kerja definisi YAMAL](workflow-reference.md) untuk tindakan Anda.

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

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------

# Menentukan variabel standar mana yang dipancarkan alur kerja Anda
<a name="workflows-working-with-variables-determine-output-vars"></a>

Gunakan prosedur berikut untuk menentukan variabel standar mana yang dipancarkan alur kerja saat dijalankan. Anda kemudian dapat mereferensikan variabel-variabel ini dalam alur kerja yang sama. 

Untuk informasi selengkapnya tentang variabel yang telah ditentukan, lihat[Menggunakan variabel yang telah ditentukan](workflows-using-predefined-variables.md).

**Untuk menentukan variabel yang telah ditentukan yang dipancarkan alur kerja Anda**
+ Lakukan salah satu tindakan berikut:
  + **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 status dan detail alur kerja](workflows-view-run.md).
  + **Konsultasikan [Daftar variabel yang telah ditentukan](workflow-ref-action-variables.md)**. Referensi ini mencantumkan nama variabel (kunci) dan nilai untuk setiap variabel yang telah ditentukan.

**catatan**  
Ukuran total maksimum variabel alur kerja tercantum dalam[Kuota untuk alur kerja di CodeCatalyst](workflows-quotas.md). Jika ukuran total melebihi maksimum, tindakan yang terjadi setelah maksimum tercapai mungkin gagal.

# Daftar variabel yang telah ditentukan
<a name="workflow-ref-action-variables"></a>

Konsultasikan bagian berikut untuk melihat variabel yang telah ditentukan yang dihasilkan secara otomatis oleh CodeCatalyst tindakan sebagai bagian dari alur kerja yang dijalankan.

Untuk informasi selengkapnya tentang variabel yang telah ditentukan, lihat[Menggunakan variabel yang telah ditentukan](workflows-using-predefined-variables.md).

**catatan**  
[Daftar ini hanya mencakup variabel standar yang dipancarkan oleh CodeCatalyst sumber dan tindakan. CodeCatalyst ](workflows-actions.md#workflows-actions-types) Jika Anda menggunakan jenis tindakan lain, seperti Tindakan atau GitHub tindakan CodeCatalyst Labs, lihat sebagai gantinya[Menentukan variabel standar mana yang dipancarkan alur kerja Anda](workflows-working-with-variables-determine-output-vars.md).

**Daftar**

**catatan**  
Tidak semua CodeCatalyst tindakan menghasilkan variabel yang telah ditentukan. Jika tindakan tidak ada dalam daftar, maka itu tidak menghasilkan variabel.
+ [Variabel BranchName '' dan CommitId ''](workflows-sources-variables.md)
+ [Variabel 'Menyebarkan tumpukan' CloudFormation](deploy-action-cfn-variables.md)
+ [Variabel 'Terapkan ke Amazon ECS'](deploy-action-ecs-variables.md)
+ [Variabel 'Terapkan ke klaster Kubernetes'](deploy-action-eks-variables.md)
+ [variabel 'AWS CDK penyebaran'](cdk-dep-action-variables.md)
+ [Variabel 'AWS CDK bootstrap'](cdk-boot-action-variables.md)
+ [variabel 'AWS Lambda pemanggilan'](lam-invoke-action-variables.md)
+ [Variabel 'Render definisi tugas Amazon ECS'](render-ecs-action-variables.md)