身為雲端範本開發人員,您可以將內容新增到 YAML,以便在部署範本時安裝 SaltStack Config 部屬節點。

新增到範本的核心內容包括要部署的機器的遠端存取內容以及 SaltStack Config 資源的組態內容。該程序僅包括選取的內容。YAML 包括此範例中未使用的其他 SaltStack Config 資源內容。如需詳細資訊,請檢閱架構。

儘管此範例顯示了如何為遠端存取內容新增使用者名稱和密碼,但您可以設定密碼內容並將其新增到範本。如需範例,請參閱密碼 Cloud Assembly 內容

程序

  1. Cloud Assembly 中,選取設計 > 雲端範本
  2. 開啟現有範本。
  3. 找到 SaltStack Config 資源並將其拖曳至畫布。
  4. SaltStack Config 資源連結到將安裝部屬節點的機器。
  5. 在代碼窗格中,將內容新增到 SaltStack Config 資源。

    您無需包括所有可能的內容。此範例中使用的值在資料表中進行了說明。

    Cloud_SaltStack_1:
        type: Cloud.SaltStack
        properties:
          masterId: saltstack_enterprise_installer
          hosts:
            - ${resource["Cloud-VM-1".id}
          saltEnvironment: sse
          stateFiles:
            - /doe.sls
          variables: 
            user: joe
          additionalMinionParams:
            grains:
              roles:
                - webserver
                - database

    下面提供了此範例中所用 Cloud_SaltStack_1 內容的說明。

    內容 說明
    masterId 在範例架構中,masterId 值為 saltstack_enterprise_installer。您可以在 SaltStack Config管理 > 主節點金鑰中定義主節點識別碼。
    hosts hosts 值是要安裝部屬節點之機器或機器叢集的識別碼。依預設,機器的名稱作為 SaltStack Config 中的部屬節點識別碼傳入。

    建議選擇不超過 15 個字元的機器名稱,尤其是在 Windows 上部署部屬節點時。Windows 不允許主機名稱超過 15 個字元。

    如果希望為要部署的機器定義自訂命名慣例,請參閱Cloud Assembly 中已部署資源的自訂命名〉

    saltEnvironment 在此範例中,sse 是狀態檔案的檔案位置。您可以在 SaltStack Config組態 > 檔案伺服器中將狀態檔案放置在其他檔案伺服器位置。

    僅支援以本機檔案伺服器為基礎的環境。

    stateFiles 在此範例中,doe.sls 是在指定為 saltEnvironment 的檔案伺服器目錄中提供的狀態檔案。
    variables 變數是狀態檔案使用的值。在此範例中,doe.sls 接受 user 值。

    目前不支援複雜的巢狀變數。例如,對變數值使用陣列時,不能在陣列元素內包含巢狀值,如另一個陣列或對應。

    additionalMinionParams 使用此內容可傳遞部屬節點的其他組態參數。必須以字典的形式傳遞這些參數:

    • grains:使用此內容可將自訂 Salt Grain 指派給部屬節點。接受一或多個 key:value 配對。這些值可以是字串、陣列或對應。

      只能在佈建新機器時指派自訂 Grain 資料。執行連結 SaltStack 資源更新 Salt 組態第 2 天動作時,無法指派自訂 Grain 資料。

  6. remoteAccess 內容新增到託管 Salt 部屬節點的機器。

    authentication 金鑰的值必須為 usernamePasswordgeneratedPublicPrivateKey。不支援 publicPrivateKey

     remoteAccess:
            authentication: usernamePassword
            username: adminUser
            password: adminPassword
  7. 確認 YAML 包含與以下範例類似的內容。
    resources:
      Cloud-Network:
        type: Cloud.Network
        properties:
          networkType: existing 
      Cloud_VM_1:
        type: Cloud.vSphere.Machine
        properties:
          image: ubuntu
          flavor: small
          remoteAccess:
            authentication: usernamePassword
            username: adminUser
            password: adminPassword
          networks:
            - network: ${resource["Cloud-Network"].id}
      Cloud_SaltStack_1:
        type: Cloud.SaltStack
        properties:
          masterId: saltstack_enterprise_installer
          hosts:
            - ${resource["Cloud-VM-1"].id}
          saltEnvironment: sse
          stateFiles:
            - /doe.sls
          variables: 
            user: joe
          additionalMinionParams:
            grains:
              roles:
                - webserver
                - database
  8. 測試並部署雲端範本。
    如果部屬節點部署失敗,請參閱 對部屬節點部署進行疑難排解
  9. 確認已部署機器的 Salt 組態內容。
    1. 選取部署 > 部署,然後開啟部署詳細資料。
    2. 拓撲索引標籤上,按一下機器,然後在右窗格中展開 Salt 組態內容。

      [拓撲] 索引標籤螢幕擷取畫面,在右窗格中展開了 [Salt 組態] 內容。內容包括主節點識別碼、Salt 環境和狀態檔案。

SaltStack Config 中驗證部屬節點

在虛擬機器上安裝部屬節點後,找到部屬節點並在資源上執行任何工作或命令。

程序

  1. 若要開啟 SaltStack Config,請按一下右上角的應用程式功能表,然後按一下 Cloud Services 主控台
  2. 按一下 SaltStack Config 服務動態磚。
  3. SaltStack Config 中,展開部屬節點金鑰,然後按一下已接受
  4. 部屬節點識別碼資料行中,按一下篩選器圖示,然後輸入部屬節點的名稱。
    部屬節點的名稱預設為虛擬機器的主機名稱。在此範例中,部屬節點識別碼為 salt-vm-010。
    SaltStack Config 中已接受部屬節點金鑰的螢幕擷取畫面。
  5. 若要檢視詳細資料,請按一下部屬節點的名稱。
    您可以在部屬節點上執行工作或命令。例如,範例磁碟使用量。此工作傳回部屬節點的磁碟使用量統計資料。
    範例部屬節點識別碼的詳細資料頁面的螢幕擷取畫面

檢視 Salt Grain 資料

在虛擬機器上完成 Salt 部屬節點部署後,可以在 Cloud Assembly 中檢視部屬節點的 Grain。

系統會針對部屬節點的作業系統、網域名稱、IP 位址、核心、作業系統類型、記憶體和許多其他系統內容收集 Salt Grain。如果您無權存取 SaltStack Config,或者希望在不離開 Cloud Assembly 使用者介面的情況下快速檢視 Grain 資料,則可以使用拓撲索引標籤檢視 Grain 資料。若要瞭解有關 Grain 資料的詳細資訊,請參閱 Salt Grain

檢視部屬節點的 Grain:

  1. Cloud Assembly 中,選取資源 > 部署,然後找到您的部署。
  2. 拓撲索引標籤上,選取連結到 SaltStack Config 資源的虛擬機器。
  3. 在右窗格中找到 Salt 組態區段,然後向下捲動以檢視 Grain 資料清單。Cloud Assembly 中的 Grain 資料螢幕擷取畫面

部署部屬節點後,將擷取該部屬節點的 Grain 資料。若要查看上次更新 Grain 資料的時間,可以捲動到 Salt 組態區段的底部。

Cloud Assembly 中的上次更新 Grain 資料螢幕擷取畫面
備註: 僅當對 SaltStack Config 資源執行 更新 Salt 組態第 2 天動作時,Grain 資料才會更新。如果在 Cloud Assembly 之外進行任何變更,則不會進行更新。