本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 在佇列環境中設定路徑 使用 OpenJD 環境在 環境中提供新命令。首先建立包含指令碼檔案的目錄，然後將該目錄新增至`PATH`環境變數，以便指令碼中的可執行檔可以執行它們，而不需要每次指定目錄路徑。環境定義中的變數清單不提供修改變數的方式，因此您可以改為執行指令碼來執行此操作。指令碼設定並修改 之後`PATH`，它會使用命令 將變數匯出至 OpenJD 執行期`echo "openjd_env: PATH=$PATH"`。 ## 先決條件 執行下列步驟，從截止日期雲端[範例 github 儲存庫使用環境變數執行範例任務套件](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/job_env_vars/template.yaml)。 1. 如果您沒有具有佇列和相關聯 Linux 機群的截止日期雲端陣列，請遵循[截止日期雲端主控台](https://console.aws.amazon.com/deadlinecloud/home)中的引導式加入體驗，以使用預設設定建立。 1. 如果您的工作站上沒有截止日期雲端 CLI 和截止日期雲端監視器，請遵循使用者指南中[設定截止日期雲端提交者](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/submitter.html)中的步驟。 1. 使用 `git`複製[截止日期雲端範例 GitHub 儲存庫](https://github.com/aws-deadline/deadline-cloud-samples)。 ``` git clone https://github.com/aws-deadline/deadline-cloud-samples.git Cloning into 'deadline-cloud-samples'... ... cd deadline-cloud-samples/job_bundles ``` ## 執行路徑範例 1. 使用截止日期雲端 CLI 提交`job_env_with_new_command`範例。 ``` $ deadline bundle submit job_env_with_new_command Submitting to Queue: MySampleQueue ... ``` 1. 在截止日期雲端監視器中，您會看到新的任務，並且可以監控其進度。一旦與佇列相關聯的Linux機群有工作者可執行任務，任務會在幾秒鐘內完成。選取任務，然後選擇任務面板右上角選單中的**檢視日誌**選項。 右側有兩個工作階段動作：**啟動 RandomSleepCommand** 和**任務執行**。視窗中央的日誌檢視器對應至右側的所選工作階段動作。 ## 比較工作階段動作及其定義 在本節中，您會使用截止日期雲端監視器來比較工作階段動作與任務範本中定義工作階段動作的位置。它從上一節繼續。 在文字編輯器中開啟檔案 [job\_env\_with\_new\_command/template.yaml。](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/job_env_with_new_command/template.yaml)將工作階段動作與任務範本中定義它們的位置進行比較。 1. 在截止日期雲端監視器中選取**啟動 RandomSleepCommand** 工作階段動作。您將看到如下所示的日誌輸出。 ``` 2024/07/16 17:25:32-07:00 2024/07/16 17:25:32-07:00 ============================================== 2024/07/16 17:25:32-07:00 --------- Entering Environment: RandomSleepCommand 2024/07/16 17:25:32-07:00 ============================================== 2024/07/16 17:25:32-07:00 ---------------------------------------------- 2024/07/16 17:25:32-07:00 Phase: Setup 2024/07/16 17:25:32-07:00 ---------------------------------------------- 2024/07/16 17:25:32-07:00 Writing embedded files for Environment to disk. 2024/07/16 17:25:32-07:00 Mapping: Env.File.Enter -> /sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/embedded_filesf3tq_1os/tmpbt8j_c3f 2024/07/16 17:25:32-07:00 Mapping: Env.File.SleepScript -> /sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/embedded_filesf3tq_1os/tmperastlp4 2024/07/16 17:25:32-07:00 Wrote: Enter -> /sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/embedded_filesf3tq_1os/tmpbt8j_c3f 2024/07/16 17:25:32-07:00 Wrote: SleepScript -> /sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/embedded_filesf3tq_1os/tmperastlp4 2024/07/16 17:25:32-07:00 ---------------------------------------------- 2024/07/16 17:25:32-07:00 Phase: Running action 2024/07/16 17:25:32-07:00 ---------------------------------------------- 2024/07/16 17:25:32-07:00 Running command sudo -u job-user -i setsid -w /sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/tmpbwrquq5u.sh 2024/07/16 17:25:32-07:00 Command started as pid: 2205 2024/07/16 17:25:32-07:00 Output: 2024/07/16 17:25:33-07:00 openjd_env: PATH=/sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/bin:/opt/conda/condabin:/home/job-user/.local/bin:/home/job-user/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/var/lib/snapd/snap/bin No newer logs at this moment. ``` 任務範本的下列幾行指定了此動作。 ``` jobEnvironments: - name: RandomSleepCommand description: Adds a command 'random-sleep' to the environment. script: actions: onEnter: command: bash args: - "{{Env.File.Enter}}" embeddedFiles: - name: Enter type: TEXT data: | #!/bin/env bash set -euo pipefail # Make a bin directory inside the session's working directory for providing new commands mkdir -p '{{Session.WorkingDirectory}}/bin' # If this bin directory is not already in the PATH, then add it if ! [[ ":$PATH:" == *':{{Session.WorkingDirectory}}/bin:'* ]]; then export "PATH={{Session.WorkingDirectory}}/bin:$PATH" # This message to Open Job Description exports the new PATH value to the environment echo "openjd_env: PATH=$PATH" fi # Copy the SleepScript embedded file into the bin directory cp '{{Env.File.SleepScript}}' '{{Session.WorkingDirectory}}/bin/random-sleep' chmod u+x '{{Session.WorkingDirectory}}/bin/random-sleep' - name: SleepScript type: TEXT runnable: true data: | ... ``` 1. 在截止日期雲端監視器中選取**啟動 StepEnv** 工作階段動作。您會看到如下所示的日誌輸出。 ``` 2024/07/16 17:25:33-07:00 2024/07/16 17:25:33-07:00 ============================================== 2024/07/16 17:25:33-07:00 --------- Running Task 2024/07/16 17:25:33-07:00 ============================================== 2024/07/16 17:25:33-07:00 ---------------------------------------------- 2024/07/16 17:25:33-07:00 Phase: Setup 2024/07/16 17:25:33-07:00 ---------------------------------------------- 2024/07/16 17:25:33-07:00 Writing embedded files for Task to disk. 2024/07/16 17:25:33-07:00 Mapping: Task.File.Run -> /sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/embedded_filesf3tq_1os/tmpdrwuehjf 2024/07/16 17:25:33-07:00 Wrote: Run -> /sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/embedded_filesf3tq_1os/tmpdrwuehjf 2024/07/16 17:25:33-07:00 ---------------------------------------------- 2024/07/16 17:25:33-07:00 Phase: Running action 2024/07/16 17:25:33-07:00 ---------------------------------------------- 2024/07/16 17:25:33-07:00 Running command sudo -u job-user -i setsid -w /sessions/session-ab132a51b9b54d5da22cbe839dd946baaw1c8hk5/tmpz81iaqfw.sh 2024/07/16 17:25:33-07:00 Command started as pid: 2256 2024/07/16 17:25:33-07:00 Output: 2024/07/16 17:25:34-07:00 + random-sleep 12.5 27.5 2024/07/16 17:26:00-07:00 Sleeping for duration 26.90 2024/07/16 17:26:00-07:00 ---------------------------------------------- 2024/07/16 17:26:00-07:00 Uploading output files to Job Attachments 2024/07/16 17:26:00-07:00 ---------------------------------------------- ``` 1. 任務範本的下列幾行指定了此動作。 ``` steps: - name: EnvWithCommand script: actions: onRun: command: bash args: - '{{Task.File.Run}}' embeddedFiles: - name: Run type: TEXT data: | set -xeuo pipefail # Run the script installed into PATH by the job environment random-sleep 12.5 27.5 hostRequirements: attributes: - name: attr.worker.os.family anyOf: - linux ```