Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Legen Sie Umgebungsvariablen in einer Warteschlangenumgebung fest

Viele Anwendungen und Frameworks verwenden Umgebungsvariablen, um Funktionseinstellungen, Protokollierungsebenen und die Anzeigekonfiguration zu steuern. Sie können Open Job Description (OpenJD) -Umgebungen verwenden, um Umgebungsvariablen festzulegen, die jeder Taskbefehl innerhalb seines Gültigkeitsbereichs erbt.

Gültigkeitsbereich der Umgebungsvariablen

AWS Deadline Cloud wendet Umgebungsvariablen aus Warteschlangenumgebungen an, die Sie an eine Warteschlange anhängen. Innerhalb einer Jobvorlage können Sie mithilfe von OpenJD-Umgebungen auch Umgebungsvariablen auf Job- und Schrittebene definieren. Variablen, die in einem engeren Gültigkeitsbereich definiert sind, überschreiben Variablen mit demselben Namen aus einem breiteren Gültigkeitsbereich.

Variablen in einer Warteschlangenumgebung setzen

Sie können Umgebungsvariablen in einer Warteschlangenumgebung mithilfe einer variables Map für feste Werte oder script mithilfe einer onEnter With-Aktion für dynamische Werte festlegen.

Die folgende Vorlage für die Warteschlangenumgebung verwendet eine variables Map, auf die die QT_QPA_PLATFORM Variable gesetzt wirdoffscreen, sodass Anwendungen, die das Qt Framework verwenden, auf Worker-Hosts ohne interaktive Anzeige ausgeführt werden können.

specificationVersion: 'environment-2023-09'
environment:
  name: QtOffscreen
  variables:
    QT_QPA_PLATFORM: offscreen

Verwenden Sie für dynamische Werte, wie das Ändern PATH oder Aktivieren virtueller Umgebungen, ein Skript, das Zeilen im Format stdout openjd_env: VAR=value ausgibt. Das openjd_env: Präfix ist erforderlich. Durch die Verwendung von echoexport, oder anderen Shell-Mechanismen ohne das Präfix werden Variablen nicht an Jobs und Aufgaben weitergegeben.

Die folgende Vorlage für die Warteschlangenumgebung legt die QT_QPA_PLATFORM Variable mithilfe eines Skripts fest.

specificationVersion: 'environment-2023-09'
environment:
  name: QtOffscreen
  script:
    actions:
      onEnter:
        command: bash
        args:
        - "{{Env.File.Enter}}"
    embeddedFiles:
    - name: Enter
      type: TEXT
      data: |
        #!/bin/env bash
        set -euo pipefail
        echo "openjd_env: QT_QPA_PLATFORM=offscreen"

Um eine Warteschlangenumgebung an Ihre Warteschlange anzuhängen, verwenden Sie die Deadline Cloud-Konsole oder die AWS CLI. Weitere Informationen finden Sie unter Erstellen einer Warteschlangenumgebung im AWS Deadline Cloud-Benutzerhandbuch. Der folgende AWS CLI Befehl erstellt eine Warteschlangenumgebung aus einer Vorlagendatei.

aws deadline create-queue-environment \
    --farm-id FARM_ID \
    --queue-id QUEUE_ID \
    --priority 1 \
    --template-type YAML \
    --template file://my-queue-env.yaml

Komplexere Beispiele, wie das Erstellen und Aktivieren virtueller Conda-Umgebungen, finden Sie unter Beispiele für Deadline Cloud-Warteschlangenumgebungen unter GitHub.

Variablen in einer Jobvorlage festlegen

Fügen Sie in einer Jobvorlage eine variables Map zu einem jobEnvironments stepEnvironments OR-Eintrag hinzu. Jeder Eintrag ist ein Schlüssel-Wert-Paar, wobei der Schlüssel der Variablenname und der Wert der Variablenwert ist.

Die folgende Jobvorlage setzt die QT_QPA_PLATFORM Umgebungsvariable aufoffscreen, sodass Anwendungen, die das Qt Framework verwenden, auf Worker-Hosts ohne interaktive Anzeige ausgeführt werden können.

specificationVersion: 'jobtemplate-2023-09'
name: MyJob
jobEnvironments:
- name: JobEnv
  variables:
    QT_QPA_PLATFORM: offscreen

Sie können mehrere Variablen in einer einzigen Umgebungsdefinition festlegen.

jobEnvironments:
- name: JobEnv
  variables:
    JOB_VERBOSITY: MEDIUM
    JOB_PROJECT_ID: my-project-id
    JOB_ENDPOINT_URL: https://my-host-name/my/path
    QT_QPA_PLATFORM: offscreen

Mithilfe der {{Param.ParameterName}} Syntax können Sie in Variablenwerten auf Jobparameter verweisen.

jobEnvironments:
- name: JobEnv
  variables:
    JOB_EXAMPLE_PARAM: "{{Param.ExampleParam}}"

Um eine Variable auf Jobebene für einen bestimmten Schritt zu überschreiben, definieren Sie einen stepEnvironments Eintrag mit demselben Variablennamen. Das folgende Beispiel definiert JOB_PROJECT_ID auf Auftragsebene mit dem Wert project-12 und überschreibt dann den Wert auf Schrittebene mit. step-project-12 Die Aufgaben im Schritt verwenden den Wert auf Schrittebene.

specificationVersion: 'jobtemplate-2023-09'
name: MyJob
jobEnvironments:
- name: JobEnv
  variables:
    JOB_PROJECT_ID: project-12
steps:
- name: MyStep
  stepEnvironments:
  - name: StepEnv
    variables:
      JOB_PROJECT_ID: step-project-12

Probieren Sie es aus: Beispiel für die Umgebungsvariable ausführen

Das Deadline Cloud-Beispiel-Repository enthält ein Job-Bundle, das das Setzen und Anzeigen von Umgebungsvariablen demonstriert. Die Beispieljobvorlage definiert Variablen sowohl auf Auftrags- als auch auf Schrittebene und führt dann eine Aufgabe aus, die das zusammengeführte Ergebnis druckt. Gehen Sie wie folgt vor, um das Beispiel auszuführen und die Ergebnisse zu überprüfen.

Voraussetzungen

Ausführen des Beispiels

Vergleich von Sitzungsaktionen mit ihren Definitionen

In der Protokollansicht werden drei Sitzungsaktionen angezeigt. Öffnen Sie die Datei job_env_vars/template.yaml in einem Texteditor, um jede Aktion mit ihrer Definition in der Jobvorlage zu vergleichen.