DSW（Data Science Workshop）為您提供雲端IDE的AI開發環境（開發機），熟悉Notebook/VSCode的開發人員，可以快速開始模型開發。以下介紹如何建立DSW執行個體，以及執行個體啟動和釋放時常見的問題。
快速建立一個基礎DSW執行個體
登入PAI控制台，選擇目標地域，在左側導覽列單擊工作空间列表，選擇並進入目標工作空間。
在左側導覽列單擊交互式建模（DSW） > 新建实例，配置以下關鍵參數，其他參數預設即可。控制台全量參數參見控制台全參數列表。
參數
說明
实例名称
例如：
dsw_test。资源类型
選擇公共资源，採用隨用隨付的計費方式。
资源规格
選擇如：
ecs.gn7i-c8g1.2xlarge（配置為：1張A10 GPU、8 vCPU、30 GiB記憶體）。如果該規格庫存不足，請嘗試挑選清單中的其他規格或切換到其他地區。
镜像配置
選擇官方镜像，搜尋並選擇
modelscope:1.31.0-pytorch2.8.0-gpu-py311-cu124-ubuntu22.04（Python版本為3.11、CUDA版本為12.4）。ModelScope的鏡像相容性較好，且三方庫較全，因此推薦使用ModelScope鏡像。
單擊确定建立執行個體，當執行個體狀態為运行中時，代表建立成功。
如果執行個體啟動失敗參見DSW執行個體啟動。
在DSW執行個體列表頁，單擊右側操作列下的打开按鈕，即可進入DSW執行個體開始模型開發。
後續您可以查看控制台訪問和管理DSW，瞭解DSW執行個體介面的功能，以及如何停止、釋放、變更DSW執行個體。
重要使用公用資源建立的DSW執行個體，從執行個體狀態變為运行中的那一刻起即開始按時間長度計費，即使您不開啟WebIDE或運行代碼也會計費。
關閉瀏覽器或退出登入不會停止執行個體，也不會停止計費。
如使用免費試用資源套件，資源套件額度用盡後將自動轉為隨用隨付，不會自動停止執行個體。
停止執行個體。當完成開發工作單位不再需要使用DSW執行個體時，請返回DSW執行個體列表頁：
如果僅需暫停使用，單擊執行個體右側的停止按鈕。注意：如果系統硬碟已擴容，停止執行個體後系統硬碟仍會持續計費。
重要資料預設儲存在免費的雲端硬碟中，如果執行個體停止超過15天，雲端硬碟的內容將被清空，且無法恢複。如果系統硬碟已擴容將不受此限制。
如果不再需要該執行個體，單擊執行個體右側的更多 > 删除按鈕，徹底停止所有計費。 刪除前請務必備份重要資料，刪除後資料無法恢複。
典型應用情境配置
基礎的DSW執行個體配置在實際AI開發中可能無法滿足需要，因此，以下為您總結了典型的應用情境配置：
情境 | 需求/痛點 | 配置要點 | 相關文檔 |
持久化儲存代碼和資料 | DSW執行個體的系統硬碟是臨時儲存，在執行個體刪除或長時間停止後資料會被清空。 需要長期儲存重要檔案，或在多個執行個體間共用資料。 | 通過数据集挂载或存储挂载將雲端儲存（如：Object Storage Service）掛載到執行個體指定目錄下。 | |
提升公網下載速度 | DSW執行個體預設使用共用網關，受頻寬節流設定，下載大型檔案時網速可能無法滿足需求。 | 在網路資訊中，配置Virtual Private Cloud，並使用专有网关。還需要為VPC建立NAT Gateway和Elastic IP Address (EIP)。 | |
通過SSH遠程開發 | 習慣使用本地的VSCode、PyCharm等工具開發和調試，不希望局限於Web IDE。 | 在訪問配置中，启用SSH，填入SSH公钥，並選擇公网访问方式，關聯已有的NAT Gateway和Elastic IP Address (EIP)。 | |
訪問執行個體內的Web服務 | 將執行個體內啟動並執行Web應用發布到公網，以便通過URL直接存取或分享。 | 在訪問配置中，添加自定义服务，佈建服務連接埠並啟用公網訪問。同時，必須在安全性群組中添加入方向規則，允許存取該連接埠。 |
控制台全參數列表
基礎資訊
參數 | 描述 |
实例名称 | 參考介面提示資訊配置執行個體名稱。 |
标签 | 根據業務需要對執行個體打標，便於對資源多維度尋找、定位、大量操作、分賬。 |
資源資訊
參數 | 描述 |
资源类型 |
|
環境資訊
參數 | 描述 |
镜像配置 | 支援以下鏡像類型：
|
系统盘 | 用於儲存開發過程中的檔案。當资源类型選擇公共资源，或當资源配额選擇預付費通用計算資源（CPU核心數≥2且記憶體≥4G，或配有GPU）時：每個執行個體會贈送100 GiB免費雲端硬碟作為系統硬碟。雲端硬碟支援擴容，具體擴容價格以控制台介面為準。 警告
如果您需要非揮發性儲存體，可以配置数据集挂载或存储挂载。 |
数据集挂载 | 可用於儲存需要讀取的資料集，或持久化儲存開發過程中的檔案，支援以下兩種資料集類型：
挂载路径：表示資料集掛載到DSW的路徑，例如 說明
更多關於掛載的詳情參見掛載資料集/OSS/NAS/CPFS。 |
存储挂载 | 您也可以使用儲存類型掛載儲存需要讀取的資料集，或持久化儲存開發過程中的檔案。
更多關於掛載的詳情參見掛載資料集/OSS/NAS/CPFS。 |
工作目录 | 當選擇公用資源時可配置此參數。工作目錄是Notebook、WebIDE的啟動路徑，預設為 |
網路資訊
參數 | 描述 |
专有网络配置 | 僅當资源类型選擇公共资源時，支援配置該參數。 當您想要在Virtual Private Cloud內使用DSW執行個體時，可以在DSW相同地區建立VPC並配置此參數，同時需配置交换机和安全组。不同情境的配置策略詳情參見網路設定。 |
交换机 | 當配置了專用網路時，可配置該參數。交換器是專用網路內的子網，您的 DSW 執行個體和其他雲資源都串連在交換器上。 |
安全组 | 當配置了專用網路時，需要配置該參數。安全性群組是 DSW 執行個體的虛擬防火牆，它控制所有進出的網路流量。 |
公网访问网关 | 支援以下配置方法：
僅當挂载配置選擇CPFS類型的資料集時，支援配置以下參數：
說明 如果掛載配置選擇了CPFS類型的資料集，則需要配置專用網路，且選擇的專用網路需要與CPFS一致。 |
扩展网段 | 當配置了交换机後，可配置該參數。當專用網路的可用IP地址數不足以滿足擴充的業務規模，或者前期網路規劃不當導致地址不足時，可以使用擴充網段擴充VPC地址空間。更多內容參見使用附加網段擴充網段地址。 |
訪問配置
參數 | 描述 |
启用SSH | 用於遠端連線執行個體，選擇專用網路後可配置。當開啟該開關後，會出現名稱為SSH的自定义服务。若您配置了自訂鏡像，請確認自訂鏡像安裝了sshd。 |
SSH公钥 | 開啟SSH配置開關後可配置該參數。 說明 如果需要同時支援VPC內登入和公網登入方式，您需要同時添加多個用戶端的公開金鑰。請按照斷行符號換行的方式逐個添加公開金鑰，最多支援添加10個公開金鑰。 |
服务访问与端口配置 | 用於配置SSH遠端存取或通過公網訪問執行個體中的服務。
|
创建VPC内访问域名 | 建立一條內建權威網域名稱（Private Zone），您可在VPC內使用該網域名稱來訪問當前執行個體的SSH服務或其他自訂服務，避免使用變化的執行個體IP帶來的訪問不便。請注意建立的內建權威網域名稱會產生費用，詳情參見Alibaba Cloud DNS產品計費。 |
从公网访问实例 | NLB：
DNAT + EIP：
|
角色與許可權
參數 | 描述 |
可见范围 | 可選擇仅实例所有者可见或工作空间内公开可见。 |
实例所有者 | 僅工作空間管理員可修改執行個體所有者。 |
常見問題
DSW執行個體啟動
Q：DSW執行個體啟動失敗
排查方法：單擊DSW執行個體名稱，在事件頁簽下查看報錯資訊。
常見報錯及解決方案如下：
錯誤原因：系統硬碟已滿，需要對系統硬碟進行擴容。
查看系統硬碟佔用情況：
解決方案：通過变更配置對系統硬碟進行擴容：
重要擴容過系統硬碟後，無論執行個體是否處於運行狀態，系統硬碟都會持續計費。如果您想停止DSW執行個體相關的一切計費，請刪除DSW執行個體。刪除前請務必確保必要資料已備份。
錯誤原因：建立執行個體使用的鏡像太大，導致系統硬碟空間不足。
解決方案：開啟執行個體詳情頁，擴容系統硬碟。請注意，擴容系統硬碟將根據容量收取額外費用。
其他啟動失敗原因：
欠費導致建立失敗
如果您的帳號欠費，將導致建立DSW執行個體建立失敗，並且代金券不能抵扣欠費，您可登入費用與成本控制台，查看賬戶是否欠費。
Q：提示資源規格庫存不足或計算資源配額不足怎麼辦？
常見報錯：
"Your requested resource type [ecs.******] is not enough currently"（資產庫存不足）。
"Your resource usage has exceeded the default limitation"（超出每個Region有2卡GPU）。
"The cluster resources are fully utilized"（計算資源已完全被佔用）。
原因分析：
公用資產庫存不足
公用資源由多個使用者共用，在高峰期可能出現庫存緊張。
特定GPU規格（如高端GPU）更容易售罄。
每個帳號在每個Region有2卡GPU的限制。
專有資源配額不足
購買了專有資源配額，但配額已用盡。
配額分配不合理，某個工作空間配額不足。
解決方案：
Q：DSW啟動時可以開機執行Python檔案嗎？
您可以在建立DSW執行個體時，或通過變更執行個體配置的方式設定自定义启动脚本。
該功能可用於在執行個體啟動過程中定製環境或執行初始化任務。自訂指令碼的執行時間在鏡像和資源準備完成後，JupyterLab、Code Server等開發應用啟動前。
逾時時間為3分鐘：自訂指令碼會增加執行個體的啟動時間，指令碼逾時時間為3分鐘，請勿在自訂指令碼中執行鏡像下載等長耗時任務。
可查看指令碼作業記錄：執行個體啟動後可在/var/log/user-command/路徑下找到自訂指令碼運行產生的日誌。
Q：找不到DSW執行個體？
您可以在概覽頁面查看建立地不同類型的執行個體，並嘗試切換不同地區。
Q：DSW 頁面異常或無法操作怎麼辦？
如果遇到頁面白屏、Notebook 一直轉圈載入、Terminal 無法輸入命令或無法載入、瀏覽器提示"504 Gateway Timeout"或"504 Timeout"等問題，通常與本地環境或執行個體狀態有關。請嘗試以下步驟：
清理瀏覽器緩衝後重試。
使用瀏覽器的 無痕/隱私模式 訪問。
更換網路環境，例如從公司內網切換至手機熱點，以排查防火牆限制。
嘗試使用 其他瀏覽器（如 Chrome、Firefox）。
如果提示 504 Timeout 錯誤，請在 PAI 控制台停止並重啟 DSW 執行個體，等待狀態變為"運行中"後再訪問。
Q：包含雲端硬碟系統硬碟的DSW執行個體停止、重啟、變更規格、更換鏡像是否會丟失系統硬碟中資料？
包含雲端硬碟系統硬碟的DSW執行個體類型有：公用資源群組建立的執行個體，以及選擇云盘作為系統硬碟的通用資源執行個體，其系統硬碟中的資料丟失情況如下：
停止執行個體：可能會丟失。如果雲端硬碟未擴容且執行個體停止超過15天，資料會被清空且無法恢複。如果雲端硬碟擴容過或者執行個體停止未超過15天，則資料不會丟失。
重啟執行個體：不會丟失。在執行個體停止或重啟後，所有通過
pip安裝的包、代碼檔案以及其他儲存在執行個體系統硬碟中的資料都會被保留，不會丟失。變更執行個體規格：不會丟失。調整執行個體規格（如CPU、記憶體、GPU等資源配置）不會影響執行個體的系統硬碟中資料。
更換執行個體鏡像：可能會丟失部分資料。變更鏡像不會影響掛載的資料集或OSS儲存中的資料，但系統硬碟內的內容可能會被重設。因此，您在變更執行個體鏡像時，注意儲存執行個體資料。比如可以將資料複製或移動到資料集或OSS中。詳情請參見掛載資料集/OSS/NAS/CPFS。
對於選擇临时存储作為系統硬碟的通用資源執行個體，不論其所在AI資源群組是否配有預付費雲端硬碟，其停止、重啟、變更規格或鏡像都會丟失系統硬碟中的資料。
Q：使用公用資源建立的 DSW 執行個體，超過15 天未登入被釋放，可以找回嗎？
使用公用資源建立的DSW執行個體，如果雲端硬碟系統硬碟未付費擴容，且關機後連續15天以上未啟動，其系統硬碟將被自動清空且無法恢複。
Q：為什麼 DSW 執行個體初次開機比後續啟動慢？
初次開機 DSW 執行個體時，系統需要完整拉取所選鏡像，這一過程可能耗時 10 分鐘以上（取決於鏡像大小和網路狀況）。後續啟動由於鏡像已緩衝，速度會顯著加快。
如果發現啟動時間逐漸層長，可能是由於儲存的自訂鏡像體積過大導致。建議清理不必要的檔案後重新儲存鏡像，或更換為官方提供的輕量鏡像。
Q：建立DSW執行個體時報錯"out of stock"或"InternalError-ResourceAllocateFailed"，或者配置SSH/公網IP後啟動失敗但去除配置後可以成功，是什麼原因？
該錯誤通常由VPC交換器所在可用性區域的資產庫存不足導致。當建立DSW執行個體時指定了VPC和交換器，系統會將資源調度限制在該交換器所在的可用性區域內。若該可用性區域的資產庫存已售罄，執行個體建立將失敗。根本原因是該特定可用性區域資源不足，而非網路設定衝突。
常見報錯資訊：
out of stockInternalError-ResourceAllocateFailed配置SSH訪問或公網IP後啟動失敗，但去除這些配置後可以成功啟動。
解決方案：更換其他有可用資源的可用性區域對應的交換器。建議在VPC下的多個可用性區域建立交換器，以增加資源調度成功率。
Q：DSW執行個體停止後無法重啟怎麼辦？公用資源的庫存到貨時間如何查詢？
公用資產庫存每日動態更新，不支援查詢具體到貨時間。DSW執行個體手動停止後，底層計算資源會被釋放。重啟執行個體相當於重新申請資源，若原規格在重啟時已被其他使用者佔用，則可能無法成功啟動。
解決方案：
更換其他地區。
更換其他可用規格。
在非高峰時段重試。
Q：建立DSW執行個體時報錯"Private zone service status is not OPENED"怎麼辦？
該報錯表示未開通Alibaba Cloud DNS PrivateZone 服務。DSW 依賴 PrivateZone 完成VPC網路解析初始化。
解決方案：
登入阿里雲控制台，搜尋並開通Alibaba Cloud DNS PrivateZone 服務。
確認DSW所在VPC已關聯該服務。
重建或重啟DSW執行個體以觸發網路初始化。
Q：建立DSW執行個體時報錯"Workspace member not found"或"Workspace not exists"怎麼辦？
該報錯通常由以下原因導致：
當前登入帳號不是目標工作空間的成員。
選擇了錯誤的工作空間。
解決方案：
切換至正確的工作空間。
聯絡工作空間管理員，將當前帳號添加為工作空間成員。
DSW執行個體停止或釋放
Q：如何釋放DSW執行個體？
在DSW執行個體列表頁，單擊停止或刪除執行個體。
注意：如果建立DSW執行個體時有擴容過系統硬碟，無論執行個體是否處於運行狀態，系統硬碟都會持續計費。如果您想停止DSW執行個體相關的一切計費，請刪除DSW執行個體。
Q：怎麼找不到DSW執行個體？
如果找不到執行個體，您可以嘗試切換不同地區和工作空間。
Q：如何釋放免費試用抵扣包？
免費試用抵扣包無需釋放或停止。
Q：如何完全停止DSW執行個體的計費？“停止”和“刪除”操作有什麼不同？
停止執行個體：此操作釋放執行個體的計算資源（CPU/GPU），並暫停計算費用。注意：擴容的系統硬碟會繼續計費。
刪除執行個體：此操作永久刪除執行個體及其所有資源（包括系統硬碟）。所有相關計費會完全停止。
如何選擇：
停止：臨時不用，但想保留資料和環境供未來重啟。
刪除：不再需要，希望停止所有計費。操作前請備份資料。
Q：為什麼我的DSW執行個體長時間處於“停止中”或“刪除中”狀態，無法完成操作？
停止或刪除執行個體需要時間。系統需要安全地終止任務、儲存狀態和回收資源。如果執行個體長時間無響應，常見原因如下：
執行個體中有未正常結束的進程。
記憶體佔用過高，導致執行個體無法響應關機指令。
遇到這種情況，通常耐心等待一段時間後重新整理頁面，執行個體狀態會正常停止。
Q：停止或刪除DSW執行個體後，我的資料和代碼會丟失嗎？
資料是否保留取決於您的操作以及執行個體的資源群組類型。
停止執行個體：
資料保留原則因資源群組類型而異。
包含雲端硬碟系統硬碟的執行個體（大多數隨用隨付規格，選擇了云盘作為系統硬碟的通用資源執行個體）：如果雲端硬碟未擴容且執行個體停止超過15天，資料會被清空且無法恢複。如果雲端硬碟擴容過或者執行個體停止未超過15天，則資料不會丟失。
使用临时存储作系統硬碟的執行個體：資料存放區在臨時儲存中。停止執行個體會刪除資料，且無法恢複。
刪除執行個體：
其系統硬碟中的所有資料都將被永久擦除，且無法恢複。因此，在刪除前務必備份所有重要資料。
Q：為什麼我正在啟動並執行DSW執行個體會自動停止？
執行個體配置了閑置自動關機策略。此策略旨在節省資源，預設對免費試用執行個體啟用。
觸發條件：執行個體的 CPU 和 GPU 使用率連續 3 小時低於設定閾值。
操作建議：
手動停止：為確保節省資源，請在不使用時手動停止執行個體。自動關機策略不保證每次都觸發。
修改策略：如需運行長時任務，請修改或禁用此策略。具體操作步驟如下：
進入工作空間詳情頁，單擊工作空间配置 > 自动停止设置。
找到DSW的配置地區，在此處即可修改DSW的關機策略以及排除策略。如：如果不想自動關機可在排除策略中通過執行個體名稱排除。
Q：我已經將所有DSW執行個體停止或刪除了，為什麼還顯示“運行中”或收到計費通知？
檢查以下常見原因：
混淆了資源套件與執行個體。您看到的“運行中”狀態可能指資源套件（如“每月250計算時”），而非執行個體。資源套件在有效期間內始終有效，其狀態與執行個體無關。
擴容的系統硬碟仍在計費。停止執行個體僅暫停計算費用。擴容後的系統硬碟會繼續產生儲存費用。
賬單存在延遲。計費並非即時，賬單可能在您使用資源幾小時後才產生。例如，上午產生的費用，可能在下午才顯示在賬單中。
Q：是否支援通過 API、Python 代碼或任務完成後自動停止 DSW 執行個體？
目前不支援以下方式自動控制 DSW 執行個體的啟停：
不支援從 ECS 等外部環境通過 API 呼叫 DSW 啟動訓練進程或控制執行個體啟停。
不支援在執行個體內通過 Python 代碼（如
os.system）執行停機命令。不支援設定"任務完成後自動停機"。
DSW 僅支援配置"閑置自動關機策略"（最低閑置時間長度為 1 小時），該策略基於 CPU/GPU 使用率判斷執行個體是否閑置，但無法保證 100% 觸發。建議在任務完成後手動停止執行個體，以避免額外計費。