Tindakan 'Render definisi ECS tugas Amazon' YAML

Berikut ini adalah YAML definisi tindakan definisi ECS tugas Render Amazon. Untuk mempelajari cara menggunakan tindakan ini, lihatMemodifikasi definisi ECS tugas Amazon.

Definisi tindakan ini ada sebagai bagian dalam file definisi alur kerja yang lebih luas. Untuk informasi selengkapnya tentang file ini, lihatDefinisi alur kerja YAML.

catatan

Sebagian besar YAML properti yang mengikuti memiliki elemen UI yang sesuai di editor visual. Untuk mencari elemen UI, gunakan Ctrl+F. Elemen akan terdaftar dengan YAML properti terkait.

# The workflow definition starts here.
# See Properti tingkat atas for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.   
  ECSRenderTaskDefinition_nn: 
    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 (_). 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.

Default: aws/ecs-render-task-definition@v1.

UI yang sesuai: Diagram alur ECSRenderTaskDefinition kerja/_nn/ 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

UI yang sesuai: Tab masukan/Tergantung pada - opsional

Compute

(ECSRenderTaskDefinition/Compute)

(Opsional)

Mesin komputasi yang 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.

UI yang sesuai: tidak ada

Type

(ECSRenderTaskDefinition/Compute/Type)

(Diperlukan Compute jika disertakan)

Jenis mesin komputasi. Anda dapat menggunakan salah satu nilai berikut:

• EC2(editor visual) atau EC2 (YAMLeditor)

  Dioptimalkan untuk fleksibilitas selama aksi berjalan.

• Lambda (editor visual) atau Lambda (YAMLeditor)

  Kecepatan start-up aksi yang dioptimalkan.

Untuk informasi selengkapnya tentang jenis komputasi, lihatJenis komputasi.

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

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

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 (YAMLeditor), atau jam dan menit (editor visual), bahwa tindakan dapat berjalan sebelum CodeCatalyst mengakhiri tindakan. Minimal adalah 5 menit dan maksimum dijelaskan dalamKuota untuk alur kerja di CodeCatalyst. Batas waktu default sama dengan batas waktu maksimum.

UI yang sesuai: Tab konfigurasi/Timeout - opsional

Inputs

(ECSRenderTaskDefinition/Inputs)

(Opsional)

InputsBagian ini mendefinisikan data yang ECSRenderTaskDefinition dibutuhkan selama menjalankan alur kerja.

catatan

Hanya satu input (baik sumber atau artefak) yang diizinkan per tindakan definisi ECS tugas Render Amazon. 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 adalahWorkflowSource.

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.

UI yang sesuai: Tab/Sumber Input - opsional

Artifacts - input

(ECSRenderTaskDefinition/Inputs/Artifacts)

(Diperlukan jika file definisi tugas Anda disimpan dalam artefak keluaran 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, lihatBerbagi artefak dan file antar tindakan.

UI yang sesuai: Tab konfigurasi/Artefak - opsional

Variables - input

(ECSRenderTaskDefinition/Inputs/Variables)

(Diperlukan)

Tentukan urutan pasangan nama/nilai 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 (_). 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, lihatMenggunakan variabel dalam alur kerja.

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 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 bidangcontainerDefinitions, di file definisi tugas Anda. Untuk informasi selengkapnya, lihat Nama di Panduan Pengembang Layanan Kontainer Elastis Amazon.

UI yang sesuai: Tab konfigurasi/Nama kontainer

image

(ECSRenderTaskDefinition/Configuration/image)

(Diperlukan)

Tentukan nama gambar Docker yang Anda inginkan tindakan definisi ECS tugas Render Amazon untuk ditambahkan ke file definisi tugas Anda. Tindakan menambahkan nama ini ke image bidangcontainerDefinitions, 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 menentukanMyDockerImage:${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 menentukanmy-ecr-repo/image-repo:$(date +%m-%d-%y-%H-%m-%s), tindakan menambahkan my-ecr-repo/image-repo:date +%m-%d-%y-%H-%m-%s ke file definisi tugas, di mana my-ecr-repo adalah URI dari Amazon Elastic Container Registry (ECR) dan date +%m-%d-%y-%H-%m-%s adalah stempel waktu dalam format yang month-day-year-hour-minute-second dihasilkan saat runtime oleh alur kerja.

Untuk informasi selengkapnya tentang image bidang ini, lihat Gambar di Panduan Pengembang Layanan Kontainer Elastis Amazon. Untuk informasi lebih lanjut tentang variabel, lihatMenggunakan variabel dalam alur kerja.

UI yang sesuai: Tab konfigurasi/Nama gambar

environment-variables

(ECSRenderTaskDefinition/Configuration/environment-variables)

(Diperlukan)

Tentukan variabel lingkungan yang Anda inginkan tindakan definisi ECS tugas Render Amazon untuk ditambahkan ke file definisi tugas Anda. Tindakan menambahkan variabel ke environment bidangcontainerDefinitions, 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 ECS lingkungan Amazon, lihat Menentukan variabel lingkungan di Panduan Pengembang Layanan Kontainer Elastis Amazon.

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, lihatBerbagi artefak dan file antar tindakan.

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 ECS tindakan Deploy to Amazon, lihat. Contoh: Memodifikasi ECS taskdef Amazon

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 dengantask-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) ECS tindakan Deploy to Amazon. Untuk memahami cara menambahkan variabel ini ke ECS tindakan Deploy to Amazon, lihatContoh: Memodifikasi ECS taskdef Amazon.

Default: task-definition

UI yang sesuai: Tab Keluaran/Variabel/Bidang nama