跳至主要内容

附加元件開發指南

Harvester 附加元件 (add-ons) 允許您根據需求啟用和停用特定的 Harvester 和第三方元件。附加元件的功能類似於 RKE2 HelmChart 資源定義 (CRD) 的封裝器 (wrapper)。

先決條件​

  • 現有的 Harvester 叢集

附加元件規格​

Addon CRD 支援以下欄位：

apiVersion: harvesterhci.io/v1beta1
kind: Addon                         
metadata:
  name: example-add-on           # 附加元件的名稱
  namespace: example-namespace  # 部署附加元件 CRD 以及相關 Kubernetes 元件將被部署的命名空間
  labels:                       # 選用的附加元件標籤
    Add-on.harvesterhci.io/experimental: "true" # Harvester UI 上用於識別具有「實驗性」成熟度等級之附加元件的預定義標籤
spec:
  enabled: false                # 布林值，指示在定義時應啟用或停用附加元件
  repo: [https://chartsrepo.com](https://chartsrepo.com)  # 包含由附加元件管理的 Helm chart 的 Helm chart 儲存庫
  version: "v0.19.0"            # 要安裝的 Helm chart 版本
  chart: mychart                # Helm chart 儲存庫中的 Helm chart 名稱
  valuesContent: |-             # 必須傳遞給 Helm chart 的檔案 (values.yaml)
    contents of values.yaml
    that need to be passed
    to the chart
備註

實驗性附加元件未直接打包在 Harvester 中。例如 rancher-vcluster 附加元件。

安裝​

kubectl apply -f /path/to/add-on.yaml

使用方法​

建立 Addon CRD 後，您可以切換 enabled 欄位以啟用和停用相關聯的 Helm chart。

升級​

變更 repo、version、chart 或 valueContent 欄位將觸發 helm upgrade，這會強制升級現有的 Helm chart。

解除安裝​

kubectl delete -f /path/to/Add-on.yaml