Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Imposta le variabili di ambiente in un ambiente di coda

Molte applicazioni e framework utilizzano variabili di ambiente per controllare le impostazioni delle funzionalità, i livelli di registrazione e la configurazione dello schermo. È possibile utilizzare gli ambienti Open Job Description (OpenJD) per impostare le variabili di ambiente che ogni comando di task all'interno del relativo ambito eredita.

Ambito della variabile di ambiente

AWS Deadline Cloud applica le variabili di ambiente dagli ambienti di coda collegati a una coda. All'interno di un modello di lavoro, puoi anche definire le variabili di ambiente a livello di processo e fase utilizzando gli ambienti OpenJD. Le variabili definite in un ambito più ristretto sostituiscono le variabili con lo stesso nome in un ambito più ampio.

Impostazione delle variabili in un ambiente di coda

È possibile impostare le variabili di ambiente in un ambiente di coda utilizzando una variables mappa per valori fissi o utilizzando un'scriptonEnterazione per valori dinamici.

Il seguente modello di ambiente di coda utilizza una variables mappa su cui impostare la QT_QPA_PLATFORM variabileoffscreen, che consente alle applicazioni che utilizzano Qt Framework di funzionare su host di lavoro senza un display interattivo.

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

Per valori dinamici, come la modifica PATH o l'attivazione di ambienti virtuali, usa uno script che stampa le righe nel formato openjd_env: VAR=value su stdout. Il openjd_env: prefisso è obbligatorio. L'utilizzo di echoexport, o altri meccanismi di shell senza il prefisso non propaga le variabili ai job e alle attività.

Il seguente modello di ambiente di coda imposta la QT_QPA_PLATFORM variabile utilizzando uno script.

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"

Per collegare un ambiente di coda alla tua coda, usa la console Deadline Cloud o il. AWS CLI Per ulteriori informazioni, consulta Creare un ambiente di coda nella Guida per l'utente di AWS Deadline Cloud. Il AWS CLI comando seguente crea un ambiente di coda da un file modello.

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

Per esempi più complessi, come la creazione e l'attivazione di ambienti virtuali conda, consulta gli esempi di ambiente di coda di Deadline Cloud su. GitHub

Impostazione delle variabili in un modello di lavoro

In un modello di lavoro, aggiungi una variables mappa a una stepEnvironments voce jobEnvironments or. Ogni voce è una coppia chiave-valore in cui la chiave è il nome della variabile e il valore è il valore della variabile.

Il seguente modello di lavoro imposta la variabile di QT_QPA_PLATFORM ambiente suoffscreen, che consente alle applicazioni che utilizzano Qt Framework di funzionare su host di lavoro senza un display interattivo.

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

È possibile impostare più variabili in un'unica definizione di ambiente.

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

È possibile fare riferimento ai parametri del lavoro in valori variabili utilizzando la {{Param.ParameterName}} sintassi.

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

Per sovrascrivere una variabile a livello di job per un passaggio specifico, definite una stepEnvironments voce con lo stesso nome di variabile. L'esempio seguente definisce JOB_PROJECT_ID a livello di processo il valoreproject-12, quindi sostituisce il valore a livello di fase con. step-project-12 Le attività della fase utilizzano il valore a livello di fase.

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

Prova: esegui l'esempio della variabile di ambiente

L'archivio di esempi di Deadline Cloud include un job bundle che dimostra l'impostazione e la visualizzazione delle variabili di ambiente. Il modello di lavoro di esempio definisce le variabili sia a livello di processo che a livello di fase, quindi esegue un'attività che stampa il risultato unito. Utilizzare la procedura seguente per eseguire il campione e controllare i risultati.

Prerequisiti

Esecuzione dell'esempio

Confronto delle azioni della sessione con le relative definizioni

La visualizzazione del registro mostra tre azioni di sessione. Apri il file job_env_vars/template.yaml in un editor di testo per confrontare ogni azione con la relativa definizione nel modello di lavoro.