透過主節點外掛程式工作區，可以更新 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. 從主節點外掛程式工作區下載主節點外掛程式，然後手動安裝該外掛程式。