管理 OpenShift 虛擬化附加元件
虛擬私有雲 4.21 後來 僅限裸機工作節點 僅限 RHCOS
openshift-virtualization 附加元件提供一鍵式操作體驗，可於 OpenShift 虛擬化服務叢集上設定虛擬化平台。 此附加元件預設會在所有虛擬化服務叢集中自動啟用。
了解 OpenShift 虛擬化附加元件
OpenShift 虛擬化附加元件負責協調以下運算子的部署與管理，以在您的 Virtualization Service 叢集中啟用虛擬機器功能：
- OpenShift 虛擬化操作員（超融合）
- 提供用於執行和管理虛擬機的核心虛擬化功能。 如需更多資訊，請參閱《 安裝 OpenShift 虛擬化》。
- 新墨西哥州立大學接線員
- 管理虛擬機器和節點的網路設定。 如需更多資訊，請參閱 《關於 Kubernetes NMState 操作員》。
- Node 維護操作員
- 負責處理虛擬機器工作負載的節點維護作業。 如需更多資訊，請參閱 Node 維護操作員。
來自 Red Hat OperatorHub 的這些操作員，在 Virtualization Service 叢集上無法安裝。 此附加元件負責管理所有操作員的安裝與更新。
附加功能
OpenShift 虛擬化附加元件具有以下特點：
- 自動啟用
- 當您建立虛擬化服務叢集時，此附加元件會自動啟用。 您無法透過 CLI 或控制台手動啟用此附加元件。
- 無法停用
- 不支援停用此附加元件。 控制台中沒有此選項，且若嘗試透過 CLI 停用它，將會導致錯誤。
- 沒有任何設定選項
- 此附加元件沒有可供使用者設定的參數。
- 版本綁定
- 此附加元件版本與虛擬化服務叢集版本綁定（例如：4.21 ）。 此擴充功能支援當前次要版本以及下一個次要版本（ n+1 ）。 例如，附加元件版本 4.21 可與虛擬化服務版本 4.21 及 4.22 搭配使用。
- 自動更新修補程式
- 系統會透過「自動核准」策略，自動將修補程式更新套用至您的叢集。 IBM 將於正式上線前至少一週通知您相關變更細節。 如果鏡像運算子目錄中存在新版本，所有依賴的運算子都會自動更新。 此附加元件使用
stable頻道來發佈所有操作員更新。 - 手動版本升級
- 若要將附加元件升級至較新版本（例如，從 4.20 升級至 4.21 ），您必須先將 Virtualization Service 叢集升級至目標版本，然後使用 CLI 指令
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION手動更新附加元件的版本。 - 更新通道
- 此擴充套件使用「
stable」更新通道，該通道提供用於修復錯誤及解決安全問題的 Z-stream 更新。 - 版本相容性
- 每個附加元件版本皆支援當前的虛擬化服務版本 (n) 以及下一個次要版本 ( n+1 )。 例如，附加元件版本 4.20 支援 Virtualization Service 版本 4.20 及 4.21。
- 自訂型錄
- 在啟用附加元件的過程中，系統會自動建立一個包含鏡像依賴運算子的自訂目錄，並將其放置於
openshift-marketplace命名空間中。
已安裝的資源
啟用此附加元件時，將建立以下資源：
- 父級運算子命名空間
ibm-openshift-virt-operator命名空間包含所有與父級運算子相關的資源，其中包括一個類型為ibmopenshiftvirtualizations.openshiftvirt.ibm.io的自訂資源。- 自訂型錄
- 自訂目錄位於
openshift-marketplace命名空間中。 - 依賴運算子
- 父運算子作為元運算子，並在調和過程中安裝以下依賴運算子：
- OpenShift 虛擬化（位於
openshift-cnv命名空間中） - NMState（位於
openshift-nmstate命名空間中） - Node 維護操作員（位於
openshift-operators命名空間中）
- OpenShift 虛擬化（位於
檢視附加元件資訊
若您的帳戶已啟用此功能標誌，即可透過 CLI 檢視有關「OpenShift 虛擬化」附加元件的資訊。 如果功能標誌未啟用，請改為透過主控台和叢集詳細資訊來查看附加元件的狀態。
列出已安裝的外掛程式
列出您虛擬化服務叢集中已安裝的所有附加元件。
ibmcloud ks cluster addon ls --cluster CLUSTER_NAME_OR_ID
輸出範例：
Name Version Health State Health Status
ibm-storage-operator 1.0 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
openshift-virtualization 4.21 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
查看附加元件的詳細資訊
若您的帳戶已啟用此功能標誌，請查看有關「OpenShift 虛擬化」附加元件的詳細資訊。
ibmcloud ks cluster addon get --addon openshift-virtualization --cluster CLUSTER_NAME_OR_ID
輸出範例：
name: openshift-virtualization
Version: 4.21
Health State: normal
Health Status: Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
列出可用的附加元件版本
若您的帳戶已啟用此功能標誌，請列出「OpenShift」虛擬化附加元件的可用版本。
ibmcloud ks cluster addon versions --addon openshift-virtualization
輸出範例：
Name Version Supported Kubernetes Range Supported OpenShift Range Kubernetes Default OpenShift Default
openshift-virtualization 4.19 unsupported >=4.19.0 <4.21.0 - >=4.19.0 <4.21.0
openshift-virtualization 4.21 unsupported >=4.21.0 <4.23.0 - >=4.21.0 <4.23.0
此輸出內容顯示各附加元件版本所支援的 Virtualization Service 版本。
檢查設定選項
若您的帳戶已啟用此功能標誌，您可以確認「OpenShift 虛擬化」附加元件不支援任何設定選項。
ibmcloud ks cluster addon options --addon openshift-virtualization
輸出範例：
FAILED
No addon installation options are available for openshift-virtualization.
更新擴充功能
OpenShift 虛擬化附加元件支援兩種更新類型：
自動更新修補程式
修補程式更新（例如從 4.21.1 更新至 4.21.2 ）會自動套用至所有叢集。 這些更新包含錯誤修正與安全性修補程式。 IBM 在將修補程式更新部署至生產環境前，會至少提前一週發出通知。
自動修補程式更新程序會執行以下操作：
- 重新啟動父運算子
- 對照目錄來源
- 根據
stable頻道訂閱狀況，更新所有子操作員
手動版本升級
若要將「OpenShift」虛擬化附加元件升級至較新的次要版本（例如從 4.20 升級至 4.21 ），您必須先將虛擬化服務叢集升級至目標版本。 若您的帳戶尚未啟用此功能標誌，請在嘗試透過 CLI 進行更新之前，先聯絡 IBM 技術支援。
-
將您的虛擬化服務叢集升級至目標版本。 如需更多資訊，請參閱「更新叢集」。
-
叢集升級完成後，請將附加元件更新至對應的版本。
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION例如，若要更新至版本 4.21:
ibmcloud ks cluster addon update openshift-virtualization --cluster my-rovs-cluster --version 4.21
為確保最佳的相容性與支援，強烈建議將外掛程式版本更新至與您的叢集版本相符。
停用此附加元件
在虛擬化服務叢集（第一階段）上，不支援停用「OpenShift」虛擬化附加元件。 此附加元件是虛擬化服務的核心組件，無法移除。 如果您的帳戶已啟用此功能標誌，且您嘗試執行該 CLI 指令，該指令將會產生錯誤。
ibmcloud ks cluster addon disable openshift-virtualization --cluster CLUSTER_NAME_OR_ID
第二階段計劃為標準 ROKS 叢集新增對外掛程式解除安裝的功能。
附加元件的疑難排解
若您在使用 OpenShift 虛擬化附加元件時遇到問題，請在提交支援案件前先蒐集以下資訊。
彙整附加模組資訊
執行以下指令，以收集有關「OpenShift」虛擬化附加元件及其相關操作員的詳細資訊。
-
取得 IBM 上的 OpenShift 虛擬化自訂資源。
oc get ibmopenshiftvirtualizations.openshiftvirt.ibm.io -n ibm-openshift-virt-operator -o yaml -
列出父運算子命名空間中的所有資源。
oc get all -n ibm-openshift-virt-operator -
檢查 OpenShift 虛擬化操作員的狀態。
oc get csv -n openshift-cnv -
查看「HyperConverged」的資源詳細資訊。
oc get hco -n openshift-cnv kubevirt-hyperconverged -o yaml -
列出「OpenShift」虛擬化命名空間中的所有資源。
oc get all -n openshift-cnv -
請查看 NMState 營運商的運作狀態。
oc get csv -n openshift-nmstate -
列出 NMState 命名空間中的所有資源。
oc get all -n openshift-nmstate -
查看 NMState 的資源詳情。
oc get nmstate nmstate -o yaml -
列出 NodeNetworkConfigurationPolicy 的資源。
oc get nncp -
請檢查「Node」的維護操作員狀態。
oc get csv -n openshift-operators -
列出 operators 命名空間中的所有資源。
oc get all -n openshift-operators -
請檢查自訂目錄來源。
oc get catalogsource custom-redhat-operators-openshiftvirt -n openshift-marketplace -
列出自訂目錄中的套件清單。
oc get packagemanifests -n openshift-marketplace | grep "Custom Redhat Operators for Openshift Virtualization"
提交支援案件
若您的問題仍未解決，請提交支援案件，並附上疑難排解指令的執行結果。 如需相關資訊，請參閱取得支援。