Elemen template pekerjaan untuk bundel pekerjaan

Template pekerjaan mendefinisikan lingkungan runtime dan proses yang berjalan sebagai bagian dari tugas Deadline Cloud. Anda dapat membuat parameter dalam template sehingga dapat digunakan untuk membuat pekerjaan yang hanya berbeda dalam nilai input, seperti fungsi dalam bahasa pemrograman.

Saat Anda mengirimkan pekerjaan ke Deadline Cloud, pekerjaan akan berjalan di lingkungan antrian apa pun yang diterapkan ke antrian. Lingkungan antrian dibangun menggunakan spesifikasi lingkungan eksternal Open Job Description (OpenJD). Untuk detailnya, lihat template Lingkungan di GitHub repositori OpenJD.

Untuk pengenalan membuat pekerjaan dengan template pekerjaan OpenJD, lihat Peng antar membuat pekerjaan di repositori OpenJD GitHub . Informasi tambahan dapat ditemukan di Bagaimana pekerjaan dijalankan. Ada contoh template pekerjaan di samples direktori GitHub repositori OpenJD.

Anda dapat menentukan template pekerjaan dalam format YAML (template.yaml) atau JSON format (template.json). Contoh-contoh di bagian ini ditampilkan dalam format YAML.

Misalnya, template pekerjaan untuk blender_render sampel mendefinisikan parameter input BlenderSceneFile sebagai jalur file:

- name: BlenderSceneFile
  type: PATH
  objectType: FILE
  dataFlow: IN
  userInterface:
    control: CHOOSE_INPUT_FILE
    label: Blender Scene File
    groupLabel: Render Parameters
    fileFilters:
    - label: Blender Scene Files
      patterns: ["*.blend"]
    - label: All Files
      patterns: ["*"]
  description: >
    Choose the Blender scene file to render. Use the 'Job Attachments' tab
    to add textures and other files that the job needs.

Pro userInterface perti mendefinisikan perilaku antarmuka pengguna yang dihasilkan secara otomatis untuk baris perintah menggunakan deadline bundle gui-submit perintah dan dalam plugin pengiriman pekerjaan untuk aplikasi seperti Autodesk Maya.

Per gui-submit intah membuka dialog pengiriman dengan tab Setelan pekerjaan bersama untuk nama, prioritas, dan antrian target pekerjaan, dan tab Job-specific pengaturan yang dihasilkan dari definisi parameter dalam template pekerjaan.

Dalam contoh ini, widget UI untuk memasukkan nilai untuk BlenderSceneFile parameter adalah dialog pemilihan file yang hanya menampilkan file. .blend

Untuk contoh lebih lanjut menggunakan userInteface elemen, lihat contoh gui_control_showcase di repositori deadline- cloud-sample pada. GitHub

Pro objectType dataFlow perti dan mengontrol perilaku lampiran pekerjaan saat Anda mengirimkan pekerjaan dari bundel pekerjaan. Dalam hal ini, objectType: FILE dan dataFlow:IN berarti bahwa nilai BlenderSceneFile adalah file input untuk lampiran pekerjaan.

Sebaliknya, definisi OutputDir parameter memiliki objectType: DIRECTORY dandataFlow: OUT:

- name: OutputDir
  type: PATH
  objectType: DIRECTORY
  dataFlow: OUT
  userInterface:
    control: CHOOSE_DIRECTORY
    label: Output Directory
    groupLabel: Render Parameters
  default: "./output"
  description: Choose the render output directory.

Nilai OutputDir parameter digunakan oleh lampiran pekerjaan sebagai direktori tempat pekerjaan menulis file output.

Saat Anda mengirimkan bundel, tab lampiran pekerjaan dialog pengiriman mencantumkan file input dan direktori yang terdeteksi dari properti ini, bersama dengan direktori keluaran tempat pekerjaan menulis. Jalur yang ditampilkan dalam huruf miring terdeteksi secara otomatis; Anda dapat menambahkan jalur lain yang tidak ditemukan oleh pengirim.

Untuk informasi selengkapnya tentang objectType dataFlow properti dan, lihat JobPathParameterDefinition dalam spesifikasi Deskripsi Pekerjaan Terbuka https://github.com/OpenJobDescription/openjd-specifications

Sisa contoh template blender_render pekerjaan mendefinisikan alur kerja pekerjaan sebagai langkah tunggal dengan setiap frame dalam animasi dirender sebagai tugas terpisah:

steps:
- name: RenderBlender
  parameterSpace:
    taskParameterDefinitions:
    - name: Frame
      type: INT
      range: "{{Param.Frames}}"
  script:
    actions:
      onRun:
        command: bash
        # Note: {{Task.File.Run}} is a variable that expands to the filename on the worker host's
        # disk where the contents of the 'Run' embedded file, below, is written.
        args: ['{{Task.File.Run}}']
    embeddedFiles:
      - name: Run
        type: TEXT
        data: |
          # Configure the task to fail if any individual command fails.
          set -xeuo pipefail

          mkdir -p '{{Param.OutputDir}}'

          blender --background '{{Param.BlenderSceneFile}}' \
                  --render-output '{{Param.OutputDir}}/{{Param.OutputPattern}}' \
                  --render-format {{Param.Format}} \
                  --use-extension 1 \
                  --render-frame {{Task.Param.Frame}}

Misalnya, jika nilai Frames parameter adalah1-10, itu mendefinisikan 10 tugas. Masing-masing memiliki tugas memiliki nilai yang berbeda untuk Frame parameter. Untuk menjalankan tugas:

Untuk informasi selengkapnya tentang file yang disematkan, sesi, dan lokasi yang dipetakan jalur, lihat Bagaimana pekerjaan dijalankan dalam spesifikasi Deskripsi Pekerjaan Terbuka.

Ada lebih banyak contoh template pekerjaan di samples/job_bundles repositori deadline-cloud, serta contoh template yang disediakan dengan spesifikasi Open Job Deskripsi.