將沙箱變更部署到生產
上次更新時間: 2025年11月3日
可搭配下列任何訂閱使用,除非另有註明:
-
行銷 Hub Enterprise
-
銷售 Hub Enterprise
-
Service Hub Enterprise
-
Data Hub Enterprise
-
Content Hub Enterprise
-
智慧 CRM Enterprise
-
Commerce Hub Enterprise
開始前須知
瞭解需求
限制與注意事項
- 測試期間,您的帳戶將額外獲得一個標準沙盒使用權限。
- 瞭解將部署哪些物件與資產。
沙盒最佳實踐
沙盒環境讓使用者能在生產帳戶外安全地進行創新。建議制定開發策略,並考量以下面向以確保沙盒測試的可靠性:
- 沙盒用途為何?(例如:積極開發、整合測試、培訓)
- 哪些人員需要存取權限?(例如:考量限制可能影響測試可靠性的衝突)
- 是否需要更多沙盒以支援不同使用情境?
- 如何最佳化建立與管理沙盒以支援開發需求?
明確定義這些面向有助於可靠測試,並將受支援的資產部署至生產環境,同時兼顧其他使用情境。
以下列舉沙盒的不同用途範例、應獲取存取權限的使用者,以及確保可靠測試與開發的建立策略:
| 沙盒用途 |
使用者 |
建立策略 |
| 積極開發與部署 一個支援持續開發、測試與部署的敏捷工作區,能促進活躍開發週期、快速原型製作及生產環境部署。 |
參與開發專案的活躍建置者與測試人員,其成果旨在部署至生產環境。限制沙盒存取權限可防止干擾性變更,確保測試與部署的可靠性。 |
建議定期刪除並建立新沙盒環境,以精準映射生產環境的支援資產。此舉可確保新開發工作在準確環境中進行(例如重大開發專案完成後)。 |
| 整合測試 專為整合作業打造的穩定工作區,適用於觀察變更與執行嚴謹測試,支援將受支援資產部署至生產環境。此環境不包含整合專屬配置的部署作業。 |
適用於管理或擴展整合功能,並驗證與外部系統端到端流程的團隊。 |
因主要目標在於維持整合連線,故較少需要刪除與建立沙箱。但隨著時間推移,仍建議定期刪除並建立新沙箱,以確保測試在精準環境中進行。 |
| 新用戶培訓專用沙盒 提供新進人員獨立隔離的沙箱環境,使其能在使用生產帳戶前安全學習系統操作並建立信心。 |
主要服務對象為接受系統功能與角色專屬業務流程培訓的新進人員及員工。為維持受控學習環境,存取權限應限於上述人員。 |
沙箱刪除與建立將視需求進行,依據新進人員或重大業務流程更新而定。 |
| 新功能測試沙盒 專用測試沙盒,用於在正式部署前測試新功能或複雜變更。 |
僅限核心測試人員與利害關係人存取以提供反饋。 |
沙盒刪除與建立將視測試內容需求彈性調整。 |
建立標準沙盒
欲使用部署至生產環境功能,必須先建立標準沙盒。建立步驟如下:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
- 在左側邊欄選單中,選擇「沙箱」。
- 點擊建立沙箱。

- 在右側面板的「沙箱名稱」欄位輸入沙箱名稱。
- 在「沙箱設定」區塊中,選擇要從生產環境帳戶複製至沙箱的項目:
- 「複製生產環境資產」核取方塊預設為勾選狀態,因沙盒環境需完全模擬生產帳戶。
- 勾選「複製 5,000 個聯絡人及相關記錄」方塊,即可複製最近更新的 5,000 個聯絡人,以及每個聯絡人最多 100 筆相關交易、公司和票證記錄。
請注意:建立標準沙箱時最多可複製 5,000 筆聯絡人及其關聯記錄。若未在建立時複製記錄,可於後續階段匯出測試記錄並匯入沙箱。
- 點擊建立標準沙盒。

- 建立沙盒的過程可能需要數小時,具體時間取決於需從生產帳戶複製的資產數量、生產計畫功能及超級管理員數量。
- 建立狀態將顯示於「活動記錄」標籤頁的「狀態」欄位。
- 完成建立後狀態將自動更新。

- 點擊沙盒旁的狀態可檢視建立詳情。
點擊「失敗資產」標籤頁查看失敗資產及錯誤詳情。
- 點擊「失敗資產」標籤頁查看任何失敗資產及其錯誤詳情。
- 點擊「成功資產」標籤頁可檢視已建立資產清單。

存取標準沙盒
所有標準沙盒帳戶使用者皆可透過主帳戶選單存取沙盒:
- 在您的 HubSpot 帳戶中,點擊右上角的帳戶名稱。
- 將游標懸停於 帳戶名稱上,即可查看近期帳戶清單。
- 在下拉式選單中,點擊您要存取的沙盒名稱。

- 視窗頂端將顯示橫幅,表明您已進入標準沙盒帳戶。
![]()
超級管理員亦可透過帳戶設定存取沙盒:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
- 於左側邊欄選單中,選擇「沙盒」。
- 點擊您要存取的沙盒名稱。
- 要退出沙盒帳戶,請點擊視窗頂部的「返回我的生產環境帳戶」。
設定生產環境部署
在沙盒環境完成變更後,即可將其部署至生產環境帳戶。設定 生產部署步驟如下 :
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
- 在左側邊欄選單中,選擇「沙盒」。
- 將游標懸停於沙盒上方,點擊「動作」→「 」,然後選擇「設定部署」。
- 在可用資產類型欄位中,選擇欲部署的資產。若部署物件,請於資產旁點擊「選取設定」
-
- 勾選每個符合部署條件的變更項目旁的核取方塊。若您正在部署物件,此操作將位於右側面板,且必須點擊「儲存選取項目」。
請注意:若在沙盒中建立新物件,必須部署所有變更。
- 勾選每個符合部署條件的變更項目旁的核取方塊。若您正在部署物件,此操作將位於右側面板,且必須點擊「儲存選取項目」。
- 點擊「下一步」。
- 所有關聯設定將顯示於「關聯設定」步驟。關聯設定指您帳戶中其他資產,且被您選取的資產所使用的資產。
- 在名稱欄位 點擊檢視物件配置,即可根據關聯關係查看即將部署的內容。
- 點擊「使用於」欄位的 x 個已選資產,即可檢視相關連結。
-
若要將配置納入部署,請勾選「將 x 個關聯新增至我的部署」複選框,然後點擊「下一步」。
- 系統將自動偵測衝突狀況。點擊「下一步」。
- 於「部署名稱」欄位輸入部署名稱,在「描述」欄位輸入說明文字。點擊「下一步」。
- 檢視您的生產環境部署。準備就緒後,點擊「部署至生產環境」。
- 點擊「部署至生產環境」以確認。

- 此部署將新增至「生產環境部署」清單。狀態欄位將顯示進度。部署一旦啟動即無法取消。
- 部署完成後,狀態將更新為「x 項變更已部署」。
- 請注意:若部署失敗,請重新嘗試部署或聯繫技術支援。
- 點擊部署名稱或「x 項變更已部署」可檢視部署詳細資訊。
