Plastic Cloud extension

欢迎使用 Plastic Cloud - Plastic SCM 托管解决方案。

本指南的目的是帮助您快速了解 Plastic Cloud extension 及其重要概念。

本指南用作在 Cloud 中启动和运行 Plastic 存储库的演练教程。

Plastic Cloud 是托管的 Plastic SCM 服务器解决方案。

我们有两种不同的 Cloud 产品：

Plastic SCM Enterprise Edition + Cloud extension

适用于需要本地服务器（包含在 Enterprise Edition 中）和在 Cloud 上托管存储库的团队。
要求：购买 Enterprise Edition 并添加 Cloud extension（非 Cloud Edition）。
本指南记录了该版本的 Plastic Cloud。

Plastic Cloud Edition

这是一款不同的产品，专为不需要本地服务器的团队而设计。唯一的中心位置是 Cloud。
团队成员可以拥有存储库的本地克隆，或者直接连接到 Cloud 进行工作。
要求：购买 Cloud Edition（非 Enterprise + Cloud）。

从用户的角度来看，您将像使用传统的 Plastic SCM 服务器一样使用 Plastic Cloud；您将推送和拉取分支、创建存储库、管理权限等。

在内部，Plastic Cloud 使用完全重新设计的 Plastic 服务器核心。Cloud 核心运行在多个 Cloud 角色之上，而不仅仅是一台计算机上。这意味着它可以通过简单地添加更多角色（计算机）来进行水平扩展。

Plastic Cloud 是一种多租户且高度可扩展的解决方案，能够应对数千个不同的组织。它会最大限度利用底层 Cloud 基础架构。

实际上，这意味着您不必担心服务器设置或维护。我们会为您处理妥当！

在本指南中，我们将说明 Cloud extension 的工作原理。

Plastic Cloud extension 适合的场景有很多。仅举几例：

• 您有一个小团队，不想处理任何基础架构。您已经在自己的笔记本电脑上运行 Plastic，但不想安装和管理您自己的 Plastic 服务器。但是，您仍然需要一个适合团队的中央集合点。Plastic Cloud extension 适合您。
• 您是在全球多个位置工作的大型企业团队的一员。您需要一台中央服务器，但又不想依赖您的 IT 团队。您可以为自己设置一个 Plastic Cloud 组织，并将其用作您的托管中央服务器。
• 您有一个游戏开发团队（或任何其他处理大型存储库和大型文件的团队），并且无法通过主流的版本控制软件托管提供商找到合适的解决方案。基于 Git 的解决方案具有众所周知的 2GB 存储库限制。如果您需要更多空间，Plastic Cloud 适合您。

这些只是 3 个重要场景，但还有更多。一些团队要求我们使用 Plastic Cloud extension 作为基于 Cloud 的实时备份，这当然也是一种选择。

获得 Enterprise Edition 许可证后，为了使用 Plastic Cloud extension，首先需要创建一个组织。

组织是处理 Cloud 中不同存储库集的方式。在组织内部，您可以根据需要创建任意数量的存储库。

创建组织的方式如下：

1. 转到您的 plasticscm.com Cloud 仪表板以添加 Plastic Cloud extension。

   或者，访问 plasticscm.com/cloud 并单击立即订阅！按钮。

2. 随后将出现一个新页面，您必须在其中输入订阅和帐户信息以及与组织相关的以下数据：
   • 组织名称 - 这是在 Cloud 中用于识别存储库的名称... 所以请选择一个炫酷的名称。
   • 数据中心 - 选择离您最近的数据中心，以便提高数据传输速度。
3. 随后将生成该组织，并且我们会通知您。
4. 您将能够登录 Plastic Cloud :-) 并开始使用该组织。

让我们看看如何访问 Cloud 服务器。

1. 访问 Plastic GUI 并打开 Cloud 视图。显示的内容如下所示：
2. 直接键入 organization_name@cloud 作为服务器名称。比如，我的组织是 test。因此，我应该键入 test@cloud。
3. 然后，单击 （刷新）（或按 Enter 键）以访问您的组织。
4. 系统会提示您输入凭据以访问 Cloud 服务器：

   输入您在购买 Enterprise Edition 许可证时用于在 www.plasticscm.com 上注册的凭据。

   如果选择下次记住凭据，则会创建连接配置文件。这样，以后将不再需要输入凭据。
5. 然后，您将看到可用存储库的列表。这个列表现在是空的！这是因为我们还没有在 Cloud 中创建任何存储库，不过我们已经连接上了！
6. 让我们像往常一样创建一个存储库：
7. 然后，我们的存储库列表将刷新，这次会显示我们的第一个 Cloud 存储库：

从这里开始，您将能够正常使用此 Cloud 存储库。

将分支推送到 Cloud 就像将其推送到常规 Plastic SCM 服务器一样简单。在我的这个示例中，我将进行如下操作：

我的 main 分支已在 Cloud 中准备就绪！

最后的一点提示：每当可以使用服务器名称时，都可以使用 organization_name@cloud。也就是说：

• 可从 CLI 执行类似 cm repo list test@cloud 的命令以列出可用的存储库。
• 可创建从本地服务器到 Cloud 组织的同步视图。
• 可从 GUI 列出存储库并远程打开其分支资源管理器。
• 可在 Cloud 服务器上远程批注某个文件。
• 以及大量其他操作！

您可以直接使用您的 Cloud 存储库。

只需要创建一个连接到您的 Cloud 存储库的工作区：

本章介绍如何从 Gluon（专为美术师和内容创作者设计的 Plastic SCM 版本）访问 Plastic Cloud。

由于您选择了在安装完成后启动 Plastic Gluon，因此 Gluon 将启动。

由于 Gluon 没有检测到任何以前的 Plastic SCM 配置，因此将显示配置屏幕：

字段设置非常简单：

• 服务器 - 只需键入您组织的名称，然后是 @cloud。您将收到一封电子邮件，其中包含您受邀加入的组织或您购买的组织。在我的这个示例中，我键入了 test@cloud，因为我组织的名称是 test。
  您可以单击连接以确认您可以正确连接到您的 Cloud 组织。
• 凭据 - 键入您用于登录 plasticscm.com 的电子邮件地址和密码。
  您可以单击检查以确认您输入的凭据正确无误。
• 存储库 - 单击选择... 以选择要处理的项目（又名存储库）。您组织中的所有存储库都会列出。
• 工作区 - 最后，在您的计算机上键入工作区的路径以用于托管您将从 Cloud 下载的文件。

大功告成！单击应用以开始使用 Gluon。

配置 Gluon 后，它会显示您最近创建的工作区：

您的工作区最初将是完全空的，因为您还没有从 Cloud 下载任何文件。

只需单击配置浏览到您的项目（如果您愿意，也可以浏览到存储库），然后选择要下载到磁盘的内容即可开始处理。

就我而言，我只选择了几个要下载的文件。但是，您可以选择下载整个目录树或其中的一部分：

然后，只需单击应用，下载就会开始。

根据前面的介绍，要访问 Plastic Cloud 存储库，只需使用 organization_name@cloud 组合作为服务器名称。

您机器中的常规本地存储库命名为：repo@local。

在 Plastic Cloud 中，此存储库命名为：repo@organization_name@cloud。

@cloud 部分只是告诉 Plastic 连接到 Plastic Cloud 的快捷方式。事实上，您可以执行如下所示的操作：

而且，可以看到，fantasywarrior3d@cloud 等效于 fantasywarrior3d@cloud.plasticscm.com。

确认您的组织已准备就绪后，您将能够通过登录 https://www.plasticscm.com/dashboard/cloud 访问您的 Cloud 仪表板。

登录后，您将进入组织管理区域。目前的选项不多，因此您会发现使用起来非常简单。

基本上，您看到的只是您所属组织的列表。

如果您是某个组织的管理员（当您申请该组织时，我们会将您设为管理员），您将能够对该组织进行管理。

• 如果单击编辑后，您将看到如下内容：
  

  这是一个简单的页面，您可以在其中编辑组织的名称和描述。

  重要

  仅当组织为 cloud2 时，才可编辑组织名称字段。

• 您可以单击查看活动按钮打开一个新页面，然后可以在其中查看整个 Cloud 组织的使用情况：
  

• 还可以单击详细信息链接以按存储库启动一个包含详细信息的新页面：
  

请阅读以下章节，了解您可以如何管理 Cloud 组织以及可以进行哪些管理。

单击 Cloud 仪表板中的编辑锁定规则按钮，即可开始配置独占签出。

锁定规则允许在执行签出时为二进制文件配置独占锁定。

在处理不能像二进制文件那样合并的文件（图像、视频、音频...）时，独占签出（或锁定）很有用。

使用此功能可以告诉 Plastic SCM 在签出时需要锁定哪些类型的文件。如果已启用此功能，签出某个文件将阻止其他用户执行相同的操作，直到您签入或撤销更改。任何用户都可以放心，在他们处理已签出文件时，不会出现对已签出文件的新修订。

系统执行以下操作：

• 文件是否已锁定？如果是，则无法将该文件签出。
• 如果未锁定，则该文件可能“可锁定”。Plastic SCM 将检查文件名是否与任何已定义的锁定规则匹配。如果文件名与规则匹配，该文件将被锁定。

您可以定义可应用于以下项的规则：

• 所有存储库（组织规则）
• 特定存储库。这些规则可以是文件扩展名（例如 *.xlsx、*.png 或 *.blend）或特定文件名（例如 readme.txt）。

1. 要为组织（所有存储库）创建/编辑锁定规则，请执行以下操作：
   1. 输入要应用的锁定规则。可单击加载常用锁定规则按钮来加载最常用的规则（与二进制文件相关的规则）。可添加更多规则或删除其中的一些规则。
   2. 要存储锁定规则，请单击保存按钮以存储锁定规则。
2. 要为特定存储库创建/编辑锁定规则，请执行以下操作：
   1. 对于需要编辑锁定规则的存储库，单击添加存储库规则按钮：
   2. 存储库名称下将出现一个新的空字段：
   3. 输入您自己的规则，或单击加载常用锁定规则以加载建议的常用锁定规则。您也可以编辑规则。
   4. 单击保存按钮。

   可随时通过单击清除存储库规则来删除所有存储库规则。

Plastic Cloud 使用相同的底层机制来处理用户和组，就像常规的 Plastic SCM 服务器一样。但与 Plastic SCM 不同的是，Plastic Cloud 不会从 LDAP、Active Directory 或自定义的用户/密码文件中检索用户和组，而是采用如下工作方式：

• 从 plasticscm.com 检索用户。您可以邀请任何用户加入您的组织，一旦他们注册了 plasticscm.com，他们就将成为有效用户。
• 由组织定义组。这就像从组织管理区域定义的基于 Cloud 的 groups.conf。您可以将受邀用户添加到您创建的组中。

您可以为用户和组定义对 Cloud 服务器的访问策略。您可以像常规服务器一样使用 Plastic SCM GUI 工具或命令行来配置访问策略。此时，您需要在 Web 界面中执行的操作就是定义用户、组及其关系。

您可以在 Web 界面中将用户定义为管理员，但这仅意味着他们可以访问组织管理区域。此设置对 Plastic 存储库没有任何影响。

为了更好地了解 Plastic SCM 用户和组，请参阅我们的在线文档。

在用户和组组织管理区域中，只需单击添加新用户，您将到达以下页面：

您可以输入要邀请的任何用户的电子邮件地址，即使他们还不是 plasticscm.com 用户也没关系。他们必须在 plasticscm.com 中注册之后才能登录，但您已经可以将他们作为有效用户来配置您的组。

默认情况下，任何新用户都会自动添加到一个名为 Developers 的内置组中。当然，您可以删除该组或进行重命名。

默认情况下，每个新的组织都带有两个组：Administrators 和 Developers。每个标记为 Administrator 的新用户都将进入 Administrators 组，其他所有人都将进入 Developers 组。

您可以添加新组、删除默认组或重命名它们。

还可以将用户添加到组中。只需单击组名称右侧的 编辑图标即可访问组配置区域：

此处，我只想编辑预配置的 Developers 组。

从此处，我可以删除用户并添加新用户，还可以创建新组。此外，还可以重命名组以及编辑其描述。

如果我单击添加新成员，我将进入以下页面：

此处，我可以简单地输入要添加到组中的用户的电子邮件地址。

根据前面的介绍，对组织进行配置的过程非常简单。只需点击几下，就可以完成所需的一切。

此时，在 Web 界面中只能配置用户和组。其他的任何设置，像往常一样，都可以从 Plastic SCM GUI 或命令行界面中完成。

Plastic Cloud extension 是什么？

Plastic Cloud 是 Enterprise Edition 的扩展。这是同步在本地运行 Plastic SCM 服务器的多个团队的完美解决方案。

您可以毫无问题地在 Plastic Cloud 存储库中托管数千兆字节的数据。更多信息，请参阅 plasticscm.com/cloud

使用 Plastic Cloud extension 需要什么？

如果您希望将自己的存储库存储在 Plastic SCM 托管的服务中，您需要一个 Plastic Cloud 订阅，并结合使用本地 Plastic SCM 订阅。

要订阅 Plastic Cloud，您必须拥有有效的 Plastic SCM 许可证。

示例：

• Plastic Cloud + 五名用户的 Enterprise Edition 许可证 - 整个团队都将能够访问 Plastic Cloud。

Plastic Cloud extension 是否需要本地 Plastic SCM 服务器？

简短回答：如果使用的是 Plastic Gluon，不需要。如果是使用常规 Plastic SCM 的开发者，需要。

现在让我们进行更详细的说明。

程序员可以在分布式工作流程中使用 Plastic SCM 来获得更好的体验。这意味着他们将通过将本地存储库中的分支推入/拉出 Plastic Cloud 来获得更好的性能，而不是直接签入到 Cloud。要进行分布式工作，您需要一个本地服务器，无论这个服务器是团队的中央服务器、在每个开发者本地安装，还是这些安装方案的组合，都是可以的。

仍然可以直接签入到 Plastic Cloud。这是针对 Plastic Gluon 用户的推荐工作方式；Plastic Gluon 是为游戏开发美术师、文档编写者、项目经理以及其他不需要处理代码但需要处理其他二进制资产且不需要合并操作的团队成员设计的工具。如果需要，开发者也可以直接在 Plastic Cloud 上签入并合并。

如何将我的数据上传到 Plastic Cloud？

您只需要将数据从您的本地 Plastic SCM 服务器（或您团队的本地服务器）推送到 Plastic Cloud。

推送到 Cloud 与推送到常规远程 Plastic SCM 服务器的方式相同。

您可以设置同步视图以批量推送/拉取分支。请注意，远程存储库将被引用为 reponame@organization@cloud。例如：tetris@arcadegarage@cloud。@cloud 部分只是告诉 Plastic SCM 连接到 Cloud 服务器，而不是指定完整的 IP 或域名。

我可以使用 Plastic Cloud extension 签入并合并吗？

是的，从 5.4.16.792（2016 年 11 月 14 日）开始可以直接签入并合并。以前，我们不鼓励开发者直接签入并合并，因为我们认为这种操作的速度更慢，而且通过从他们的本地存储库推送/拉取会更好地为他们服务，但是我们收到了许多客户的请求，他们更喜欢这种更简单的工作方式。

我们相信，游戏开发美术师、文档编写者、项目经理以及其他不需要处理代码但需要处理其他二进制资产且不需要合并操作的团队成员将极大地受益于 Plastic Gluon + Plastic Cloud。他们将能够执行直接签入并仅下载他们需要的资产或内容文件。此外，可以配置独占签出以确保在给定时间只有一个人在修改每个文件。

我们相信，代码开发者可以在分布式工作流程中使用 Plastic SCM 来获得更好的体验。这意味着通过将他们的分支推送/拉取到 Cloud 可能会更好地为他们服务，但如果他们愿意，他们也可以采用集中式工作。他们还可以使用 Cloud 服务器进行合并。

针对开发者的一些备注：

• 在 Cloud 中签入会更慢，因为数据必须通过 Internet（因此会通过延迟更高的网络）进行传输，而不是在本地或 LAN 上的服务器上执行签入。这对于美术师和处理文档的团队成员来说没有问题，但希望进行超快速签入的开发者会发现它很慢。简而言之，对于开发者来说，直接签入到 Cloud 就像回到了旧的 SVN 时代。尽管如此，我们仍会为喜欢集中式工作的开发者持续优化整个周期。
• 然而，虽然推送和拉取分支肯定也会受到网络延迟的影响，但您不会经常这样做。这意味着拥有远程服务器的影响是速度较慢。DVCS 的工作方式如下：大量本地签入，然后只进行一次推送，这一工作方式与许多开发者过去使用 Git/GitHub 的情况相同。

简而言之，您可以在 Plastic Cloud 上签入并合并，但如果开发者觉得他们需要更快的操作，我们建议他们考虑 DVCS + Plastic Cloud 工作流程。

如果我使用 Plastic Gluon 访问 Plastic Cloud，我可以锁定文件吗？

是的，您可以。而且，您可以从 Plastic Cloud 组织的仪表板配置将在签出时锁定的文件。

我需要哪个版本的 Plastic SCM 才能访问 Plastic Cloud？

您需要 5.4.16.719 或更高版本。我们的网络 API 已针对 Plastic Cloud 进行了更新和扩展，因此旧版本将无法使用。

与 Plastic Cloud 的连接安全吗？

是的，Plastic Cloud 仅允许 SSL 连接。Plastic 知道与 @cloud 的每个连接都必须受到安全保护。

虽然常规 Plastic SCM 服务器同时侦听 TCP 和 SSL，但 Plastic Cloud 仅限使用 SSL 以强制执行安全通信。

因此，您的服务器或客户端与 Cloud 的连接必须正确配置为使用 SSL（顺便提一下，这是默认的开箱即用设置）。

如果我不小心删除了 Plastic Cloud 中的存储库，会发生什么情况？

不要慌。您的数据还在。

实际上，当一个存储库被删除时，它只是被标记为已删除。您将有长达两周（14 个自然日！）的时间来恢复（或撤销删除，这是 GUI 上显示的操作）已删除的存储库。一旦这 14 天过去，存储库数据和元数据将被永久删除。

注意：您必须是组织的所有者才能查看“已删除”存储库的列表以及撤销删除存储库。

Plastic Cloud 托管在哪里？

Plastic Cloud 目前托管在 Microsoft Azure 中。这意味着 Plastic Cloud 建立在由值得信赖的提供商提供且经过充分验证的技术之上。

Plastic SCM 元数据存储在 SQL Server Azure 与 Blob 存储的组合中。为实现高可用性和冗余性，数据库具有复本。

已进行版本控制的文件存储在 Azure blob 存储中。每个 Blob 在两个不同的物理位置最多复制六次。

选择数据中心是什么意思？

为了加快数据传输速度，您可以选择离自己最近的数据中心来存储您已进行版本控制的文件数据。

世界各地有多个数据中心，因此通过选择离您的团队最近的一个，您将减少网络延迟，从而大幅改善数据传输。

Plastic Cloud 是否提供在线浏览存储库的方法？

当前没有。您可以使用自己的 Plastic SCM 客户端来列出存储库，就像使用常规远程 Plastic SCM 服务器一样。

Plastic Cloud 采用什么样的许可方式？

您需要一个有效的 Plastic SCM 许可证（更多有关“许可”的内容见下文）才能订阅 Plastic Cloud。该许可证可以是有效的 Enterprise、Cloud 或 Personal Edition 许可证。还可以使用 Trial Edition。

然后，您需要按团队计费的 Plastic Cloud 订阅。

• Plastic Cloud 起价为每个团队每月 4.95 美元，最多可提供 15GB 的存储空间。此级别适合处理小型存储库的团队使用（至少 Plastic SCM 认为这很小 :P）。
• 下一个级别是每个团队每月 19.95 美元，最多 100GB，这是专为游戏开发团队、3D 设计团队或需要处理大型二进制文件的团队设计的订阅级别。
• 在第一个 100GB 之后，您的订阅将按 50GB 的存储桶增加，对于每个存储桶，每个团队每月额外支付 7.45 美元。

Plastic Cloud 会自动将您的订阅升级到下一个规模级别，而不会中断服务。您将在下次收费前 7 天收到一封电子邮件，其中包含付款的详细信息。

我是 Community Edition 用户，可以使用 Plastic Cloud 吗？

是的，符合开源项目和非营利组织资格的 Community Edition 用户可以订阅 Plastic Cloud，并使用他们的 CE 许可证来访问该服务。

我是 Personal Edition 用户，可以使用 Plastic Cloud 吗？

是的，您可以在使用 Personal Edition 时免费订阅 Plastic Cloud。

我有 Plastic SCM 试用许可证；我可以用它连接到 Plastic Cloud 吗？

是的，试用许可证是功能齐全的许可证，允许您访问 Plastic Cloud。事实上，这是在购买之前试用整个生态系统的好方法，因为您有 30 天的时间免费使用这两种产品。

如果我取消订阅会怎样？

如果您取消订阅，在我们移除您的组织以释放空间之前，您将有几天（通常为一周）的时间索回所有数据。取消时，您将收到一封电子邮件，通知您数据何时最终会被删除。

2020 年 11 月 23 日

现在可以编辑组织的名称。

2020 年 9 月 21 日

2019 年 6 月 13 日

2019 年 5 月 29 日

2017 年 6 月 29 日

2017 年 2 月 7 日

2016 年 12 月 14 日

2016 年 11 月 30 日

2016 年 11 月 21 日

2016 年 1 月 21 日

2015 年 12 月 4 日