使用案例：如何在 Linux 環境中使用 API 部署部屬節點

此使用案例的目標是透過將 Linux 虛擬機器連線到 SaltStack Config 環境，以程式設計方式在部屬節點上安裝 Salt 部屬節點服務。

必要條件

在 Linux 環境中使用 API 部署部屬節點之前，您必須：

• 具有已部署 RaaS 的 SaltStack Config 環境。
• 已安裝 Salt 主節點和 Salt 部屬節點。
• 已部署 Linux 虛擬機器。

程序

1. 確認 Salt 主節點上的資料夾 etc/salt/cloud.deploy.d 包含以下檔案。
   

   如果看不到這些檔案，請連絡支援。

   備註： 檔案名稱中的 xxxx (例如 salt-xxxx-redhat-8-x86_64-amd64.tar.gz) 應與 Salt 主節點的版本相符。若要驗證 Salt 主節點的版本，請在 Salt 主節點上執行 salt-master -V 命令。
2. 如果您的環境是氣隙環境，請完成以下步驟：
   1. 開啟 /etc/raas/raas 下的 RaaS 組態檔。
   2. 將以下行新增到該組態檔：

      minion_deployment:
        airgap_install: true

   3. 使用 service raas restart 命令重新啟動 RaaS 服務。
3. 若要確定 Salt 主節點的 FQDN，請在 Salt 主節點的終端機中執行 salt saltmaster grains.get fqdn 命令。
4. 執行 ping [FQDN] 命令，確保為 Salt 主節點設定該 FQDN。
   
5. 若要開啟 Python，請執行 python3。
6. 使用 SSEAPI 用戶端執行以下 API 呼叫並使用適用於您環境的正確認證：

   from sseapiclient import APIClient
   
   client = APIClient('https://<master-ip>', '<ssc-username>', '<sscpassword>', ssl_validate_cert=False)
   
   
   client.api.minions.deploy_minion(
   
    master_id = '<master-id>',
   
    host_name_ip = '<prospective minion’s ip>',
   
    os = ‘<prospective minion’s os>’,
   
    minion_id = '<desired-minion-name-for-prospective-minion>',
   
    username = '<ssh-username-for-prospective-minion>', 
   
    password = '<ssh-password-for-prospective-minion>',
   
   )

   deploy.minion 函數開始在 SaltStack Config 環境中執行。您可以在 SaltStack Config 使用者介面的活動索引標籤中驗證工作是否正在執行。

結果

部屬節點已在 Linux 環境中透過 API 呼叫成功部署並設定。

下一步

透過以下兩種方式驗證是否已成功部署部屬節點：使用 執行命令視窗對部屬節點執行 test.ping 命令；或在 Salt 主節點命令視窗中執行 \* test.ping 和 \* test.versions 命令。