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.
# Tindakan 'Render definisi tugas Amazon ECS' YAMAL
Berikut ini adalah definisi YAMAL dari tindakan **definisi tugas Render Amazon ECS**. Untuk mempelajari cara menggunakan tindakan ini, lihat[Memodifikasi definisi tugas Amazon ECS](render-ecs-action.md).
Definisi tindakan ini ada sebagai bagian dalam file definisi alur kerja yang lebih luas. Untuk informasi selengkapnya tentang file ini, lihat[Alur kerja definisi YAMAL](workflow-reference.md).
**catatan**
Sebagian besar properti YAMAL yang mengikuti memiliki elemen UI yang sesuai di editor visual. Untuk mencari elemen UI, gunakan **Ctrl\$1F**. Elemen akan terdaftar dengan properti YAMLnya yang terkait.
```
# The workflow definition starts here.
# See Properti tingkat atas for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
ECSRenderTaskDefinition\$1nn:
Identifier: aws/ecs-render-task-definition@v1
DependsOn:
- build-action
Compute:
Type: EC2 | Lambda
Fleet: fleet-name
Timeout: timeout-minutes
Inputs:
# Specify a source or an artifact, but not both.
Sources:
- source-name-1
Artifacts:
- task-definition-artifact
Variables:
- Name: variable-name-1
Value: variable-value-1
- Name: variable-name-2
Value: variable-value-2
Configuration
task-definition: task-definition-path
container-definition-name: container-definition-name
image: docker-image-name
environment-variables:
- variable-name-1=variable-value-1
- variable-name-2=variable-value-2
Outputs:
Artifacts:
- Name: TaskDefArtifact
Files: "task-definition*"
Variables:
- task-definition
```
## ECSRenderTaskDefinition
(Diperlukan)
Tentukan nama tindakan. Semua nama tindakan harus unik dalam alur kerja. Nama aksi 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 tindakan.
Default: `ECSRenderTaskDefinition_nn`.
UI yang sesuai: Tab konfigurasi/Nama **tindakan**
## Identifier
(*ECSRenderTaskDefinition*/**Identifier**)
(Diperlukan)
Mengidentifikasi tindakan. Jangan mengubah properti ini kecuali Anda ingin mengubah versi. Untuk informasi selengkapnya, lihat [Menentukan versi tindakan yang akan digunakan](workflows-action-versions.md).
Default: `aws/ecs-render-task-definition@v1`.
**UI yang sesuai: Diagram alur ECSRenderTaskDefinition kerja/\$1nn/ aws/ @v1 label ecs-render-task-definition**
## DependsOn
(*ECSRenderTaskDefinition*/**DependsOn**)
(Opsional)
Tentukan tindakan, grup tindakan, atau gerbang yang harus berjalan dengan sukses agar tindakan ini berjalan.
Untuk informasi selengkapnya tentang fungsionalitas 'tergantung pada', lihat. [Tindakan pengurutan](workflows-depends-on.md)
UI yang sesuai: Tab **masukan/Tergantung pada** - opsional
## Compute
(*ECSRenderTaskDefinition*/**Compute**)
(Opsional)
Mesin komputasi digunakan untuk menjalankan tindakan alur kerja Anda. Anda dapat menentukan komputasi baik di tingkat alur kerja atau di tingkat tindakan, tetapi tidak keduanya. Ketika ditentukan pada tingkat alur kerja, konfigurasi komputasi berlaku untuk semua tindakan yang ditentukan dalam alur kerja. Pada tingkat alur kerja, Anda juga dapat menjalankan beberapa tindakan pada instance yang sama. Untuk informasi selengkapnya, lihat [Berbagi komputasi di seluruh tindakan](compute-sharing.md).
UI yang sesuai: *tidak ada*
## Type
(*ECSRenderTaskDefinition*/Compute/**Type**)
(Diperlukan [Compute](#render.ecs.computename) jika disertakan)
Jenis mesin komputasi. Anda dapat menggunakan salah satu nilai berikut:
+ **EC2**(editor visual) atau `EC2` (editor YAMAL)
Dioptimalkan untuk fleksibilitas selama aksi berjalan.
+ **Lambda** (editor visual) atau `Lambda` (editor YAMG)
Kecepatan start-up aksi yang dioptimalkan.
Untuk informasi selengkapnya tentang jenis komputasi, lihat[Jenis komputasi](workflows-working-compute.md#compute.types).
UI yang sesuai: Tab konfigurasi/Jenis **komputasi**
## Fleet
(*ECSRenderTaskDefinition*/Compute/**Fleet**)
(Opsional)
Tentukan mesin atau armada yang akan menjalankan alur kerja atau tindakan alur kerja Anda. Dengan armada sesuai permintaan, ketika suatu tindakan dimulai, alur kerja menyediakan sumber daya yang dibutuhkan, dan mesin dihancurkan ketika tindakan selesai. Contoh armada sesuai permintaan:`Linux.x86-64.Large`,. `Linux.x86-64.XLarge` Untuk informasi lebih lanjut tentang armada sesuai permintaan, lihat. [Properti armada sesuai permintaan](workflows-working-compute.md#compute.on-demand)
Dengan armada yang disediakan, Anda mengonfigurasi satu set mesin khusus untuk menjalankan tindakan alur kerja Anda. Mesin-mesin ini tetap menganggur, siap untuk memproses tindakan segera. Untuk informasi lebih lanjut tentang armada yang disediakan, lihat. [Properti armada yang disediakan](workflows-working-compute.md#compute.provisioned-fleets)
Jika `Fleet` dihilangkan, defaultnya adalah. `Linux.x86-64.Large`
UI yang sesuai: Tab konfigurasi/Armada **komputasi**
## Timeout
(*ECSRenderTaskDefinition*/**Timeout**)
(Opsional)
Tentukan jumlah waktu dalam menit (editor YAMAL), atau jam dan menit (editor visual), bahwa tindakan dapat berjalan sebelum CodeCatalyst mengakhiri tindakan. Minimal adalah 5 menit dan maksimum dijelaskan dalam[Kuota untuk alur kerja di CodeCatalyst](workflows-quotas.md). Batas waktu default sama dengan batas waktu maksimum.
UI yang sesuai: Tab **konfigurasi/Timeout** - opsional
## Inputs
(*ECSRenderTaskDefinition*/**Inputs**)
(Opsional)
`Inputs`Bagian ini mendefinisikan data yang `ECSRenderTaskDefinition` dibutuhkan selama menjalankan alur kerja.
**catatan**
Hanya satu input (baik sumber atau artefak) yang diizinkan per tindakan **definisi tugas Amazon ECS Render**. Variabel tidak dihitung terhadap total ini.
UI yang sesuai: **Tab input**
## Sources
(*ECSRenderTaskDefinition*/Inputs/**Sources**)
(Diperlukan jika file definisi tugas Anda disimpan dalam repositori sumber)
Jika file definisi tugas Anda disimpan dalam repositori sumber, tentukan label repositori sumber tersebut. Saat ini, satu-satunya label yang didukung adalah`WorkflowSource`.
Jika file definisi tugas Anda tidak terkandung dalam repositori sumber, itu harus berada dalam artefak yang dihasilkan oleh tindakan lain.
Untuk informasi selengkapnya tentang sumber, lihat [Menghubungkan repositori sumber ke alur kerja](workflows-sources.md).
UI yang sesuai: **Tab/Sumber** Input - opsional
## Artifacts - input
(*ECSRenderTaskDefinition*/Inputs/**Artifacts**)
(Diperlukan jika file definisi tugas Anda disimpan dalam [artefak keluaran](workflows-working-artifacts-output.md) dari tindakan sebelumnya)
Jika file definisi tugas yang ingin Anda terapkan terkandung dalam artefak yang dihasilkan oleh tindakan sebelumnya, tentukan artefak tersebut di sini. Jika file definisi tugas Anda tidak terkandung dalam artefak, itu harus berada di repositori sumber Anda.
Untuk informasi selengkapnya tentang artefak, termasuk contoh, lihat[Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md).
UI yang sesuai: Tab **konfigurasi/Artefak** - opsional
## Variables - input
(*ECSRenderTaskDefinition*/Inputs/**Variables**)
(Diperlukan)
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).
UI yang sesuai: Input **tab/Variabel** - opsional
## Configuration
(*ECSRenderTaskDefinition*/**Configuration**)
(Diperlukan)
Bagian di mana Anda dapat menentukan properti konfigurasi tindakan.
UI yang sesuai: Tab **konfigurasi**
## task-definition
(*ECSRenderTaskDefinition*/Configuration/**task-definition**)
(Diperlukan)
Tentukan jalur ke file definisi tugas yang ada. Jika file berada di repositori sumber Anda, jalurnya relatif terhadap folder root repositori sumber. Jika file Anda berada dalam artefak dari tindakan alur kerja sebelumnya, jalurnya relatif terhadap folder root artefak. Untuk informasi selengkapnya tentang file definisi tugas, lihat [Definisi tugas](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions) di *Panduan Pengembang Layanan Kontainer Elastis Amazon*.
UI yang sesuai: Tab konfigurasi/Definisi **tugas**
## container-definition-name
(*ECSRenderTaskDefinition*/Configuration/**container-definition-name**)
(Diperlukan)
Tentukan nama wadah tempat image Docker Anda akan berjalan. Anda dapat menemukan nama ini di `name` bidang`containerDefinitions`, di file definisi tugas Anda. Untuk informasi selengkapnya, lihat [Nama](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_name) di *Panduan Pengembang Layanan Kontainer Elastis Amazon*.
UI yang sesuai: Tab konfigurasi/Nama **kontainer**
## image
(*ECSRenderTaskDefinition*/Configuration/**image**)
(Diperlukan)
Tentukan nama gambar Docker yang ingin ditambahkan tindakan **definisi tugas Render Amazon ECS** ke file definisi tugas Anda. Tindakan menambahkan nama ini ke `image` bidang`containerDefinitions`, dalam file definisi tugas Anda. Jika nilai sudah ada di `image` bidang, maka tindakan menimpa itu. Anda dapat memasukkan variabel dalam nama gambar.
Contoh:
Jika Anda menentukan`MyDockerImage:${WorkflowSource.CommitId}`, tindakan akan ditambahkan `MyDockerImage:commit-id` ke file definisi tugas, di mana *commit-id* adalah ID komit yang dihasilkan saat runtime oleh alur kerja.
Jika Anda menentukan`my-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s)`, tindakan menambahkan *my-ecr-repo* /image-repo: *date \$1%m-%d-%y-%H-%m-%s* ke file definisi tugas, di mana *my-ecr-repo* URI dari Amazon Elastic Container Registry (ECR) dan *date \$1%m-%d-%y-%H-%m-%s* merupakan stempel waktu dalam format `month-day-year-hour-minute-second` yang dihasilkan saat runtime oleh alur kerja.
Untuk informasi selengkapnya tentang `image` bidang ini, lihat [Gambar](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_image) di *Panduan Pengembang Layanan Kontainer Elastis Amazon*. Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).
UI yang sesuai: Tab konfigurasi/Nama **gambar**
## environment-variables
(*ECSRenderTaskDefinition*/Configuration/**environment-variables**)
(Diperlukan)
Tentukan variabel lingkungan yang Anda inginkan tindakan **definisi tugas Render Amazon ECS** untuk ditambahkan ke file definisi tugas Anda. Tindakan menambahkan variabel ke `environment` bidang`containerDefinitions`, dalam file definisi tugas Anda. Jika variabel sudah ada dalam file, tindakan menimpa nilai variabel yang ada dan menambahkan variabel baru. Untuk informasi selengkapnya tentang variabel lingkungan Amazon ECS, lihat [Menentukan variabel lingkungan](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) di Panduan *Pengembang Layanan Amazon Elastic Container*.
UI yang sesuai: Tab **konfigurasi/Variabel lingkungan -** opsional
## Outputs
(*ECSRenderTaskDefinition*/**Outputs**)
(Diperlukan)
Mendefinisikan data yang dihasilkan oleh tindakan selama menjalankan alur kerja.
UI yang sesuai: **Tab keluaran**
## Artifacts
(*ECSRenderTaskDefinition*/Outputs/**Artifacts**)
(Diperlukan)
Tentukan artefak yang dihasilkan oleh tindakan. Anda dapat mereferensikan artefak ini sebagai masukan dalam tindakan lain.
Untuk informasi selengkapnya tentang artefak, termasuk contoh, lihat[Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md).
**UI yang sesuai: Tab keluaran/Artefak**
## Name
(*ECSRenderTaskDefinition*/Outputs/Artifacts/**Name**)
(Diperlukan)
Tentukan nama artefak yang akan berisi file definisi tugas yang diperbarui. Nilai default-nya adalah `MyTaskDefinitionArtifact`. Anda kemudian harus menentukan artefak ini sebagai input ke dalam tindakan **Deploy to Amazon ECS**. Untuk memahami cara menambahkan artefak ini sebagai masukan ke tindakan **Deploy to Amazon ECS**, lihat. [Contoh: Memodifikasi taskdef Amazon ECS](render-ecs-action-example-workflow.md)
**UI yang sesuai: Tab Keluaran/Artefak/Nama**
## Files
(*ECSRenderTaskDefinition*/Outputs/Artifacts/**Files**)
(Diperlukan)
Tentukan file yang akan disertakan dalam artefak. Anda harus menentukan `task-definition-*` sehingga file definisi tugas yang diperbarui, yang dimulai dengan`task-definition-`, akan disertakan.
**UI yang sesuai: Tab Keluaran/Artefak/File**
## Variables
(*ECSRenderTaskDefinition*/Outputs/**Variables**)
(Diperlukan)
Tentukan nama variabel yang akan diatur oleh tindakan render. Tindakan render akan mengatur nilai variabel ini ke nama file definisi tugas yang diperbarui (misalnya,`task-definition-random-string.json`). Anda kemudian harus menentukan variabel ini di properti **Definisi tugas** (editor visual) atau `task-definition` (editor yaml) tindakan **Deploy to Amazon ECS**. Untuk memahami cara menambahkan variabel ini ke tindakan **Deploy ke Amazon ECS**, lihat. [Contoh: Memodifikasi taskdef Amazon ECS](render-ecs-action-example-workflow.md)
Default: `task-definition`
**UI yang sesuai: Tab Keluaran/Variabel/Bidang nama**