安裝 OpenShift 虛擬化操作程式
虛擬私有雲 4.17 後來 僅限裸機工作節點 僅限 RHCOS
為群集設定儲存空間後,安裝 OpenShift Virtualization Operator 以啟用虛擬機器管理功能。
OpenShift 虛擬化服務 已預先安裝操作員,因此無需手動安裝。
OpenShift 虛擬化服務 叢集中已預先安裝「OpenShift Virtualization」、「NMState」及「Node Maintenance」這三個操作員,並由「openshift-virtualization」附加元件進行管理。 本頁面僅適用於採用手動安裝 OpenShift Virtualization
的標準 OpenShift 叢集。
開始之前
安裝 OpenShift Virtualization Operator 之前,請完成下列步驟:
-
建立 Red Hat OpenShift on IBM Cloud 叢集,要求如下:
- 裸金屬工作節點:虛擬化工作負載所需
- RHCOS 作業系統:需要 (非 RHEL)
- OVN- Kubernetes CNI:進階網路功能所需
- OpenShift 4.20 或更新版本:需要完整的虛擬化支援
- 出站流量保護:必須停用 (可在群集建立時設定,或在建立後停用)
您可以在 UI 或 CLI 中建立群集時停用出站流量保護,或在建立群集後使用步驟 3 中的指令停用。
-
設定 OpenShift 虛擬化的儲存空間。 您的群集必須有一個正確設定的儲存解決方案 (ODF 或 VPC File Storage )。
-
如果您在群集建立時沒有停用出站流量保護,請現在停用。
ibmcloud oc vpc outbound-traffic-protection disable -c CLUSTER_NAME只有在群集建立期間未停用出站流量保護時,才需要此步驟。
-
啟用預設目錄來源。
ibmcloud ks cluster config --admin -c CLUSTER_NAME oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]' -
驗證目錄來源是否可用。
oc get catalogsource -n openshift-marketplace -
確認 OpenShift 虛擬化套件可用。
oc get packagemanifests -n openshift-marketplace | grep kubevirt
從主控台安裝 OpenShift Virtualization Operator
-
登入 IBM Cloud 主控台並導航至您的群集。
-
按一下 OpenShift 網頁主控台,開啟 OpenShift 主控台。
-
在 OpenShift 主控台中,導覽至 Ecosystem > OperatorHub (或操作員 > OperatorHub 在早期版本中)。
-
搜尋 OpenShift 虛擬化。
-
按一下 OpenShift 虛擬化磁磚,然後按一下安裝。
-
在「安裝操作員」頁面上,請進行以下設定:
- 更新頻道:為您的 OpenShift 版本選擇適當的頻道
- 安裝模式:群集中的所有命名空間 (預設)
- 安裝的命名空間:openshift-cnv (預設)
- 更新核准:自動 (建議)
-
按一下安裝,以開始安裝。
-
請等待營運商完成安裝。 準備就緒時,狀態會變更為 Succeeded。
從 CLI 安裝 OpenShift Virtualization Operator
- 為 OpenShift 虛擬化操作員建立命名空間。
oc create namespace openshift-cnv - 建立 OperatorGroup。
cat <<EOF | oc apply -f - apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: kubevirt-hyperconverged-group namespace: openshift-cnv spec: targetNamespaces: - openshift-cnv EOF - 建立 Subscription 以安裝操作員。
cat <<EOF | oc apply -f - apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: hco-operatorhub namespace: openshift-cnv spec: source: redhat-operators sourceNamespace: openshift-marketplace name: kubevirt-hyperconverged startingCSV: kubevirt-hyperconverged-operator.v4.20.8 channel: "stable" EOF - 驗證操作器的安裝。
等到oc get csv -n openshift-cnvPHASE欄顯示Succeeded。
建立 HyperConverged 自訂資源
安裝操作員後,建立 HyperConverged 自訂資源,以部署 OpenShift 虛擬化元件。
瞭解節點位置
Red Hat OpenShift on IBM Cloud 群組中沒有標示為 master 的節點。 您必須設定節點放置政策,以指定虛擬化元件和 VM 工作負載的執行位置。
建議的配置
- 基礎結構元件:部署在 VSI 工作節點上以優化成本
- VM 工作負載:部署在裸金屬工作節點上以獲得最佳效能
從控制台建立 HyperConverged CR
-
在 OpenShift 主控台中,導覽至 Ecosystem > Installed Operators (或早期版本中的 Operators > Installed Operators )。
-
按一下 OpenShift 虛擬化。
-
點擊 HyperConverged 分頁標籤。
-
按一下建立 HyperConverged。
-
設定基礎結構元件的節點位置:
- 按一下 Infra 索引標籤
- 新增節點選擇器或容差到目標 VSI 節點
-
為 VM 工作負載配置節點位置:
- 按一下工作負載索引標籤
- 針對裸金屬節點新增節點選擇器或容限
-
按一下建立。
從 CLI 建立 HyperConverged CR
使用預設組態建立 HyperConverged 自訂資源。
cat <<EOF | oc apply -f -
apiVersion: hco.kubevirt.io/v1beta1
kind: HyperConverged
metadata:
name: kubevirt-hyperconverged
namespace: openshift-cnv
spec:
EOF
驗證安裝
-
檢查 HyperConverged 資源狀態。
oc get hyperconverged -n openshift-cnv等到
PHASE欄顯示Deployed。 -
驗證虛擬化 pod 是否正在執行。
oc get pods -n openshift-cnv -
檢查 OpenShift 主控台中的虛擬化功能表。
- 登入 OpenShift 控制台
- 在主導覽功能表中尋找虛擬化
-
驗證已建立儲存設定檔。
oc get storageprofile -
如果使用 VPC File Storage,請按照 為 OpenShift 虛擬化設定儲存設備 中的說明設定儲存設定檔。
疑難排解安裝問題
HyperConverged 資源部署失敗
如果 HyperConverged 資源因節點放置錯誤而無法部署:
- 檢查您的節點標籤。
oc get nodes --show-labels - 使用正確的節點選擇器更新 HyperConverged CR。
oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv - 檢視 HyperConverged 作業員記錄。
oc logs -n openshift-cnv -l name=hyperconverged-cluster-operator
操作員安裝失敗
如果操作器安裝失敗:
- 確認已啟用目錄來源。
oc get catalogsource -n openshift-marketplace - 檢查操作員訂閱狀態。
oc get subscription -n openshift-cnv - 檢視操作員日誌。
oc logs -n openshift-cnv -l app=kubevirt-hyperconverged-operator
下一步
安裝 OpenShift Virtualization 之後:
- 使用 VPC 建立虛擬機器 File Storage
- 設定虛擬網路介面 ( 4.20 及更新版本)
- 建立與管理虛擬機器
- 設定 VM 範本和影像
如需完整的安裝說明,請參閱 Red Hat 文件中的安裝 OpenShift Virtualization。