本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 自動化截止日期雲端監控桌面部署和工作流程
<a name="monitor-automate-desktop"></a>

 AWS Deadline Cloud Monitor 桌面應用程式包含命令列界面 (CLI)，管理員可以使用該界面為使用者設定描述檔，而且藝術家和開發人員可以使用該應用程式將監視器整合至其工作站上的自動化工作流程。

## 尋找截止日期雲端監視器可執行檔
<a name="monitor-automate-desktop-binary-location"></a>

若要使用 CLI 命令，請從終端機執行截止日期雲端監視器可執行檔。預設安裝位置取決於您的作業系統和安裝方法。

Windows  

```
%LOCALAPPDATA%\DeadlineCloudMonitor\DeadlineCloudMonitor.exe
```

macOS  

```
/Applications/DeadlineCloudMonitor.app/Contents/MacOS/DeadlineCloudMonitor
```

Linux (deb 或 RPM 套件）  

```
/usr/bin/deadline-cloud-monitor
```

Linux (AppImage)  
直接從您下載的位置執行 AppImage 檔案。

在下列範例中，將 `DeadlineCloudMonitor`取代為作業系統可執行檔的完整路徑。

## 設定設定檔以簡化使用者存取
<a name="monitor-automate-desktop-create-profile"></a>

管理員使用 `create-profile`命令為使用者建立截止日期雲端監控設定檔。此命令會設定設定檔，讓使用者無需額外的組態或設定檔選擇，即可開啟監視器、登入並開始運作。

`create-profile` 命令接受下列旗標：
+ `--enable-auto-login` – 將監視器設定為在應用程式啟動時，使用最近使用的設定檔自動登入。
+ `--set-as-deadline-default` – 將設定檔設定為截止日期雲端工具的預設值，包括截止日期雲端提交者、截止日期 CLI 和截止日期雲端 GUI 應用程式。此旗標不會影響 AWS Command Line Interface (AWS CLI)。

當兩個旗標都啟用時，使用者會開啟監視器並自動登入，而不需要其他組態或設定檔選擇。

**建立設定檔**  


執行下列命令，將預留位置值取代為您的監視器詳細資訊。

```
DeadlineCloudMonitor create-profile \
    --profile {{profile-name}} \
    --monitor-id {{monitor-id}} \
    --monitor-url https://{{monitorName}}.{{region}}.deadlinecloud.amazonaws.com \
    --enable-auto-login \
    --set-as-deadline-default
```

命令會建立設定檔，並將組態寫入使用者工作站上的截止日期雲端組態檔案。監視器 URL 的格式必須為 `https://{{monitorName}}.{{region}}.deadlinecloud.amazonaws.com`。

**注意**  
`create-profile` 命令會在建立設定檔後結束。若要使用新設定檔開啟監視器，請執行 `login`命令或開啟截止日期雲端監視器桌面應用程式。

## 將截止日期雲端監視器整合到您的工作流程
<a name="monitor-automate-desktop-workflow-integration"></a>

使用 `login`、 `logout`和 `handle-url`命令，將截止日期雲端監視器整合到工作站上的指令碼和自動化工作流程。

### 登入和登出
<a name="monitor-automate-desktop-login-logout"></a>

使用 `login`和 `logout`命令在工作流程中控制身分驗證。例如，提交任務的指令碼可以使用 `login`命令，以確保在提交開始之前驗證使用者。

當您使用 `login`命令時，監視器會直接開啟至指定的設定檔，略過設定檔選取畫面。身分驗證完成後，監視器會將系統匣最小化，讓您的工作流程可以繼續。如果監視器已針對指定的設定檔執行，現有的視窗會進入前景，而不是啟動新的執行個體。

**登入設定檔**  


執行下列命令，將 {{profile-name}} 取代為您的截止日期雲端監視器設定檔的名稱。

```
DeadlineCloudMonitor login --profile {{profile-name}}
```

**登出設定檔**  


執行下列命令以清除設定檔的登入資料，並發出任何執行中監控執行個體的訊號，讓該設定檔結束。

```
DeadlineCloudMonitor logout --profile {{profile-name}}
```

### 開啟監視器至特定頁面
<a name="monitor-automate-desktop-handle-url"></a>

使用 `handle-url`命令開啟特定頁面的截止日期雲端監視器。此命令在指令碼執行動作時很有用，例如建立任務，而且您想要自動開啟監視器以顯示結果。例如，在指令碼提交任務之後，指令碼可以呼叫 `handle-url` 以直接開啟監視器至任務詳細資訊頁面。

您也可以使用 `deadline-cloud-monitor://` URL 做為公司網站、Wiki 或任務追蹤器上的連結，讓使用者直接開啟監視器至特定頁面。

URL 使用`deadline-cloud-monitor://`通訊協定結構描述搭配 `launch`命令。URL 包含要開啟的設定檔名稱和監控頁面 URL。

**開啟監視器至特定頁面**  


執行下列命令，將 {{monitor-page-url}} 取代為 URL 編碼的監控頁面 URL，將 {{profile-name}} 取代為您的設定檔名稱。

```
DeadlineCloudMonitor handle-url --url "deadline-cloud-monitor://launch?url={{monitor-page-url}}&profile={{profile-name}}"
```