開始之前

在加入可部署架構之前，請確保滿足以下先決條件。

• 下載Visual Studio Code
• 驗證您使用的是即用即付帳戶還是訂閱帳戶。 有關更多詳細信息，請參閱 查看您的帳戶類型。
• 驗證您是否具有使用私有目錄和可部署架構所需的存取權限。
  • IBM Cloud Schematics服務的管理員角色
  • 目錄管理服務的編輯者角色
  • 您帳戶中所有資源群組的查看者角色
  • 如果您打算將安全值儲存在Secrets Manager的實例中Secrets Manager服務上的SecretsReader角色
  • 服務 Workload Protection 中的讀者角色
  • 自訂可部署架構中的特定資源所需的其他角色。
• 確保您將可部署架構的原始碼儲存在GitHub中。 有關將原始程式碼放入儲存庫的協助，請參閱 設定原始碼儲存庫。
• 公用或私有GitHub儲存庫中的 Terraform 模組，已複製到本機資料夾。 為了進行實驗，您可以建立此 範例 Terraform 模組 的分支。 如果您的儲存庫是私有的，您需要具有 repo 和 read:user 權限的個人存取權杖。

取得 VS Code 擴展

若要取得擴展，請開啟 VS Code，前往 Extensions，搜尋並選擇 IBM Cloud Deployable Architecture Builder 進行下載。 下載後，您可以按照演練開始或使用以下步驟。 如果演練未自動打開，您可以使用命令選項板。 轉到 “視圖”>“命令面板”。 搜尋 Walkthrough，按一下歡迎：開啟演練...，然後選擇開始使用IBM Cloud Deployable Architecture Builder。

加入您的可部署架構

第一次驗證可部署架構時，您需要完成將其加入IBM Cloud的步驟。 使用以下步驟來加入您的可部署架構：

1. 登入您的 IBM Cloud 帳戶。
   1. 若要登入您的帳戶，請按一下「檢視」 並選擇 「命令面板」。
   2. 在搜尋字段中，搜尋 IBM Cloud - Log in。
   3. 選擇 IBM Cloud- 登入並使用 API 金鑰、聯合 ID 或使用者名稱和密碼登入。
   4. （可選）您可以變更登入環境。 按一下查看，選擇命令面板，搜尋 IBM Cloud - Log in，然後選擇 IBM Cloud- 登入 > 變更登入環境。 從選單中選擇 「製作」 或 「登台」。
2. 確保您已從 VS Code 登入GitHub。
   1. 選擇>登入同步設定。
   2. 選擇您的帳戶。
   3. 按一下授權 Visual-Studio-Code。
3. 克隆您的儲存庫並將其新增至 VS Code 工作區。
   1. 從GitHub複製您的可部署架構儲存庫。
   2. 若要將其新增至 VS Code 中的工作區，請按一下「檔案」>「將資料夾新增至工作區...」， 然後從檔案中選取儲存庫。
4. 將目錄清單檔案新增至 Terraform 模組。
   1. 若要新增目錄清單，請以滑鼠右鍵按一下工作區中的模組資料夾。
   2. 選擇 IBM Cloud > 新增可部署架構清單檔案。
5. 加入並驗證您的可部署架構。
   1. 右鍵點選 ibm_catalog.json 文件，然後選擇 IBM Cloud > 驗證IBM Cloud上的可部署架構。
   2. 選擇儲存庫分支。 或者您可以點擊 + 並輸入將建立的新名稱。
   3. 選擇現有的私人目錄。 或者您可以點擊 + 並輸入將建立的新名稱。
   4. 輸入產品版本。
   5. 選擇一個現有項目。 或者您可以點擊 + 並輸入將為您建立的新名稱。
   6. 輸入將部署資源的帳戶的IBM Cloud API 金鑰。
   7. 輸入架構圖的相對路徑。 如果您沒有圖表，我們會提供一個佔位符。
   8. （可選）如果GitHub儲存庫是私有的或位於GitHub Enterprise中，請輸入您的個人存取權杖。
   9. YAML 輸入檔已開啟。 編輯 inputs 屬性下的值並儲存檔案。
   10. 點擊繼續

驗證開始時，將開啟一個顯示驗證日誌的輸出通道。 如果沒有，請在輸出視圖中，從選單中選擇 DA Validation 通道。 驗證過程可能需要數分鐘才能完成。