Plastic Cloud extension

歡迎使用 Plastic Cloud - Plastic SCM 託管解決方案。

本指南旨在協助您快速瞭解 Plastic Cloud extension 及其重要概念。

本指南可逐步引導您備妥 Plastic 儲存庫，以在雲端中啟動並執行。

Plastic Cloud 是託管的 Plastic SCM 伺服器解決方案。

我們有兩種不同的 Cloud 產品：

Plastic SCM Enterprise Edition 加上 Cloud extension

適用的團隊需要內部部署伺服器 (隨附於 Enteprise 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 伺服器核心。雲端核心會在數個雲端角色上執行，而不只是一部電腦。這表示，它可直接新增更多角色 (電腦) 來進行水平擴展。

Plastic Cloud 是多租用戶且可高度擴展的解決方案，能夠處理數以千計的不同組織。它會盡可能以最完善的方式使用優先雲端基礎結構。

實際上，這表示您不必擔心伺服器設定或維護作業。我們會為您處理該作業！

在本指南中，我們將說明 Cloud extension 的運作方式。

有許多 Plastic Cloud extension 適用的案例。舉幾個例子來說：

• 您有一個小型團隊，而且不想要處理任何基礎結構。您已在膝上型電腦上執行 Plastic，但您不想要安裝和管理自己的 Plastic 伺服器。不過，您仍需一個可供團隊使用的中央會合點。Plastic Cloud extension 是您的理想選擇。
• 您是在全球多個位置工作的大型企業團隊的一員。您需要一個中央伺服器，但您不想要依賴您的 IT 群組。您可以設定 Plastic Cloud 組織，並用它做為託管的中央伺服器。
• 您有一個遊戲開發團隊 (或處理大型儲存庫和大型檔案的其他任何團隊)，而且您找不到具有版本控制軟體之主流託管提供者的適合解決方案。以 Git 為基礎的解決方案有眾所周知的 2 GB 儲存庫限制。如果您需要超過此限制的容量，Plastic Cloud 是您的理想選擇。

以上這些只是 3 個主要案例，但還有許多其他案例。某些團隊要求我們使用 Plastic Cloud extension 做為即時雲端式備份，這當然也是一種選擇。

一旦有了 Enterprise Edition 授權，您開始使用 Plastic Cloud extension 時需要做的第一件事就是建立組織。

組織是在雲端中處理不同組的儲存庫的方法。在組織內，您可以視需要建立任意數量的儲存庫。

以下是您可以建立組織的方法：

1. 前往您的 plasticscm.com Cloud 儀表板新增 Plastic Cloud extension。

   或者，前往 plasticscm.com/cloud，然後按一下 [立即訂閱!] 按鈕。

2. 新頁面隨即顯示，您必須在該頁面中輸入訂閱和帳戶資訊，加上以下與組織相關的資料：
   • 組織名稱 - 這是在雲端中識別儲存庫的方法... 因此請選擇一個酷炫的名稱。
   • 資料中心 - 選取離您最近的資料中心，以改善資料傳輸速度。
3. 組織將隨即產生，我們將會通知您。
4. 您將能登入 Plastic Cloud :-) 並開始使用。

讓我們看看如何存取您的雲端伺服器。

1. 前往 Plastic GUI 並開啟 Cloud 檢視。您將會看到如下所示畫面：
2. 輸入 organization_name@cloud 做為伺服器名稱即可。就我來說，我的組織是 test。因此，我應輸入 test@cloud。
3. 然後，按一下 (重新整理) (或按下 Enter 鍵) 存取您的組織。
4. 系統會提示您輸入認證資料以存取雲端伺服器：

   若已購買 Enterprise Edition 授權，請輸入在 www.plasticscm.com 註冊時所使用的認證。

   如果您選擇記住認證資料供下次使用，便會建立連線設定檔。這麼做之後，就不必再輸入認證資料了。
5. 然後，可用儲存庫清單隨即顯示。空白！這是因為我們尚未在雲端中建立任何儲存庫，但我們已經連線！
6. 我們來建立儲存庫，像平常的作法一樣：
7. 然後，我們的儲存庫清單會重新整理，這次會顯示我們的第一個雲端儲存庫：

從這裡您將能像平常一樣地使用此雲端儲存庫。

將分支推送至雲端，就像將其推送至一般 Plastic SCM 伺服器一樣簡單。就我的案例來說，我會這樣做：

我的 main 分支已在雲端中準備就緒！

最後的提示。無論您何時使用伺服器名稱，都可使用 organization_name@cloud。這表示：

• 您可以從 CLI 執行類似 cm repo list test@cloud 的動作，列出可用的儲存庫。
• 您可以建立同步檢視 (從本機伺服器至雲端組織)。
• 您可以從 GUI 列出儲存庫，並在遠端開啟其分支瀏覽器。
• 您可以在雲端伺服器上遠端標註檔案。
• 還有其他更多操作方式！

您可以直接使用您的 Cloud 儲存庫。

您只需建立連線至 Cloud 儲存庫的工作區：

本章說明如何從 Gluon (專為藝術家和內容創作者所設計的 Plastic SCM 版本) 存取 Plastic Cloud。

由於您已選取 Plastic Gluon 以在安裝完成後啟動，因此 Gluon 將隨即啟動。

由於 Gluon 未偵測到任何先前的 Plastic SCM 設定，因此將會出現設定畫面：

填寫資訊非常簡單：

• 伺服器 - 只需輸入組織名稱，接著輸入 @cloud。您將會收到含有您已受邀加入之組織或您已購買之組織的電子郵件。就我來說，我輸入了 test@cloud，因為 test 是我的組織名稱。
  您可以按一下 [連線]，確認您可正確地連線至雲端組織。
• 認證 - 輸入您用來登入 plasticscm.com 的電子郵件和密碼。
  您可以按一下 [檢查]，確認您已輸入正確的認證。
• 儲存庫 - 按一下 [選擇...] 以選取您要處理的專案 (即儲存庫)。畫面上會列出您組織中的所有儲存庫。
• 工作區 - 最後，輸入您電腦上的工作區路徑，以託管您將從雲端下載的檔案。

完成了！按一下 [套用] 以開始使用 Gluon。

設定 Gluon 後，會隨即顯示您最近建立的工作區：

一開始，您的工作區會完全處於空白狀態，因為您尚未從 Cloud 下載任何檔案。

只要按一下 [設定] 瀏覽您的專案 (或視需要瀏覽儲存庫)，並選取您要下載至磁碟的內容，即可開始運作。

就我來說，我只是選取了一些要下載的檔案。不過，您可以選擇下載整個目錄樹，或只下載其中的一部分：

然後，只要按一下 [套用]，就會開始下載。

如上述，您只需使用 organization_name@cloud 組合做為伺服器名稱，即可存取 Plastic 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 儀表板中的 [編輯鎖定規則] 按鈕，就可以開始設定獨佔簽出。

鎖定規則可讓您在執行簽出時，設定二進位檔案的獨佔鎖定。

在使用二進位檔案 (影像、影片、音訊...) 等無法合併的檔案時，獨佔簽出 (或鎖定) 是很實用的功能。

透過此功能，可以告知 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 後，他們就會成為有效使用者。
• 依組織定義群組。這就像組織管理區域中定義的雲端 groups.conf 一樣。您可以將受邀請的使用者新增至您建立的群組。

您可為使用者和群組定義雲端伺服器的存取原則。您可使用 Plastic SCM GUI 工具或命令列來設定存取原則，就像使用一般伺服器一樣。此時，您只需要在 Web 介面中定義使用者、群組及其關係。

您可以在 Web 介面中將使用者定義為系統管理員，但這只表示他們可以存取組織管理區域。這不會對 Plastic 儲存庫產生任何影響。

若要更深入瞭解 Plastic SCM 使用者和群組，請參閱我們的線上文件。

在 [使用者和群組] 組織管理區域中，只要按一下 [新增使用者]，您就會到達此頁面：

您可以輸入您要邀請的任何使用者的電子郵件，即使對方尚未成為 plasticscm.com 使用者也無妨。他們必須在登入前到 plasticscm.com 註冊，但您可能已經設定群組，將他們視為有效的使用者。

根據預設，任何新使用者都將自動新增至稱為 [開發者] 的內建群組。當然，您可以刪除群組或重新命名。

根據預設，每個新組織隨附兩個群組：系統管理員和開發者。標示為系統管理員的所有新使用者都會移至系統管理員群組，而其他所有人則移至開發者。

您可以新增群組、刪除預設群組或重新命名。

您也可以將使用者新增至群組。只要按一下群組名稱右側的 編輯圖示，即可存取群組設定區域：

在這裡，我要直接編輯預先設定的開發者群組。

我可以從這裡刪除使用者和新增使用者，也可以建立新群組。我也可以重新命名群組並編輯其描述。

如果我按一下 [新增成員]，就會移至以下頁面：

在這裡，我可以直接輸入要新增至群組的使用者的電子郵件。

如您所見，設定組織的方法非常直接明瞭。只要按幾下滑鼠，即可完成所需的一切程序。

此時，您在 Web 介面中可以做的就只有設定使用者和群組。和往常一樣，其他任何作業都是透過 Plastic SCM GUI 或命令列介面進行。

什麼是 Plastic Cloud extension？

Plastic Cloud 是 Enterprise Edition 的擴充功能。這是讓在內部部署環境中執行 Plastic SCM 伺服器的多個團隊保持同步的最佳方式。

您可以將數個 GB 的資料託管於 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 或從中提取，而不直接簽入至雲端，以獲得更高的效能。若要採用分散式工作模式，您需要本機伺服器，無論是供團隊集中使用、讓每位開發者安裝於本機，或是結合這些優點。

不過還是可以直接簽入至 Plastic Cloud。這是提供給 Plastic Gluon 使用者的建議方法，該工具是專為遊戲開發領域的創作者、文件作者、專案經理和其他團隊成員所設計，而這些成員不使用程式碼，但需要處理其他二進位檔資源，且不需要合併作業。開發者也可以視需要直接簽入，並在 Plastic Cloud 上合併。

如何將我的資料上傳至 Plastic Cloud？

您只需要將資料從本機 Plastic SCM 伺服器 (或團隊內部部署伺服器) 推送至 Plastic Cloud 即可。

您推送至雲端的方法，與推送至一般遠端 Plastic SCM 伺服器的方法一樣。

您可以設定同步檢視，以透過批次方式推送/提取分支。請記住，遠端儲存庫將參照為 reponame@organization@cloud。範例：tetris@arcadegarage@cloud。@cloud 部分只會告訴 Plastic SCM 連線至雲端伺服器，而不會指定完整 IP 或網域名稱。

我可以使用 Plastic Cloud extension 簽入與合併嗎？

可以。自 5.4.16.792 (2016 年 11 月 14 日) 起即可直接簽入與合併。我們之前不建議開發者直接執行簽入與合併，因為我們認為這樣做比較慢，而且他們可以從其本機儲存庫推送/提取來獲得更好的服務，但我們收到許多客戶的要求，他們比較喜歡這種較為簡單的處理方式。

我們認為遊戲開發領域的創作者、文件作者、專案經理和其他不使用程式碼但需要處理其他資源的團隊成員，會從 Plastic Gluon + Plastic Cloud 中大幅獲益。他們將能執行直接簽入，並且只下載他們需要的資源或內容檔案。另外還可設定獨佔簽出，確保只有一名人員可以在指定的時間修改各個檔案。

我們認為，程式碼開發者可以將分散式工作流程與 Plastic SCM 搭配使用，讓體驗更加完善。這表示，他們或許可以將其分支推送/提取至 Cloud 以獲得更完善的服務，但也可以視需要採用集中式工作模式。他們也可以使用 Cloud 伺服器進行合併。

適用於開發者的一些備註：

• 相較於在本機執行簽入或在 LAN 上簽入至伺服器，在 Cloud 簽入會比較緩慢，因為資料必須穿過網際網路 (因此需要經由較高延遲的網路)。這對處理文件的創作者和團隊成員來說沒什麼差別，但對期待超快速簽入的開發者來說，他們會覺得速度太慢。簡言之，讓開發者直接簽入至 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 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 美元/月起算，最高可享有 15 GB 的儲存空間。此等級適合處理小型 (或至少是 Plastic SCM 視為小型的規模 :P) 儲存庫的團隊使用。
• 下一個等級是每個團隊 $19.95 美元/月，最高可享有 100 GB 的儲存空間，這是專為遊戲開發團隊、3D 設計團隊，或需要處理大型二進位檔的團隊所設計的等級。
• 在第一個 100 GB 之後，您的訂閱將依 50 GB 的貯體增加，每個貯體每個團隊額外加收 $7.45 美元/月的費用。

Plastic Cloud 會自動將您的訂閱升級為下一個大小層級，服務完全不中斷。您將收到一封具有在下次收費七天前事先付款之詳細資料的電子郵件。

我是 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 日