创建沙箱并将更改部署到生产环境

请注意： a自 2026 年 4 月 30 日起，旧版标准沙盒将不再受支持。为确保平稳过渡，对于仍拥有旧版沙盒的账户，沙盒限制已暂时放宽，允许您在旧版沙盒仍可使用期间创建新沙盒，直至您准备好将其删除为止。

开始之前

了解要求

限制与注意事项

• 默认情况下，所有超级管理员、具有提升权限的合作伙伴管理员以及拥有开发工具访问权限的用户，都会在创建沙箱时被复制到该沙箱中。
  • 创建完成后，当您将超级管理员添加到生产环境账户时，需要手动将其添加到沙箱账户中。
  • 创建完成后，当某位超级管理员从生产环境账户中移除时，该用户将自动从沙箱账户中移除。
• 了解在创建沙箱时，哪些生产环境资产会被复制到沙箱账户中。
• 了解“部署到生产环境”功能支持哪些对象配置和资产。
• 沙箱账户与生产账户中的联系人、公司、商机、工单和自定义对象的 ID 将不相同。您可以考虑创建一个新的自定义属性（例如“外部记录 ID”），并使用自动化流程将生产记录的 ID 复制到该字段中，然后在需要进行测试时，可在沙箱中使用这些 ID。
• 整个沙盒账户的所有工作流每天最多只能注册 100,000 条记录。超过此上限的任何额外工作流注册都将被丢弃。当达到上限时，系统会在您的账户中通知您，并告知您何时可以再次同步。
• 如果某种资产类型在创建时无法复制到标准沙盒账户，依赖于该资产类型的资产也将无法同步。例如，由于调查问卷不符合复制到标准沙盒账户的条件，所有将调查问卷用作触发器或操作的工作流都不会被复制。 
• 您生产账户中的集成不会自动连接到标准沙盒账户。对于任何您希望连接到沙盒账户的现有集成，HubSpot 建议您连接到该集成的沙盒版本，以避免对您的 CRM 数据造成干扰。
• 您可以从标准沙盒账户向与现有沙盒用户拥有相同电子邮件地址的联系人记录发送一对一测试邮件和营销邮件。
  
  • 如果您向非沙盒用户的联系人发送电子邮件，由于这些联系人并非标准沙盒账户中的用户，因此邮件将无法发送。
  • 从标准沙盒账户发送的电子邮件将通过生产账户使用的共享 IP 地址进行路由。

创建标准沙盒

要创建沙盒：

1. 在 HubSpot 帐户中，单击顶部导航栏中的 “设置”图标。
2. 在左侧边栏菜单中，选择“沙箱”。
3. 点击“创建沙盒”。
   
   
4. 在右侧面板的“沙盒名称”下，输入沙盒的名称。
   • “复制生产环境资源”复选框默认处于选中状态，因为沙盒必须模拟您的生产环境账户。点击downIcon图标，查看将复制到沙盒的资源列表。
   • 点击“此沙盒的用途是什么？”下拉菜单并选择选项。要删除选项，请点击该选项旁边的“X”。
   •  选中“复制 5,000 个联系人及其关联记录”复选框，即可复制您最近更新的 5,000 个联系人，以及每个联系人最多 100 条关联的商机、公司和工单。

请注意： 在创建标准沙盒时，您可以复制 5,000 个联系人及其关联记录。如果您在创建沙盒时未复制记录，日后仍可导出并导入测试记录到沙盒中。 对于以下每个对象，您可以手动导入最多 200,000 条记录：联系人、公司、商机、服务单、自定义对象、购物车、发票、营销活动以及订单（按记录类型计算）。对于其余记录类型，请了解如何跟踪您的 CRM 数据使用情况。

6. 点击“创建标准沙盒”。
7. 创建沙盒的过程可能需要几个小时，具体时间取决于需要从您的生产账户中复制的资产数量、生产计划功能，以及超级管理员、具有提升权限的合作伙伴管理员和拥有开发工具访问权限的用户 的数量。 了解沙盒账户中权限的处理方式。
8. 状态可在“创建于”列中查看。创建完成后，状态将更新为创建的日期和时间。
9. 要查看失败的资源，请单击“活动日志”选项卡。然后，单击沙盒旁边的状态以查看创建详细信息。 
   • 点击“失败的资源”选项卡，查看所有失败的资源及其错误详情。
   • 点击“已复制资产”选项卡，可查看已创建资产的列表。

访问标准沙盒

所有在创建沙盒时被复制的超级管理员均可通过其主账户菜单访问沙盒。

1. 在您的 HubSpot 账户中，点击右上角的账户名称。 
2. 将鼠标悬停在您的 账户名上，即可查看最近使用的账户列表。 
3. 在下拉菜单中，点击您要访问的沙盒名称。
   
   
4. 窗口顶部将显示一条横幅，表明您当前处于标准沙盒账户中。

 超级管理员还可以通过账户设置访问沙盒：

1. 在 HubSpot 帐户中，单击顶部导航栏中的 “设置”图标。
2. 在左侧边栏菜单中，选择“沙盒”。
3. 点击您要访问的沙盒名称。 
4. 要退出沙箱账户，请在右上角点击您的生产账户名称。

设置生产环境部署

在沙盒中完成修改后，您可以将受支持的资源部署到生产环境账户。要 设置生产环境部署，请 导航至您的生产环境账户，然后：

1. 在 HubSpot 帐户中，单击顶部导航栏中的 “设置”图标。
2. 在左侧边栏菜单中，选择“沙盒”。
3. 在右上角，点击“设置部署”。
   • 在“受支持的资产类型”列中，选择您要部署的资产。如果您要部署对象，请在资产旁边点击“选择配置”。
   • 若要了解每种资产支持哪些部署操作，请在顶部横幅中点击“查看 [X] 部署行为”。在右侧面板中查看相关信息，然后点击“关闭”。
     
     
4. 勾选每个符合部署条件的更改旁边的复选框。如果您要部署对象，此操作将在右侧面板中进行，并且必须点击“保存选择”。

请注意：每次最多可部署300 项变更。 

7. 点击“下一步”。 
8. 所有连接将在“已连接资产”步骤中显示。已连接资产是指您所选资产所使用的、且部署过程中必需的其他资产。
   
   • 在“名称”列中 单击“查看对象配置”，根据连接查看将要部署的内容。
   • 单击“被使用于”列 中的“x 个选定资产”，以查看连接。

   • 若要将该配置纳入部署，请选中“将 x 个连接添加到我的部署中”复选框，然后单击“下一步”。

9.  系统将自动检测任何冲突。请检查错误并解决冲突，以便继续部署。如果未检测到冲突，请单击“下一步”。
10. 在“部署名称”字段中，输入部署的名称。在“描述”字段中，输入描述。点击“下一步”。
11. 检查您的生产环境部署。准备就绪后，点击“部署到生产环境”。
12. 在对话框中，单击“部署到生产环境”以确认。

13. 部署开始后，生产环境的“活动日志”选项卡中的“状态”列将显示为“进行中”。部署一旦开始，便无法取消。
14. 部署完成后，状态将更新为 [#] 个已部署资源。

• 请注意：如果部署失败，请查看部署错误日志以排查可能导致失败的原因。如需进一步协助，请联系支持团队。

15. 点击部署名称或 [#] 已部署资产 以查看部署详情。

查看沙盒活动

要查看用户在您的账户中执行的沙盒操作历史记录：

1. 在 HubSpot 帐户中，单击顶部导航栏中的 “设置”图标。
2. 在左侧边栏菜单中，导航至“沙盒”。
3. 点击“活动日志”选项卡。
4. 将显示与沙盒相关的完整活动列表，包括：
   • 沙盒创建详情（即复制的资源和错误原因）
   • 过往的生产环境部署
   • 沙盒删除操作
5. 点击“日志类型”下拉菜单，可在不同活动类型之间进行筛选。

沙箱最佳实践

沙箱允许用户在生产账户之外安全地进行创新。建议制定开发策略，并考虑以下方面以确保在沙箱中进行可靠的测试：

• 沙箱的用途是什么？（例如：积极开发、集成测试、培训）。
• 谁需要访问权限？（例如，考虑限制可能影响测试可靠性的冲突）。
• 是否需要更多沙箱来支持各种用例？
• 创建和管理沙箱以满足开发需求的最佳方式是什么？

明确界定这些方面，既有助于实现可靠的测试，又能将受支持的资产部署到生产环境，同时兼顾其他用例。

以下是沙箱不同用途、应获得访问权限的用户以及确保可靠测试和开发的创建策略的示例：