透過主節點外掛程式工作區,可以更新 Salt 主節點上的主節點外掛程式版本,以與 Automation Config 的版本相符。雲端部署和內部部署都支援此功能。您還可以下載最新版本的主節點外掛程式。
主節點外掛程式工作區提供有關外掛程式狀態、外掛程式版本、Salt 版本、上次更新 JID 等的資訊。此外,還可以透過主節點外掛程式工作區取得最新版本的 sseapiclient
。如需詳細資訊,請參閱使用 API。
透過主節點外掛程式,Salt 主節點能夠與 Automation Config 進行通訊。該外掛程式還包括各種設定,可以進行調整以提高效能。如需詳細資訊,請參閱主節點外掛程式組態設定參考。
RaaS 保存目前和以前版本的主節點外掛程式。當 Salt 主節點連線到 RaaS 時,Salt 主節點會檢查 RaaS 是否有它沒有的外掛程式版本。如果 Salt 主節點沒有這些外掛程式版本,則 Salt 主節點會從 RaaS 擷取外掛程式,並在 /var/cache/salt/master/plugin_cache/
中本機快取這些外掛程式。
有可用的 Automation Config 新版本時,外掛程式不會自動更新。您必須自行起始更新程序。最佳做法是,您應在外掛程式有可用的最新版本時將其更新到最新版本。
主節點外掛程式更新程序仰賴於 Salt 的 service
模組和 service.running
狀態在外掛程式更新後重新啟動 Salt 主節點。service
模組仰賴於發行版的初始化管理程式,例如 systemd
。
如果在容器中或不使用初始化管理程式的發行版上執行 Salt 主節點,則必須在更新後手動重新啟動 Salt 主節點。如果不重新啟動 Salt 主節點,主節點外掛程式工作區將報告 Salt 主節點執行的外掛程式版本已過時。
開始之前
在使用主節點外掛程式工作區之前,必須完成以下必要條件:
- 在 Salt 主節點上安裝主節點外掛程式。如需詳細資訊,請參閱〈安裝和設定主節點外掛程式〉。
- 確認已在 Automation 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 主節點才能解決此問題。如需詳細資訊,請參閱對外掛程式更新進行疑難排解。
更新主節點外掛程式:
- 在 Automation Config 中,選取 。
- 選取具有需要更新外掛程式狀態的 Salt 主節點。
- 按一下更新。
- 檢閱對話方塊中的資訊,以確保選取了正確的 Salt 主節點。
- 按一下更新。
- 若要監控更新進度,請按一下上次更新 JID。
- 在主節點外掛程式工作區中,確認外掛程式狀態已變更為最新。
如果更新失敗,請參閱對外掛程式更新進行疑難排解。
對外掛程式更新進行疑難排解
如果外掛程式更新失敗,則必須登入 Salt 主節點,手動解決此問題。對於失敗的外掛程式更新,不會自動還原。
- 基礎結構問題
- 虛擬機器的組態問題
- Salt 主節點的連線問題
嘗試執行以下步驟以確定更新失敗的原因:
- 檢查上次更新 JID 並查看原始資料是否有錯誤。
- 執行
systemctl status salt-master
以檢查salt-master
服務的狀態。 - 執行
salt-master -l debug
,在偵錯模式下啟動 Salt 主節點。 - 從主節點外掛程式工作區下載主節點外掛程式,然後手動安裝該外掛程式。