使用 Helm Charts 部署 MinIO Tenant

概觀

Helm 是一種用於自動化將應用程式部署到 Kubernetes 叢集的工具。Helm chart 是一組 YAML 檔案、範本和其他定義部署詳細資訊的檔案。以下程序使用 Helm Chart 來部署由 MinIO Operator 管理的 Tenant。

此程序要求 Kubernetes 叢集具有有效的 Operator 部署。您無法使用 MinIO Operator Tenant chart 部署獨立於 Operator 的 Tenant。

重要

MinIO Operator Tenant Chart 與社群管理的 MinIO Chart 是不同的。

社群 Helm Chart 由社群建置、維護和支援。MinIO 不保證針對任何給定的錯誤、功能要求或參考該 chart 的更新提供支援。

Operator Tenant Chart 由 MinIO 正式維護和支援。MinIO 強烈建議在生產環境中使用官方 Helm Chart 來部署 Operator 和 Tenants。

先決條件

您必須滿足以下要求才能使用 Helm 安裝 MinIO Tenant

現有的 Kubernetes 叢集
本機主機上的 kubectl CLI 工具，其版本與叢集相符。
Helm 3.8 或更高版本。
yq 4.18.1 或更高版本。
現有的 MinIO Operator 安裝。

此程序假設您的 Kubernetes 叢集存取權限授予您廣泛的管理權限。

如需有關 Tenant 安裝要求的更多資訊，包括支援的 Kubernetes 版本和 TLS 憑證，請參閱 Tenant 部署先決條件。

此程序假設您熟悉所參考的 Kubernetes 概念和實用程式。雖然此文件可能會在盡力而為的基礎上提供有關設定或部署 Kubernetes 相關資源的指引，但它並不能取代官方 Kubernetes 文件。

使用 Helm Charts 部署 MinIO Tenant

以下程序使用 MinIO Operator Chart Repository 部署 MinIO Tenant。與本機 chart 安裝相比，此方法支援簡化的安裝路徑。

以下程序使用 Helm 透過官方 MinIO Tenant Chart 部署 MinIO Tenant。

重要

如果您使用 Helm 部署 MinIO Tenant，您必須使用 Helm 來管理或升級該部署。請勿使用 kubectl krew、Kustomize 或類似方法來管理或升級 MinIO Tenant。

此程序並未詳盡列出 Tenant Chart 中所有可用的組態選項。它提供了一個基準，您可以從此基準修改並根據您的需求客製化 Tenant。

驗證您的 MinIO Operator Repo 組態

MinIO 在 https://operator.min.io 維護一個與 Helm 相容的儲存庫。如果該儲存庫尚未存在於您的本機 Helm 組態中，請在繼續之前新增它

helm repo add minio-operator https://operator.min.io

您可以使用 helm search 來驗證儲存庫內容

helm search repo minio-operator

回應應類似以下內容

NAME                            CHART VERSION   APP VERSION     DESCRIPTION
minio-operator/minio-operator   4.3.7           v4.3.7          A Helm chart for MinIO Operator
minio-operator/operator         6.0.4           v6.0.4          A Helm chart for MinIO Operator
minio-operator/tenant           6.0.4           v6.0.4          A Helm chart for MinIO Operator

建立 Helm values.yaml 的本機副本以進行修改
```
curl -sLo values.yaml https://raw.githubusercontent.com/minio/operator/master/helm/tenant/values.yaml
```
在您偏好的文字編輯器中開啟 values.yaml 物件。

設定 Tenant 拓撲

以下欄位共用 tenant.pools[0] 前綴，並控制 Tenant 中部署的所有 Pod 的伺服器數量、每個伺服器的磁碟區數量和儲存類別

欄位	描述
`servers`	在伺服器池中部署的 MinIO Pod 數量。
`volumesPerServer`	要附加到每個 MinIO Pod (`servers`) 的持久磁碟區數量。Operator 會為 Tenant 產生 `volumesPerServer x servers` 個持久磁碟區宣告。
`storageClassName`	要與產生的持久磁碟區宣告建立關聯的 Kubernetes 儲存類別。如果沒有符合指定值的儲存類別，或如果指定的儲存類別無法滿足請求的 PVC 數量或儲存容量，Tenant 可能無法啟動。
`size`	要為每個產生的 PVC 請求的儲存量。

設定 Tenant 親和性或反親和性

Tenant Chart 支援以下 Kubernetes Selector、親和性和反親和性組態
- 節點選取器 (tenant.nodeSelector)
- 節點/Pod 親和性或反親和性 (spec.pools[n].affinity)
MinIO 建議使用 Pod 反親和性來設定 Tenant，以確保 Kubernetes 排程器不會在同一個工作節點上排程多個 Pod。

如果您有想要在其中部署 Tenant 的特定工作節點，請將這些節點標籤或篩選器傳遞到 nodeSelector 或 affinity 欄位，以限制排程器將 Pod 放置在這些節點上。

設定網路加密

MinIO Tenant CRD 提供以下欄位，您可以使用這些欄位來設定 Tenant TLS 網路加密

欄位	描述
`tenant.certificate.requestAutoCert`	啟用或停用 MinIO 自動 TLS 憑證產生。如果省略，則預設為 `true` 或啟用。
`tenant.certificate.certConfig`	如果已啟用，則客製化自動 TLS 的行為。
`tenant.certificate.externalCertSecret`	透過伺服器名稱指示 (SNI) 為多個主機名稱啟用 TLS。指定一個或多個類型為 `kubernetes.io/tls` 或 `cert-manager` 的 Kubernetes secret。
`tenant.certificate.externalCACertSecret`	啟用對由不明、第三方或內部憑證授權單位 (CA) 簽署的用戶端 TLS 憑證的驗證。指定一個或多個類型為 `kubernetes.io/tls` 的 Kubernetes secret，其中包含給定授權單位的完整 CA 憑證鏈。

設定 MinIO 環境變數

您可以使用 tenant.configuration 欄位設定 MinIO 伺服器環境變數。

欄位	描述
`tenant.configuration`	指定一個 Kubernetes 不透明 secret，其資料酬載 `config.env` 包含您想要設定的每個 MinIO 環境變數。 `config.env` 資料酬載必須是 base64 編碼的字串。您可以建立本機檔案、設定環境變數，然後使用 `cat LOCALFILE \| base64` 來建立酬載。

欄位

描述

tenant.configuration

指定一個 Kubernetes 不透明 secret，其資料酬載 config.env 包含您想要設定的每個 MinIO 環境變數。

config.env 資料酬載必須是 base64 編碼的字串。您可以建立本機檔案、設定環境變數，然後使用 cat LOCALFILE | base64 來建立酬載。

YAML 包含一個物件 kind: Secret，其 metadata.name: storage-configuration 設定了根使用者名稱、密碼、Erasure Parity 設定，並啟用 Tenant 主控台。

根據需要修改此設定以反映您的 Tenant 需求。

部署 Tenant

使用 helm 安裝 Tenant Chart，並使用您的 values.yaml 作為覆寫

helm install \
--namespace TENANT-NAMESPACE \
--create-namespace \
--values values.yaml \
TENANT-NAME minio-operator/tenant

您可以使用以下命令監控進度

watch kubectl get all -n TENANT-NAMESPACE

公開 Tenant MinIO S3 API 連接埠

若要從您的本機電腦測試 MinIO Client mc，請轉發 MinIO 連接埠並建立別名。
- 轉發 Tenant 的 MinIO 連接埠
```
kubectl port-forward svc/TENANT-NAME-hl 9000 -n TENANT-NAMESPACE
```
- 建立 Tenant 服務的別名
```
mc alias set myminio https://127.0.0.1:9000 minio minio123 --insecure
```
您可以使用 mc mb 在 Tenant 上建立儲存貯體
```
mc mb myminio/mybucket --insecure
```
如果您使用受信任憑證授權單位 (CA) 發行的 TLS 憑證部署 MinIO Tenant，則可以省略 --insecure 旗標。

如需有關與 Tenant 建立外部連線的其他文件，請參閱連線至 Tenant。

使用本機 Helm Chart 部署 Tenant

以下程序使用 Helm Charts 的本機副本部署 Tenant。與基於儲存庫的安裝相比，此方法可能支援更輕鬆的 Tenant 預先組態。

下載 Helm Chart

在本機主機上，將 Tenant Helm Chart 下載到方便的目錄
```
curl -O https://raw.githubusercontent.com/minio/operator/master/helm-releases/tenant-6.0.4.tgz
```
每個 Chart 都包含一個 values.yaml 檔案，您可以根據自己的需求進行自訂。如需 MinIO Tenant values.yaml 中可用選項的詳細資訊，請參閱Tenant Helm Charts。

在您偏好的文字編輯器中開啟 values.yaml 物件。

設定 Tenant 拓撲

以下欄位共用 tenant.pools[0] 前綴，並控制 Tenant 中部署的所有 Pod 的伺服器數量、每個伺服器的磁碟區數量和儲存類別

欄位	描述
`servers`	在伺服器池中部署的 MinIO Pod 數量。
`volumesPerServer`	要附加到每個 MinIO Pod (`servers`) 的持久磁碟區數量。Operator 會為 Tenant 產生 `volumesPerServer x servers` 個持久磁碟區宣告。
`storageClassName`	要與產生的持久磁碟區宣告建立關聯的 Kubernetes 儲存類別。如果沒有符合指定值的儲存類別，或如果指定的儲存類別無法滿足請求的 PVC 數量或儲存容量，Tenant 可能無法啟動。
`size`	要為每個產生的 PVC 請求的儲存量。

設定 Tenant 親和性或反親和性

Tenant Chart 支援以下 Kubernetes Selector、親和性和反親和性組態
- 節點選取器 (tenant.nodeSelector)
- 節點/Pod 親和性或反親和性 (spec.pools[n].affinity)
MinIO 建議使用 Pod 反親和性來設定 Tenant，以確保 Kubernetes 排程器不會在同一個工作節點上排程多個 Pod。

如果您有想要在其中部署 Tenant 的特定工作節點，請將這些節點標籤或篩選器傳遞到 nodeSelector 或 affinity 欄位，以限制排程器將 Pod 放置在這些節點上。

設定網路加密

MinIO Tenant CRD 提供以下欄位，您可以使用這些欄位來設定 Tenant TLS 網路加密

欄位	描述
`tenant.certificate.requestAutoCert`	啟用或停用 MinIO 自動 TLS 憑證產生
`tenant.certificate.certConfig`	控制自動 TLS 的設定。需要 `spec.requestAutoCert: true`
`tenant.certificate.externalCertSecret`	指定一個或多個類型為 `kubernetes.io/tls` 或 `cert-manager` 的 Kubernetes secret。MinIO 使用這些憑證根據主機名稱 (伺服器名稱指示) 執行 TLS 交握。
`tenant.certificate.externalCACertSecret`	指定一個或多個類型為 `kubernetes.io/tls` 的 Kubernetes secret，其中包含 Tenant 必須信任才能允許用戶端 TLS 連線的憑證授權單位 (CA) 鏈。

設定 MinIO 環境變數

您可以使用 tenant.configuration 欄位設定 MinIO 伺服器環境變數。

此欄位必須指定一個 Kubernetes 不透明 secret，其資料酬載 config.env 包含您想要設定的每個 MinIO 環境變數。

YAML 包含一個物件 kind: Secret，其 metadata.name: storage-configuration 設定了根使用者名稱、密碼、Erasure Parity 設定，並啟用 Tenant 主控台。

根據需要修改此設定以反映您的 Tenant 需求。
以下 Helm 命令使用標準 Chart 建立 MinIO Tenant
```
helm install \
--namespace TENANT-NAMESPACE \
--create-namespace \
TENANT-NAME tenant-6.0.4.tgz
```
若要部署多個 Tenant，請使用新 Tenant 的詳細資料建立 Helm Chart，然後重複部署步驟。重新部署相同的 Chart 會更新先前部署的 Tenant。
公開 Tenant MinIO 連接埠

若要從您的本機電腦測試 MinIO Client mc，請轉發 MinIO 連接埠並建立別名。
- 轉發 Tenant 的 MinIO 連接埠
```
kubectl port-forward svc/TENANT-NAME-hl 9000 -n TENANT-NAMESPACE
```
- 建立 Tenant 服務的別名
```
mc alias set myminio https://127.0.0.1:9000 minio minio123 --insecure
```
  此範例使用非 TLS myminio-hl 服務，此服務需要 --insecure。
  
  如果您已設定 TLS 憑證，請省略 --insecure 並改用 svc/minio。
您可以使用 mc mb 在 Tenant 上建立儲存貯體
mc mb myminio/mybucket --insecure

如需有關與 Tenant 建立外部連線的其他文件，請參閱連線至 Tenant。