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.
# Memodifikasi definisi tugas Amazon ECS
Bagian ini menjelaskan cara memperbarui `image` bidang dalam file [definisi tugas Amazon Elastic Container Service (Amazon ECS) Elastic Container Service (Amazon ECS)](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions) menggunakan alur kerja. CodeCatalyst Untuk mencapai ini, Anda harus menambahkan tindakan **definisi tugas Render Amazon ECS** ke alur kerja Anda. Tindakan ini memperbarui bidang gambar dalam file definisi tugas dengan nama gambar Docker yang disediakan oleh alur kerja Anda saat runtime.
**catatan**
Anda juga dapat menggunakan tindakan ini untuk memperbarui `environment` bidang definisi tugas dengan variabel lingkungan.
**Topics**
+ [Kapan menggunakan tindakan ini](#render-ecs-action-when-to-use)
+ [Cara kerja tindakan 'Render Amazon ECS task definition'](#render-ecs-action-how-it-works)
+ [Gambar runtime yang digunakan oleh tindakan 'Render Amazon ECS task definition'](#render-ecs-action-runtime)
+ [Contoh: Memodifikasi taskdef Amazon ECS](render-ecs-action-example-workflow.md)
+ [Menambahkan tindakan 'Render Amazon ECS task definition'](render-ecs-action-add.md)
+ [Melihat file definisi tugas yang diperbarui](render-ecs-action-view.md)
+ [Variabel 'Render definisi tugas Amazon ECS'](render-ecs-action-variables.md)
+ [Tindakan 'Render definisi tugas Amazon ECS' YAMAL](render-ecs-action-ref.md)
## Kapan menggunakan tindakan ini
Gunakan ini jika Anda memiliki alur kerja yang membangun dan menandai image Docker dengan konten dinamis, seperti ID komit atau stempel waktu.
Jangan gunakan tindakan ini jika file definisi tugas Anda berisi nilai gambar yang selalu tetap sama. Dalam hal ini, Anda dapat memasukkan nama gambar Anda secara manual ke dalam file definisi tugas.
## Cara kerja tindakan 'Render Amazon ECS task definition'
Anda harus menggunakan tindakan **definisi tugas Render Amazon ECS** dengan tindakan **build** dan **Deploy ke Amazon ECS** di alur kerja Anda. Bersama-sama, tindakan ini bekerja sebagai berikut:
1. Tindakan **build membangun** image Docker Anda dan menandainya dengan nama, ID komit, stempel waktu, atau konten dinamis lainnya. Misalnya, tindakan build Anda mungkin terlihat seperti ini:
```
MyECSWorkflow
Actions:
BuildAction:
Identifier: aws/build@v1
...
Configuration:
Steps:
# Build, tag, and push the Docker image...
- Run: docker build -t MyDockerImage:${WorkflowSource.CommitId} .
...
```
Dalam kode sebelumnya, `docker build -t` arahan menunjukkan untuk membangun image Docker dan menandainya dengan ID komit saat runtime tindakan. Nama gambar yang dihasilkan mungkin terlihat seperti ini:
`MyDockerImage:a37bd7e`
1. Tindakan **definisi tugas Render Amazon ECS** menambahkan nama gambar yang dihasilkan secara dinamis`MyDockerImage:a37bd7e`, ke file definisi tugas Anda, seperti ini:
```
{
"executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
"containerDefinitions": [
{
"name": "codecatalyst-ecs-container",
"image": MyDockerImage:a37bd7e,
"essential": true,
...
"portMappings": [
{
"hostPort": 80,
"protocol": "tcp",
"containerPort": 80
}
]
}
],
...
}
```
Secara opsional, Anda juga dapat meminta tindakan **definisi tugas Render Amazon ECS** menambahkan variabel lingkungan ke definisi tugas, seperti ini:
```
{
"executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
"containerDefinitions": [
{
"name": "codecatalyst-ecs-container",
"image": MyDockerImage:a37bd7e,
...
"environment": [
{
name": "ECS_LOGLEVEL",
value": "info"
}
]
}
],
...
}
```
Untuk informasi selengkapnya tentang variabel lingkungan, lihat [Menentukan variabel lingkungan](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) di *Panduan Pengembang Layanan Amazon Elastic Container*.
1. Tindakan **Deploy to Amazon ECS** mendaftarkan file definisi tugas yang diperbarui dengan Amazon ECS. Mendaftarkan file definisi tugas yang diperbarui menyebarkan gambar baru, `MyDockerImage:a37bd7e` ke Amazon ECS.
## Gambar runtime yang digunakan oleh tindakan 'Render Amazon ECS task definition'
Tindakan **definisi tugas Render Amazon ECS** berjalan pada [gambar November 2022](build-images.md#build.previous-image). Lihat informasi yang lebih lengkap di [Gambar aktif](build-images.md#build-curated-images).
# Contoh: Memodifikasi taskdef Amazon ECS
Berikut ini adalah contoh alur kerja lengkap yang menyertakan tindakan **definisi tugas Render Amazon ECS**, bersama dengan tindakan build dan deploy. Tujuan alur kerja adalah untuk membangun dan menerapkan image Docker ke dalam cluster Amazon ECS Anda. Alur kerja terdiri dari blok bangunan berikut yang berjalan secara berurutan:
+ **Pemicu - Pemicu** ini memulai alur kerja yang dijalankan secara otomatis saat Anda mendorong perubahan ke repositori sumber Anda. Untuk informasi lebih lanjut tentang menggunakan pemicu, lihat [Memulai alur kerja berjalan secara otomatis menggunakan pemicu](workflows-add-trigger.md).
+ Tindakan **build** (`BuildDocker`) — Pada pemicu, aksi membangun image Docker menggunakan Dockerfile, memberi tag dengan ID komit, dan mendorong gambar ke Amazon ECR. Untuk informasi selengkapnya tentang tindakan build, lihat[Membangun dengan alur kerja](build-workflow-actions.md).
+ Tindakan **definisi tugas Amazon ECS Render** (`RenderTaskDef`) — Setelah menyelesaikan tindakan build, tindakan ini memperbarui yang ada di `taskdef.json` root repositori sumber Anda dengan nilai `image` bidang yang menyertakan ID komit yang benar. Ini menyimpan file yang diperbarui dengan nama file baru (`task-definition-random-string.json`) dan kemudian membuat artefak keluaran yang berisi file ini. Tindakan render juga menghasilkan variabel yang disebut `task-definition` dan menyetelnya ke nama file definisi tugas baru. Artefak dan variabel akan digunakan tindakan penyebaran, yang berikutnya.
+ Tindakan **Deploy to Amazon ECS** (`DeployToECS`) — Setelah menyelesaikan tindakan **definisi tugas Render Amazon ECS**, aksi **Deploy to Amazon** ECS mencari artefak keluaran yang dihasilkan oleh tindakan render `TaskDefArtifact` (), menemukan `task-definition-random-string.json` file di dalamnya, dan mendaftarkannya dengan layanan Amazon ECS Anda. Layanan Amazon ECS kemudian mengikuti petunjuk dalam `task-definition-random-string.json` file untuk menjalankan tugas Amazon ECS—dan container image Docker terkait—di dalam cluster Amazon ECS Anda.
```
Name: codecatalyst-ecs-workflow
SchemaVersion: 1.0
Triggers:
- Type: PUSH
Branches:
- main
Actions:
BuildDocker:
Identifier: aws/build@v1
Environment:
Name: codecatalyst-ecs-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-ecs-build-role
Inputs:
Variables:
- Name: REPOSITORY_URI
Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo
- Name: IMAGE_TAG
Value: ${WorkflowSource.CommitId}
Configuration:
Steps:
#pre_build:
- Run: echo Logging in to Amazon ECR...
- Run: aws --version
- Run: aws ecr get-login-password --region us-east-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-2.amazonaws.com
#build:
- Run: echo Build started on `date`
- Run: echo Building the Docker image...
- Run: docker build -t $REPOSITORY_URI:latest .
- Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG
#post_build:
- Run: echo Build completed on `date`
- Run: echo Pushing the Docker images...
- Run: docker push $REPOSITORY_URI:latest
- Run: docker push $REPOSITORY_URI:$IMAGE_TAG
RenderTaskDef:
DependsOn:
- BuildDocker
Identifier: aws/ecs-render-task-definition@v1
Inputs:
Variables:
- Name: REPOSITORY_URI
Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo
- Name: IMAGE_TAG
Value: ${WorkflowSource.CommitId}
Configuration:
task-definition: taskdef.json
container-definition-name: codecatalyst-ecs-container
image: $REPOSITORY_URI:$IMAGE_TAG
# The output artifact contains the updated task definition file.
# The new file is prefixed with 'task-definition'.
# The output variable is set to the name of the updated task definition file.
Outputs:
Artifacts:
- Name: TaskDefArtifact
Files:
- "task-definition*"
Variables:
- task-definition
DeployToECS:
Identifier: aws/ecs-deploy@v1
Environment:
Name: codecatalyst-ecs-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-ecs-deploy-role
#Input artifact contains the updated task definition file.
Inputs:
Sources: []
Artifacts:
- TaskDefArtifact
Configuration:
region: us-east-2
cluster: codecatalyst-ecs-cluster
service: codecatalyst-ecs-service
task-definition: ${RenderTaskDef.task-definition}
```
# Menambahkan tindakan 'Render Amazon ECS task definition'
Gunakan petunjuk berikut untuk menambahkan tindakan **definisi tugas Render Amazon ECS** ke alur kerja Anda.
**Prasyarat**
Sebelum memulai, pastikan Anda memiliki alur kerja yang menyertakan tindakan build yang menghasilkan image Docker secara dinamis. Lihat [alur kerja contoh sebelumnya untuk detailnya](render-ecs-action-example-workflow.md).
------
#### [ Visual ]
**Untuk menambahkan tindakan 'Render Amazon ECS task definition' 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. Di kiri atas, pilih **\$1 Tindakan** untuk membuka katalog tindakan.
1. Dari daftar drop-down, pilih **Amazon CodeCatalyst**.
1. Cari tindakan **definisi tugas Render Amazon ECS**, dan lakukan salah satu hal berikut:
+ Pilih tanda plus (**\$1**) untuk menambahkan tindakan ke diagram alur kerja dan buka panel konfigurasinya.
Atau
+ Pilih **Render definisi tugas Amazon ECS**. Kotak dialog detail tindakan muncul. Pada kotak dialog ini:
+ (Opsional) Pilih **Lihat sumber** untuk [melihat kode sumber tindakan](workflows-view-source.md#workflows-view-source.title).
+ Pilih **Tambahkan ke alur kerja** untuk menambahkan tindakan ke diagram alur kerja dan buka panel konfigurasinya.
1. Pada tab **Input** dan **Konfigurasi**, lengkapi bidang sesuai dengan kebutuhan Anda. Untuk deskripsi setiap bidang, lihat[Tindakan 'Render definisi tugas Amazon ECS' YAMAL](render-ecs-action-ref.md). Referensi ini memberikan informasi rinci tentang setiap bidang (dan nilai properti YAMAL yang sesuai) seperti yang muncul di YAMAL dan editor visual.
1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.
1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.
------
#### [ YAML ]
**Untuk menambahkan tindakan 'Render Amazon ECS task definition' menggunakan 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. Di kiri atas, pilih **\$1 Tindakan** untuk membuka katalog tindakan.
1. Dari daftar drop-down, pilih **Amazon CodeCatalyst**.
1. Cari tindakan **definisi tugas Render Amazon ECS**, dan lakukan salah satu hal berikut:
+ Pilih tanda plus (**\$1**) untuk menambahkan tindakan ke diagram alur kerja dan buka panel konfigurasinya.
Atau
+ Pilih **Render definisi tugas Amazon ECS**. Kotak dialog detail tindakan muncul. Pada kotak dialog ini:
+ (Opsional) Pilih **Lihat sumber** untuk [melihat kode sumber tindakan](workflows-view-source.md#workflows-view-source.title).
+ Pilih **Tambahkan ke alur kerja** untuk menambahkan tindakan ke diagram alur kerja dan buka panel konfigurasinya.
1. Ubah properti dalam kode YAMAL sesuai dengan kebutuhan Anda. Penjelasan tentang setiap properti yang tersedia disediakan di[Tindakan 'Render definisi tugas Amazon ECS' YAMAL](render-ecs-action-ref.md).
1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.
1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.
------
**Langkah selanjutnya**
Setelah menambahkan tindakan render, tambahkan tindakan **Deploy ke Amazon ECS** ke alur kerja Anda mengikuti petunjuk di. [Menyebarkan ke Amazon ECS dengan alur kerja](deploy-action-ecs.md) Saat menambahkan tindakan penerapan, lakukan hal berikut:
1. Di tab **Input** dari tindakan penerapan, di **Artefak - opsional**, pilih artefak yang dihasilkan oleh tindakan render. Ini berisi file definisi tugas yang diperbarui.
Untuk informasi lebih lanjut tentang artifact, lihat [Berbagi artefak dan file antar tindakan](workflows-working-artifacts.md).
1. Di tab **Konfigurasi** tindakan penerapan, di bidang **Definisi tugas**, tentukan variabel tindakan berikut: `${action-name.task-definition}` di *action-name* mana nama tindakan render Anda, misalnya,`RenderTaskDef`. Tindakan render menetapkan variabel ini ke nama baru dari file definisi tugas.
Untuk informasi lebih lanjut tentang variabel, lihat[Menggunakan variabel dalam alur kerja](workflows-working-with-variables.md).
[Untuk informasi selengkapnya tentang cara mengonfigurasi tindakan penerapan, lihat alur kerja contoh sebelumnya.](render-ecs-action-example-workflow.md)
# Melihat file definisi tugas yang diperbarui
Anda dapat melihat nama dan isi file definisi tugas yang diperbarui.
**Untuk melihat nama file definisi tugas yang diperbarui, setelah tindakan **definisi tugas Render Amazon ECS** memprosesnya.**
1. Temukan proses yang menyertakan tindakan render yang telah selesai:
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 run yang menyertakan tindakan render selesai.
1. Dalam diagram alur kerja, pilih tindakan render.
1. Pilih **Output**.
1. Pilih **Variabel**.
1. Nama file definisi tugas ditampilkan. Ini terlihat mirip dengan`task-definition--259-0a2r7gxlTF5X-.json`.
**Untuk melihat isi file definisi tugas yang diperbarui**
1. Temukan proses yang menyertakan tindakan render yang telah selesai:
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 run yang menyertakan tindakan render selesai.
1. Dalam alur kerja berjalan, di bagian atas, di samping **Visual** dan **YAMAL, pilih Output** **alur kerja**.
1. Di bagian **Artefak**, pilih **Unduh** di samping artefak yang berisi file definisi tugas yang diperbarui. Artefak ini akan memiliki kolom **Diproduksi oleh** disetel ke nama tindakan render Anda.
1. Buka file.zip untuk melihat file definisi tugas .json.
# Variabel 'Render definisi tugas Amazon ECS'
Tindakan **definisi tugas Render Amazon ECS** menghasilkan dan menetapkan variabel berikut pada waktu berjalan. Ini dikenal sebagai *variabel yang telah ditentukan*.
Untuk informasi tentang mereferensikan variabel-variabel ini dalam alur kerja, lihat. [Menggunakan variabel yang telah ditentukan](workflows-using-predefined-variables.md)
| Key | Nilai |
| --- | --- |
| definisi tugas | Nama yang diberikan ke file definisi tugas yang diperbarui oleh tindakan **definisi tugas Amazon ECS Render**. Nama mengikuti format`task-definition-random-string.json`. Contoh: `task-definition--259-0a2r7gxlTF5Xr.json` |
# 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**