透過主節點外掛程式工作區,可以更新 Salt 主節點上的主節點外掛程式版本,以與 SaltStack Config 的版本相符。雲端部署和內部部署都支援此功能。您還可以下載最新版本的主節點外掛程式。

主節點外掛程式工作區提供有關外掛程式狀態、外掛程式版本、Salt 版本、上次更新 JID 等的資訊。此外,還可以透過主節點外掛程式工作區取得最新版本的 sseapiclient。如需詳細資訊,請參閱使用 API

透過主節點外掛程式,Salt 主節點能夠與 SaltStack Config 進行通訊。該外掛程式還包括各種設定,可以進行調整以提高效能。如需詳細資訊,請參閱主節點外掛程式組態設定參考

RaaS 保存目前和以前版本的主節點外掛程式。當 Salt 主節點連線到 RaaS 時,Salt 主節點會檢查 RaaS 是否有它沒有的外掛程式版本。如果 Salt 主節點沒有這些外掛程式版本,則 Salt 主節點會從 RaaS 擷取外掛程式,並在 /var/cache/salt/master/plugin_cache/ 中本機快取這些外掛程式。

有可用的 SaltStack Config 新版本時,外掛程式不會自動更新。您必須自行起始更新程序。最佳做法是,您應在外掛程式有可用的最新版本時將其更新到最新版本。

主節點外掛程式更新程序仰賴於 Salt 的 service 模組和 service.running 狀態在外掛程式更新後重新啟動 Salt 主節點。service 模組仰賴於發行版的初始化管理程式,例如 systemd

備註:

如果在容器中或不使用初始化管理程式的發行版上執行 Salt 主節點,則必須在更新後手動重新啟動 Salt 主節點。如果不重新啟動 Salt 主節點,主節點外掛程式工作區將報告 Salt 主節點執行的外掛程式版本已過時。

開始之前

在使用主節點外掛程式工作區之前,必須完成以下必要條件:

  • 在 Salt 主節點上安裝主節點外掛程式。如需詳細資訊,請參閱〈安裝和設定主節點外掛程式〉
  • 確認已在 SaltStack Config 使用者介面中接受 Salt 主節點的金鑰。
  • 確認以 root 使用者身分執行 Salt 主節點。如果 Salt 主節點以非 root 使用者身分執行,更新將失敗。
  • 確保 Salt 主節點執行的是 Salt 版本 3002.1 或更新版本。如果 Salt 主節點執行的是版本 3002 或更早版本,則必須先更新 Salt 版本,然後才能使用主節點外掛程式工作區。如需詳細資訊,請參閱升級 Salt
  • 確保 Salt 主節點執行的是版本 8.11.2 或更新版本的主節點外掛程式。如果 Salt 主節點執行的是 8.11.1 或更早版本,則必須先手動升級外掛程式,然後才能使用主節點外掛程式工作區。如需詳細資訊,請參閱使用 CLI 升級主節點外掛程式

更新主節點外掛程式

可以更新一或多個 Salt 主節點上的主節點外掛程式版本。

備註:

如果外掛程式狀態為需要更新,則只能透過主節點外掛程式工作區更新主節點外掛程式版本。如果外掛程式狀態指示 Salt 主節點需要手動介入,則必須登入 Salt 主節點才能解決此問題。如需詳細資訊,請參閱對外掛程式更新進行疑難排解

更新主節點外掛程式:

  1. SaltStack Config 中,選取管理 > 主節點外掛程式
  2. 選取具有需要更新外掛程式狀態的 Salt 主節點。
  3. 按一下更新
  4. 檢閱對話方塊中的資訊,以確保選取了正確的 Salt 主節點。
  5. 按一下更新
  6. 若要監控更新進度,請按一下上次更新 JID
  7. 主節點外掛程式工作區中,確認外掛程式狀態已變更為最新

    如果更新失敗,請參閱對外掛程式更新進行疑難排解

對外掛程式更新進行疑難排解

如果外掛程式更新失敗,則必須登入 Salt 主節點,手動解決此問題。對於失敗的外掛程式更新,不會自動還原。

外掛程式更新可能會失敗,原因如下:
  • 基礎結構問題
  • 虛擬機器的組態問題
  • Salt 主節點的連線問題

嘗試執行以下步驟以確定更新失敗的原因:

  1. 檢查上次更新 JID 並查看原始資料是否有錯誤。
  2. 執行 systemctl status salt-master 以檢查 salt-master 服務的狀態。
  3. 執行 salt-master -l debug,在偵錯模式下啟動 Salt 主節點。
  4. 主節點外掛程式工作區下載主節點外掛程式,然後手動安裝該外掛程式。