安裝 OpenShift 虛擬化操作程式

虛擬私有雲 4.17 後來 僅限裸機工作節點 僅限 RHCOS

為群集設定儲存空間後,安裝 OpenShift Virtualization Operator 以啟用虛擬機器管理功能。

OpenShift 虛擬化服務 已預先安裝操作員,因此無需手動安裝。 OpenShift 虛擬化服務 叢集中已預先安裝「OpenShift Virtualization」、「NMState」及「Node Maintenance」這三個操作員,並由「openshift-virtualization」附加元件進行管理。 本頁面僅適用於採用手動安裝 OpenShift Virtualization 的標準 OpenShift 叢集。

開始之前

安裝 OpenShift Virtualization Operator 之前,請完成下列步驟:

  1. 建立 Red Hat OpenShift on IBM Cloud 叢集,要求如下:

    • 裸金屬工作節點:虛擬化工作負載所需
    • RHCOS 作業系統:需要 (非 RHEL)
    • OVN- Kubernetes CNI:進階網路功能所需
    • OpenShift 4.20 或更新版本:需要完整的虛擬化支援
    • 出站流量保護:必須停用 (可在群集建立時設定,或在建立後停用)

    您可以在 UI 或 CLI 中建立群集時停用出站流量保護,或在建立群集後使用步驟 3 中的指令停用。

  2. 設定 OpenShift 虛擬化的儲存空間。 您的群集必須有一個正確設定的儲存解決方案 (ODF 或 VPC File Storage )。

  3. 如果您在群集建立時沒有停用出站流量保護,請現在停用。

    ibmcloud oc vpc outbound-traffic-protection disable -c CLUSTER_NAME
    

    只有在群集建立期間未停用出站流量保護時,才需要此步驟。

  4. 啟用預設目錄來源。

    ibmcloud ks cluster config --admin -c CLUSTER_NAME
    oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]'
    
  5. 驗證目錄來源是否可用。

    oc get catalogsource -n openshift-marketplace
    
  6. 確認 OpenShift 虛擬化套件可用。

    oc get packagemanifests -n openshift-marketplace | grep kubevirt
    

從主控台安裝 OpenShift Virtualization Operator

  1. 登入 IBM Cloud 主控台並導航至您的群集。

  2. 按一下 OpenShift 網頁主控台,開啟 OpenShift 主控台。

  3. 在 OpenShift 主控台中,導覽至 Ecosystem > OperatorHub (或操作員 > OperatorHub 在早期版本中)。

  4. 搜尋 OpenShift 虛擬化

  5. 按一下 OpenShift 虛擬化磁磚,然後按一下安裝

  6. 在「安裝操作員」頁面上,請進行以下設定:

    • 更新頻道:為您的 OpenShift 版本選擇適當的頻道
    • 安裝模式:群集中的所有命名空間 (預設)
    • 安裝的命名空間:openshift-cnv (預設)
    • 更新核准:自動 (建議)
  7. 按一下安裝,以開始安裝。

  8. 請等待營運商完成安裝。 準備就緒時,狀態會變更為 Succeeded

從 CLI 安裝 OpenShift Virtualization Operator

  1. 為 OpenShift 虛擬化操作員建立命名空間。
    oc create namespace openshift-cnv
    
  2. 建立 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
    
  3. 建立 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
    
  4. 驗證操作器的安裝。
    oc get csv -n openshift-cnv
    
    等到 PHASE 欄顯示 Succeeded

建立 HyperConverged 自訂資源

安裝操作員後,建立 HyperConverged 自訂資源,以部署 OpenShift 虛擬化元件。

瞭解節點位置

Red Hat OpenShift on IBM Cloud 群組中沒有標示為 master 的節點。 您必須設定節點放置政策,以指定虛擬化元件和 VM 工作負載的執行位置。

從控制台建立 HyperConverged CR

  1. 在 OpenShift 主控台中,導覽至 Ecosystem > Installed Operators (或早期版本中的 Operators > Installed Operators )。

  2. 按一下 OpenShift 虛擬化

  3. 點擊 HyperConverged 分頁標籤。

  4. 按一下建立 HyperConverged

  5. 設定基礎結構元件的節點位置:

    • 按一下 Infra 索引標籤
    • 新增節點選擇器或容差到目標 VSI 節點
  6. 為 VM 工作負載配置節點位置:

    • 按一下工作負載索引標籤
    • 針對裸金屬節點新增節點選擇器或容限
  7. 按一下建立

從 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

驗證安裝

  1. 檢查 HyperConverged 資源狀態。

    oc get hyperconverged -n openshift-cnv
    

    等到 PHASE 欄顯示 Deployed

  2. 驗證虛擬化 pod 是否正在執行。

    oc get pods -n openshift-cnv
    
  3. 檢查 OpenShift 主控台中的虛擬化功能表。

    • 登入 OpenShift 控制台
    • 在主導覽功能表中尋找虛擬化
  4. 驗證已建立儲存設定檔。

    oc get storageprofile
    
  5. 如果使用 VPC File Storage,請按照 為 OpenShift 虛擬化設定儲存設備 中的說明設定儲存設定檔。

疑難排解安裝問題

HyperConverged 資源部署失敗

如果 HyperConverged 資源因節點放置錯誤而無法部署:

  1. 檢查您的節點標籤。
    oc get nodes --show-labels
    
  2. 使用正確的節點選擇器更新 HyperConverged CR。
    oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
    
  3. 檢視 HyperConverged 作業員記錄。
    oc logs -n openshift-cnv -l name=hyperconverged-cluster-operator
    

操作員安裝失敗

如果操作器安裝失敗:

  1. 確認已啟用目錄來源。
    oc get catalogsource -n openshift-marketplace
    
  2. 檢查操作員訂閱狀態。
    oc get subscription -n openshift-cnv
    
  3. 檢視操作員日誌。
    oc logs -n openshift-cnv -l app=kubevirt-hyperconverged-operator
    

下一步

安裝 OpenShift Virtualization 之後:

如需完整的安裝說明,請參閱 Red Hat 文件中的安裝 OpenShift Virtualization