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.

Stellen Sie Umgebungsvariablen in einer Warteschlangenumgebung ein

Viele Anwendungen und Frameworks verwenden Umgebungsvariablen, um Funktionseinstellungen, Protokollierungsstufen und die Anzeigekonfiguration zu steuern. Sie können OpenJD-Umgebungen (Open Job Description) verwenden, um Umgebungsvariablen festzulegen, die jeder Aufgabenbefehl in seinem Gültigkeitsbereich erbt.

Geltungsbereich der Umgebungsvariablen

AWS Deadline Cloud wendet Umgebungsvariablen aus Warteschlangenumgebungen an, die Sie an eine Warteschlange anhängen. In 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 Aktion für dynamische Werte festlegen.

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

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

Verwenden Sie für dynamische Werte, wie z. B. das Ändern PATH oder Aktivieren virtueller Umgebungen, ein Skript, das Zeilen im Format openjd_env: VAR=value stdout ausgibt. Das openjd_env: Präfix ist erforderlich. Wenn Sieecho,export, oder andere Shell-Mechanismen ohne das Präfix verwenden, werden Variablen nicht an Jobs und Aufgaben weitergegeben.

Die folgende Vorlage für eine 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 Eine Warteschlangenumgebung erstellen 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 in den Beispielen für die Deadline Cloud-Warteschlangenumgebung 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 den Wert JOB_PROJECT_ID auf Auftragsebene mit dem Wert project-12 und überschreibt dann den Wert auf der 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-Paket, das das Setzen und Anzeigen von Umgebungsvariablen demonstriert. Die Beispiel-Jobvorlage definiert Variablen sowohl auf Job- als auch auf Schrittebene und führt dann eine Aufgabe aus, die das zusammengeführte Ergebnis druckt. Gehen Sie wie folgt vor, um die Probe auszuführen und die Ergebnisse zu überprüfen.

Voraussetzungen

Ausführen des Beispiels

Sitzungsaktionen mit ihren Definitionen vergleichen

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