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. # Berbagi artefak dan file antar tindakan *Artefak* adalah output dari tindakan alur kerja, dan biasanya terdiri dari folder atau arsip file. Artefak penting karena memungkinkan Anda berbagi file dan informasi antar tindakan. Misalnya, Anda mungkin memiliki tindakan build yang *menghasilkan* `sam-template.yml` file, tetapi Anda ingin tindakan penerapan *menggunakannya*. Dalam skenario ini, Anda akan menggunakan artefak untuk memungkinkan tindakan build membagikan `sam-template.yml` file dengan tindakan penerapan. Kodenya mungkin terlihat seperti ini: ``` Actions: BuildAction: Identifier: aws/build@v1 Steps: - Run: sam package --output-template-file sam-template.yml Outputs: Artifacts: - Name: MYARTIFACT Files: - sam-template.yml DeployAction: Identifier: aws/cfn-deploy@v1 Inputs: Artifacts: - MYARTIFACT Configuration: template: sam-template.yml ``` Dalam kode sebelumnya, build action (`BuildAction`) menghasilkan `sam-template.yml` file, dan kemudian menambahkannya ke artefak keluaran yang disebut`MYARTIFACT`. Tindakan penerapan berikutnya (`DeployAction`) menentukan `MYARTIFACT` sebagai input, memberikannya akses ke file. `sam-template.yml` **Topics** + [Dapatkah saya membagikan artefak tanpa menentukannya sebagai output dan input?](#workflows-working-artifacts-share) + [Bisakah saya berbagi artefak antar alur kerja?](#workflows-working-artifacts-share-wf) + [Contoh artefak](workflows-working-artifacts-ex.md) + [Mendefinisikan artefak keluaran](workflows-working-artifacts-output.md) + [Mendefinisikan artefak input](workflows-working-artifacts-refer.md) + [Mereferensikan file dalam artefak](workflows-working-artifacts-refer-files.md) + [Mengunduh artefak](workflows-download-workflow-outputs.md) ## Dapatkah saya membagikan artefak tanpa menentukannya sebagai output dan input? Ya, Anda dapat berbagi artefak antar tindakan tanpa menentukannya di `Outputs` dan `Inputs` bagian kode YAMM tindakan Anda. Untuk melakukan ini, Anda harus mengaktifkan berbagi komputasi. Untuk informasi selengkapnya tentang berbagi komputasi dan cara menentukan artefak saat dihidupkan, lihat. [Berbagi komputasi di seluruh tindakan](compute-sharing.md) **catatan** Meskipun fitur berbagi komputasi memungkinkan Anda menyederhanakan kode YAMM alur kerja Anda dengan menghilangkan kebutuhan untuk `Inputs` bagian `Outputs` dan, fitur ini memiliki batasan yang harus Anda ketahui sebelum Anda menyalakannya. Untuk informasi tentang keterbatasan ini, lihat[Pertimbangan untuk berbagi komputasi](compute-sharing.md#compare-compute-sharing). ## Bisakah saya berbagi artefak antar alur kerja? Tidak, Anda tidak dapat berbagi artefak di antara alur kerja yang berbeda; namun, Anda dapat berbagi artefak antar tindakan dalam alur kerja yang sama. # Contoh artefak Contoh berikut menunjukkan cara mengeluarkan, memasukkan, dan mereferensikan artefak dalam file definisi CodeCatalyst alur kerja Amazon. **Topics** + [Contoh: Menghasilkan artefak](#workflows-working-artifacts-ex-basic) + [Contoh: Memasukkan artefak yang dihasilkan oleh tindakan lain](#workflows-working-artifacts-ex-ref) + [Contoh: Merujuk file dalam beberapa artefak](#workflows-working-artifacts-ex-ref-file) + [Contoh: Mereferensikan file dalam satu artefak](#workflows-working-artifacts-ex-ref-file-one) + [Contoh: Mereferensikan file dalam artefak saat ada WorkflowSource](#workflows-working-artifacts-ex-ref-file-wf-source) + [Contoh: Mereferensikan file dalam artefak saat grup aksi hadir](#workflows-working-artifacts-ex-groups) ## Contoh: Menghasilkan artefak Contoh berikut menunjukkan bagaimana untuk output artefak yang mencakup dua file.jar. ``` Actions: Build: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ARTIFACT1 Files: - build-output/file1.jar - build-output/file2.jar ``` ## Contoh: Memasukkan artefak yang dihasilkan oleh tindakan lain Contoh berikut menunjukkan kepada Anda cara menampilkan artefak yang dipanggil `ARTIFACT4``BuildActionA`, dan memasukkannya ke dalam`BuildActionB`. ``` Actions: BuildActionA: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ARTIFACT4 Files: - build-output/file1.jar - build-output/file2.jar BuildActionB: Identifier: aws/build@v1 Inputs: Artifacts: - ARTIFACT4 Configuration: ``` ## Contoh: Merujuk file dalam beberapa artefak Contoh berikut menunjukkan kepada Anda cara menampilkan dua artefak bernama `ART5` dan `ART6` masuk`BuildActionC`, dan kemudian referensi dua file bernama `file5.txt` (dalam artefak`ART5`) dan `file6.txt` (dalam artefak`ART6`) di `BuildActionD` (bawah). `Steps` **catatan** Untuk informasi selengkapnya tentang referensi file, lihat[Mereferensikan file dalam artefak](workflows-working-artifacts-refer-files.md). **catatan** Meskipun contoh menunjukkan `$CATALYST_SOURCE_DIR_ART5` awalan yang digunakan, Anda bisa menghilangkannya. Ini karena `ART5` merupakan *masukan utama*. Untuk mempelajari lebih lanjut tentang input utama, lihat[Mereferensikan file dalam artefak](workflows-working-artifacts-refer-files.md). ``` Actions: BuildActionC: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ART5 Files: - build-output/file5.txt - Name: ART6 Files: - build-output/file6.txt BuildActionD: Identifier: aws/build@v1 Inputs: Artifacts: - ART5 - ART6 Configuration: Steps: - run: cd $CATALYST_SOURCE_DIR_ART5/build-output && cat file5.txt - run: cd $CATALYST_SOURCE_DIR_ART6/build-output && cat file6.txt ``` ## Contoh: Mereferensikan file dalam satu artefak Contoh berikut menunjukkan kepada Anda cara menampilkan satu artefak bernama `ART7``BuildActionE`, dan kemudian referensi `file7.txt` (dalam artefak`ART7`) di `BuildActionF` (bawah`Steps`). Perhatikan bagaimana referensi tidak memerlukan `$CATALYST_SOURCE_DIR_` *artifact-name* awalan di depan `build-output` direktori seperti yang terjadi di[Contoh: Merujuk file dalam beberapa artefak](#workflows-working-artifacts-ex-ref-file). Ini karena hanya ada satu item yang ditentukan di bawah`Inputs`. **catatan** Untuk informasi selengkapnya tentang referensi file, lihat[Mereferensikan file dalam artefak](workflows-working-artifacts-refer-files.md). ``` Actions: BuildActionE: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ART7 Files: - build-output/file7.txt BuildActionF: Identifier: aws/build@v1 Inputs: Artifacts: - ART7 Configuration: Steps: - run: cd build-output && cat file7.txt ``` ## Contoh: Mereferensikan file dalam artefak saat ada WorkflowSource Contoh berikut menunjukkan kepada Anda cara menampilkan satu artefak bernama `ART8``BuildActionG`, dan kemudian referensi `file8.txt` (dalam artefak`ART8`) di `BuildActionH` (bawah`Steps`). Perhatikan bagaimana referensi membutuhkan `$CATALYST_SOURCE_DIR_` *artifact-name* awalan, seperti yang terjadi di[Contoh: Merujuk file dalam beberapa artefak](#workflows-working-artifacts-ex-ref-file). Ini karena ada beberapa item yang ditentukan di bawah `Inputs` (sumber dan artefak), jadi Anda memerlukan awalan untuk menunjukkan di mana harus mencari file. **catatan** Untuk informasi selengkapnya tentang referensi file, lihat[Mereferensikan file dalam artefak](workflows-working-artifacts-refer-files.md). ``` Actions: BuildActionG: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ART8 Files: - build-output/file8.txt BuildActionH: Identifier: aws/build@v1 Inputs: Sources: - WorkflowSource Artifacts: - ART8 Configuration: Steps: - run: cd $CATALYST_SOURCE_DIR_ART8/build-output && cat file8.txt ``` ## Contoh: Mereferensikan file dalam artefak saat grup aksi hadir Contoh berikut menunjukkan kepada Anda cara menampilkan artefak bernama `ART9``ActionGroup1`,`ActionI`, dan kemudian referensi `file9.txt` (dalam artefak`ART9`) di. `ActionJ` Untuk informasi selengkapnya tentang referensi file, lihat[Mereferensikan file dalam artefak](workflows-working-artifacts-refer-files.md). ``` Actions: ActionGroup1: Actions: ActionI: Identifier: aws/build@v1 Outputs: Artifacts: - Name: ART9 Files: - build-output/file9.yml ActionJ: Identifier: aws/cfn-deploy@v1 Inputs: Sources: - WorkflowSource Artifacts: - ART9 Configuration: template: /artifacts/ActionGroup1@ActionJ/ART9/build-output/file9.yml ``` # Mendefinisikan artefak keluaran Gunakan petunjuk berikut untuk menentukan artefak yang Anda inginkan untuk menampilkan CodeCatalyst tindakan Amazon. Artefak ini kemudian tersedia untuk tindakan lain untuk digunakan. **catatan** Tidak semua tindakan mendukung artefak keluaran. Untuk menentukan apakah tindakan Anda mendukungnya, jalankan melalui instruksi editor visual yang mengikuti, dan lihat apakah tindakan tersebut menyertakan tombol **artefak Output** pada tab **Output**. Jika ya, artefak keluaran didukung. ------ #### [ Visual ] **Untuk menentukan artefak keluaran menggunakan 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 akan menghasilkan artefak. 1. Pilih tab **Output**. 1. Di bawah **Artefak**, pilih **Tambahkan artefak**. 1. Pilih **Tambahkan artefak**, dan masukkan informasi ke dalam bidang, sebagai berikut. **Bangun nama artefak** Tentukan nama artefak yang dihasilkan oleh tindakan. Nama artifak harus unik dalam alur kerja, dan terbatas pada karakter alfanumerik (a-z, A-Z, 0-9) dan garis bawah (\$1). Spasi, tanda hubung (-), dan karakter khusus lainnya tidak diperbolehkan. Anda tidak dapat menggunakan tanda kutip untuk mengaktifkan spasi, tanda hubung, dan karakter khusus lainnya dalam nama artefak keluaran. Untuk informasi selengkapnya tentang artefak, termasuk contoh, lihat[Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md). **File yang dihasilkan oleh build** Tentukan file yang CodeCatalyst termasuk dalam artefak yang dihasilkan oleh tindakan. File-file ini dihasilkan oleh tindakan alur kerja saat dijalankan, dan juga tersedia di repositori sumber Anda. Jalur file dapat berada di repositori sumber atau artefak dari tindakan sebelumnya, dan relatif terhadap repositori sumber atau root artefak. Anda dapat menggunakan pola glob untuk menentukan jalur. Contoh: + Untuk menentukan satu file yang ada di root lokasi build atau lokasi repositori sumber, gunakan. `my-file.jar` + Untuk menentukan satu file dalam subdirektori, gunakan `directory/my-file.jar` atau`directory/subdirectory/my-file.jar`. + Untuk menentukan semua file, gunakan`"**/*"`. Pola `**` glob menunjukkan untuk mencocokkan sejumlah subdirektori. + Untuk menentukan semua file dan direktori dalam direktori bernama`directory`, gunakan`"directory/**/*"`. Pola `**` glob menunjukkan untuk mencocokkan sejumlah subdirektori. + Untuk menentukan semua file dalam direktori bernama`directory`, tetapi tidak salah satu subdirektorinya, gunakan. `"directory/*"` **catatan** Jika jalur file Anda menyertakan satu atau beberapa tanda bintang (`*`) atau karakter khusus lainnya, lampirkan jalur dengan tanda kutip ganda (). `""` Untuk informasi lebih lanjut tentang karakter khusus, lihat[Pedoman dan konvensi sintaks](workflow-reference.md#workflow.terms.syntax.conv). Untuk informasi selengkapnya tentang artefak, termasuk contoh, lihat[Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md). **catatan** Anda mungkin perlu menambahkan awalan ke jalur file untuk menunjukkan artefak atau sumber mana yang akan menemukannya. Untuk informasi selengkapnya, lihat [Merujuk file repositori sumber](workflows-sources-reference-files.md) dan [Mereferensikan file dalam artefak](workflows-working-artifacts-refer-files.md). 1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMM alur kerja sebelum melakukan. 1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi. ------ #### [ YAML ] **Untuk menentukan artefak keluaran menggunakan 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 alur kerja, tambahkan kode yang mirip dengan berikut ini: ``` action-name: Outputs: Artifacts: - Name: artifact-name Files: - file-path-1 - file-path-2 ``` Untuk contoh lainnya, lihat [Contoh artefak](workflows-working-artifacts-ex.md). Untuk informasi selengkapnya, lihat [Alur kerja definisi YAMAL](workflow-reference.md) untuk tindakan Anda. 1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMM alur kerja sebelum melakukan. 1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi. ------ # Mendefinisikan artefak input Jika Anda ingin menggunakan artefak yang dihasilkan oleh CodeCatalyst tindakan Amazon lain, Anda harus menentukannya sebagai input untuk tindakan saat ini. Anda mungkin dapat menentukan beberapa artefak sebagai input—itu tergantung pada tindakan. Untuk informasi selengkapnya, lihat [Alur kerja definisi YAMAL](workflow-reference.md) untuk tindakan Anda. **catatan** Anda tidak dapat mereferensikan artefak dari alur kerja lain. Gunakan petunjuk berikut untuk menentukan artefak dari tindakan lain sebagai masukan untuk tindakan saat ini. **Prasyarat** Sebelum Anda mulai, pastikan Anda memiliki output artefak dari tindakan lain. Untuk informasi selengkapnya, lihat [Mendefinisikan artefak keluaran](workflows-working-artifacts-output.md). Mengeluarkan artefak membuatnya tersedia untuk tindakan lain untuk digunakan. ------ #### [ Visual ] **Untuk menentukan artefak sebagai masukan untuk tindakan (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 menentukan artefak sebagai input. 1. Pilih **Input**. 1. Dalam **Artefak - opsional**, lakukan hal berikut: Tentukan artefak dari tindakan sebelumnya yang ingin Anda berikan sebagai masukan untuk tindakan ini. Artefak ini harus sudah didefinisikan sebagai artefak keluaran dalam tindakan sebelumnya. Jika Anda tidak menentukan artefak input apa pun, maka Anda harus menentukan setidaknya satu repositori sumber di bawah. `action-name/Inputs/Sources` Untuk informasi selengkapnya tentang artefak, termasuk contoh, lihat[Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md). **catatan** Jika **Artefacts - daftar drop-down opsional** tidak tersedia (editor visual), atau jika Anda mendapatkan kesalahan saat memvalidasi YAMAL (editor YAMAL), itu mungkin karena tindakan hanya mendukung satu input. Dalam hal ini, coba hapus input sumber. 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 artefak sebagai masukan ke tindakan (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 di mana Anda ingin menentukan artefak sebagai input, tambahkan kode yang mirip dengan berikut ini: ``` action-name: Inputs: Artifacts: - artifact-name ``` Untuk contoh lainnya, lihat [Contoh artefak](workflows-working-artifacts-ex.md). 1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan. 1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi. ------ # Mereferensikan file dalam artefak Jika Anda memiliki file yang berada dalam artefak, dan Anda perlu merujuk ke file ini di salah satu tindakan CodeCatalyst alur kerja Amazon Anda, selesaikan prosedur berikut. **catatan** Lihat juga [Merujuk file repositori sumber](workflows-sources-reference-files.md). ------ #### [ Visual ] *Tidak tersedia. Pilih YAMG untuk melihat instruksi YAMG.* ------ #### [ YAML ] **Untuk mereferensikan file dalam artefak (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 tindakan di mana Anda ingin mereferensikan file, tambahkan kode yang mirip dengan yang berikut ini: ``` Actions: My-action: Inputs: Sources: - WorkflowSource Artifacts: - artifact-name Configuration: template: artifact-path/path/to/file.yml ``` Pada kode sebelumnya, ganti: + *artifact-name*dengan nama artefak. + *artifact-path*dengan nilai dari tabel berikut. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/workflows-working-artifacts-refer-files.html) Sebagai contoh, lihat [Contoh artefak](workflows-working-artifacts-ex.md). **catatan** Anda dapat menghilangkan *artifact-path* dan hanya menentukan jalur file relatif terhadap direktori root artefak jika: Tindakan di mana Anda menyertakan referensi hanya menyertakan satu item di bawah `Inputs` (misalnya, ini mencakup satu artefak input dan tidak ada sumber). File yang ingin Anda referensikan berada di input utama. *Input utama* adalah`WorkflowSource`, atau artefak input pertama yang terdaftar, jika tidak `WorkflowSource` ada. 1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan. 1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi. ------ # Mengunduh artefak Anda dapat mengunduh dan memeriksa artefak yang dihasilkan oleh tindakan CodeCatalyst alur kerja Amazon untuk tujuan pemecahan masalah. Ada dua jenis artefak yang dapat Anda unduh: + **Artefak sumber** — Artefak yang berisi snapshot konten repositori sumber seperti yang ada saat proses dijalankan. + **Artefak alur kerja** - Artefak yang didefinisikan dalam `Outputs` properti file konfigurasi alur kerja Anda. **Untuk mengunduh keluaran artefak berdasarkan alur kerja** 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. Di bawah nama alur kerja, pilih **Runs**. 1. Di **Riwayat Jalankan****, di kolom Run ID**, pilih run. Misalnya, `Run-95a4d`. 1. Di bawah nama run, pilih **Artefak**. 1. Di samping artefak, pilih **Unduh**. File arsip diunduh. Nama filenya terdiri dari tujuh karakter acak. 1. Ekstrak arsip menggunakan utilitas ekstraksi arsip pilihan Anda.