快速入門：使用小組自定義建立開發方塊

在本快速入門中，您會使用小組自定義來建立開發方塊。 Team Customizations 使用映像定義檔，讓您為開發小組建立一致的自定義開發方塊，為您的專案提供量身打造的環境。

重要

開發箱小組自定義目前處於預覽狀態。 如需預覽狀態的詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。 本文件定義適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的法律條款。

必要條件

若要完成本文中的步驟，您必須使用開發方塊專案設定開發人員中心。

設定自定義所需的許可權

若要執行建立自訂內容並套用至開發箱所需的動作，您需要特定權限。 下表描述設定自訂內容所需的動作以及權限或角色。

動作	權限/角色
啟用開發人員中心的專案層級目錄	在訂用帳戶上具有寫入許可權的平台工程師。
啟用項目的目錄同步設定	在訂用帳戶上具有寫入許可權的平台工程師。
將目錄附加至專案	專案上的專案管理員或參與者許可權。
建立自定義檔案	任何人都可以建立自定義檔案。
使用開發人員入口網站在開發方塊建立期間上傳並套用 YAML 檔案	開發箱使用者
將工作新增至目錄	新增至裝載目錄之存放庫的權限。

建立映像定義

1. 下載範例 YAML 自定義檔案。
2. 開啟檔案並檢查工作。
   請注意，映像定義檔會使用 name 字段來指定影像定義的名稱。 使用此名稱來識別開發方塊集區中的映像定義。

將目錄新增至您的開發人員中心

若要新增目錄，請完成下列工作：

1. 將範例目錄存放庫派生至您的 GitHub 組織。
2. 安裝及設定 Microsoft 開發人員中心應用程式
3. 在 GitHub 中為存放庫指派權限。
4. 將存放庫新增為目錄。

派生範例目錄存放庫

1. 開啟範例目錄存放 庫。
2. 選取 [分支 ]，將存放庫分支至您的 GitHub 組織。

安裝 Microsoft 開發人員中心應用程式

1. 登入 Azure 入口網站。

2. 瀏覽至您的開發人員中心或專案。

3. 在左側功能表的 [環境設定] 下，選取 [目錄]，然後選取 [新增]。

4. 在 [新增目錄] 窗格中，輸入或選取下列項目：

   欄位	值
   名稱	輸入目錄的名稱。
   目錄來源	選取 [GitHub]。
   驗證類型	選取 [GitHub 應用程式]。

5. 若要安裝 Microsoft 開發人員中心應用程式，請選取 [設定您的存放庫]。

   

6. 如果系統提示您向 GitHub 進行驗證，請進行驗證。

7. 在 [Microsoft DevCenter] 頁面上，選取 [設定]。

   

8. 選取包含您要新增為目錄之存放庫的 GitHub 組織。 您必須是組織的擁有者，才能安裝此應用程式。

   

9. 在 [安裝 Microsoft DevCenter] 頁面上，選取 [僅選取存放庫]，選取您要新增為目錄的存放庫，然後選取 [安裝]。

   

   您可以選取多個存放庫以新增為目錄。 您必須將每個存放庫新增為個別目錄，如將存放庫新增為目錄中所述。

10. 在 [Microsoft 的 Microsoft DevCenter 想要權限以：] 頁面上，檢閱所需的權限，然後選取 [授權 Microsoft 開發人員中心]。

    

將存放庫新增為目錄

1. 切換回到 Azure 入口網站。

2. 在 [新增目錄] 中，輸入下列資訊，然後選取 [新增]︰

   欄位	值
   存放庫	選取您要新增為目錄的存放庫。
   分支	選取分支。
   資料夾路徑	選取包含保存您環境定義之子資料夾的資料夾。

   

3. 在 [目錄] 中，確認您的目錄出現。 連線成功時，[狀態] 會讀取 [同步成功]。

   

建立映像定義的開發方塊集區

若要讓自定義檔案 imagedefintion.yaml 在建立開發方塊時存取，您可以將它指定為集區的定義。 當開發人員選取該集區以從中建立開發方塊時，會使用映像定義。

若要建立與專案相關聯的開發箱集區：

1. 登入 Azure 入口網站。

2. 在 [搜尋] 方塊中輸入「projects」。 在結果清單中，選取 [專案]。

3. 開啟您要建立開發箱集區的專案。

4. 選取 [開發箱集區]，然後選取 [建立]。

5. 在 [建立 Microsoft 開發箱集區] 窗格上，輸入下列值：

   設定	值
   名稱	輸入集區的名稱。 開發人員會在建立開發箱時看到並選取集區名稱。 此名稱必須是專案中的唯一名稱。
   [定義]	選取定義，如映像定義檔中的具名。
   網路連線	1.選取 [部署至 Microsoft 裝載的網路]。 2. 針對 Microsoft 開發箱選取您想要的部署區域。 選擇靠近您開發方塊用戶的區域，以獲得最佳用戶體驗。
   開發箱建立者權限	選取 [本機系統管理員] 或 [標準使用者]。
   啟用自動停止	預設值為 [是]。 選取 [否] 以停用自動停止排程。 您可以在建立集區之後設定自動停止排程。
   停止時間	選取集區中所有 Microsoft 開發箱的關閉時間。 此集區中的所有 Microsoft 開發箱每天此時都會關閉。
   時區	選取停止時間的時區。
   授權	選取此核取方塊，以確認組織具有您想要套用至此集區中 Microsoft 開發箱的 Azure Hybrid Benefit 授權。

   

6. 選取 建立。

7. 確認新的開發箱集區出現在清單中。 您可能需要重新整理畫面。

Azure 入口網站會部署開發箱集區並執行健康情況檢查，以確保映像和網路通過開發箱的驗證準則。

從開發方塊集區建立開發方塊

當您從開發方塊集區建立開發方塊時，映像定義會套用至開發方塊。 開發方塊是使用映像定義檔中指定的自定義專案所建立。

若要在 Microsoft 開發箱開發人員入口網站中建立開發箱：

1. 登入 Microsoft 開發箱開發人員入口網站。

2. 選取 [新增]>[新開發箱]。

3. 在 [新增開發箱] 中，輸入下列值：

   設定	值
   名稱	輸入開發箱的名稱。 開發箱名稱必須是專案內的唯一名稱。
   計畫	從下拉式清單中選取專案。
   開發箱集區	從下拉式清單中選取集區，其中包含該專案的所有開發箱集區。 選擇靠近您的開發箱集區，以最大限度降低延遲。

   在您做出選取之後，頁面會顯示下列資訊：

   • 您可以在選取的專案中建立多少個開發箱 (若專案設有限制)。
   • 是否支援「休眠」。
   • 是否啟用「自訂」。
   • 關機時間 (若您建立開發箱所在的集區有關機排程)。
   • 開發箱建立流程可能需要 25 分鐘或更長時間的通知。

4. 選取 [建立] 開始建立開發箱。

5. 若要追蹤建立進度，請使用開發人員入口網站中的開發人員方塊圖格。

確認已套用自定義

DevBox 會將自定義專案套用為建立程式的最後階段。 開發人員方塊會傳送電子郵件，讓您知道開發方塊已就緒。 然後，您可以檢查是否已套用自定義專案。

1. 等候電子郵件確認開發方塊已建立。

2. 在開發人員入口網站中，檢查是否已套用自定義專案。 在 [開發] 方塊圖格上，選取 [動作>自定義]。

   

3. 在 [ 自定義詳細數據 ] 窗格中，您可以看到已套用至開發方塊的自定義。

   

清除資源

1. 登入開發人員入口網站。

2. 針對您要刪除的開發箱，從 [動作] 功能表選取 [刪除]。

   

3. 若要確認刪除，請選取 [刪除]。

   

相關內容

• Microsoft開發箱小組自定義
• 撰寫自定義檔案