使用控制台建立堆疊定義

在專案中，當您將可部署的架構堆疊在一起並定義變數時，就會自動建立堆疊定義。 使用主控台來堆疊可部署架構及定義堆疊變數的好處如下:

• 您可以使用主控台中的引用拾取器在堆疊的可部署架構之間建立引用，而不是從頭開始寫引用。
• 從專案中部署堆疊架構有助於在其他人配置和部署之前，驗證整體解決方案是否按照設計運作。
• 由於堆疊定義是根據主控台中的選項來自動建立，因此成員可部署架構的版本定位器 ID 之類的資訊是精確的，且會自動更新。

在專案中，您可以選取要在堆疊層次包含哪些輸入。 這些輸入包含在堆疊定義的 inputs 區段中，並配置成專案中成員可部署架構的參照。 在下列影像中，prefix 輸入在 Custom Apache 成員可部署架構內強調顯示。 如果選取此輸入，Default value 會變更為堆疊層次輸入的參照。 當使用者從目錄新增您的解決方案到專案時，他們可以設定 prefix 輸入，而 Custom Apache 成員架構將參考該值。 fp_vsi_floating_ip_address 輸入會參照另一個成員可部署架構的輸出。 不應該選擇該輸入，因為該參考將成員架構連結在一起。 來自成員架構的這類輸入包含在堆疊定義檔的 members 區段中。

編輯堆疊定義

若要在本端編輯堆疊定義，請完成下列步驟:

1. 完成 堆疊可部署架構、定義堆疊變數 和 將堆疊架構載入私有目錄的 步驟。

   配置和部署堆疊在一起的架構，以驗證解決方案是否按照設計運作，然後再將它新增到私有目錄。

2. 將可部署架構新增至私有目錄後，您會被帶到目錄中的 配置版本 頁面。 從那裡，按一下「行動」功能表 >「產生艙單」。

   您也可以使用專案 API 取得堆疊定義 方法或專案 CLI ibmcloud project stack-definition 指令來匯出堆疊定義。

3. 開啟 stack_definition.json 檔案。

4. 使用範例定義作為指引，編輯輸入及輸出變數。

5. 將檔案新增至原始碼儲存庫的根資料夾。

下次將解決方案的新版本新增到目錄時，您的更新也會包含在內。

範例定義檔

建議使用專案來建立堆疊定義，以協助確保準確性。 不過，以下的程式碼片段可以作為範本，從頭開始建立堆疊定義：

{
   "inputs": [
      {
         "name": "Stack input 1",
         "type": "string",
         "hidden": false,
         "required": true,
         "default" : "Default value"
      },
      {
         "name": "Stack input 2",
         "type": "string",
         "hidden": false,
         "required": true
      }
   ],
   "outputs": [
      {
         "name": "Output 1 name",
         "value": "The reference to this output value"
      },
      {
         "name": "Output 2 name",
         "value": "The reference to this output value"
      }
   ],
   "members": [
      {
         "Name": "Deployable architecture 1 name",
         "Version_locator": "",
         "inputs": [
            {
               "name": "Input 1 name",
               "value": "reference"
            },
            {
               "name": "Input 2 name",
               "value": "reference"
            }
         ]
      },
      {
         "Name": "Deployable architecture 2 name",
         "Version_locator": "",
         "inputs": [
            {
               "name": "Input 1 name",
               "value": "reference"
            },
            {
               "name": "Input 2 name",
               "value": "reference"
            }
         ]
      }
   ]
}

"inputs": [
   {
      "name": "Stack input 1",
      "type": "string",
      "hidden": false,
      "required": true,
      "default" : "Default value"
   },
   {
      "name": "Stack input 2",
      "type": "string",
      "hidden": false,
      "required": true
   }
]

"outputs": [
   {
      "name": "Output 1 name",
      "value": "The reference to this output value"
   },
   {
      "name": "Output 2 name",
      "value": "The reference to this output value"
   }
]

"members": [
   {
      "Name": "Deployable architecture 1 name",
      "Version_locator": "",
      "inputs": [
         {
            "name": "Input 1 name",
            "value": "reference"
         },
         {
            "name": "Input 2 name",
            "value": "reference"
         }
      ]
   }
]