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 yang ditentukan pengguna *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 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 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 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 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 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 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 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 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 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 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 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 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 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).