使用 Helm Charts 部署 MinIO 租戶

總覽

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

此程序要求 Kubernetes 叢集具有有效的 Operator 部署。您不能使用 MinIO Operator 租戶圖表來部署獨立於 Operator 的租戶。

重要

MinIO Operator 租戶圖表與社群管理的 MinIO 圖表不同。

社群 Helm Chart 由社群建置、維護和支援。MinIO 不保證對任何提及該圖表的特定錯誤、功能請求或更新提供支援。

Operator 租戶圖表由 MinIO 官方維護和支援。MinIO 強烈建議在生產環境中使用官方 Helm Chart 作為 Operator 和租戶。

先決條件

您必須符合以下要求才能使用 Helm 安裝 MinIO 租戶

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

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

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

此程序假設您已熟悉參考的 Kubernetes 概念和工具。雖然此文件可能盡力提供設定或部署 Kubernetes 相關資源的指南，但它不能取代官方的 Kubernetes 文件。

使用 Helm Charts 部署 MinIO Tenant

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

以下程序使用 Helm 部署 MinIO Tenant，並使用官方的 MinIO Tenant Chart。

重要

如果您使用 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 選取器、親和性和反親和性設定
- 節點選取器 (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 密碼。
`tenant.certificate.externalCACertSecret`	啟用對由未知、第三方或內部憑證授權機構 (CA) 簽署的用戶端 TLS 憑證進行驗證。指定一個或多個類型為 `kubernetes.io/tls` 的 Kubernetes 密碼，其中包含給定授權機構的完整 CA 憑證鏈。

設定 MinIO 環境變數

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

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

欄位

描述

tenant.configuration

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

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

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

根據您的 Tenant 需求修改此設定。

部署 Tenant

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

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 Chart 副本部署 Tenant。與基於儲存庫的安裝相比，此方法可能支援更容易的 Tenant 預先設定。

下載 Helm Charts

在本機主機上，將 Tenant Helm Charts 下載到方便的目錄
```
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 選取器、親和性和反親和性設定
- 節點選取器 (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 密碼。MinIO 使用這些憑證來根據主機名稱 (伺服器名稱指示) 執行 TLS 交握。
`tenant.certificate.externalCACertSecret`	指定一個或多個類型為 `kubernetes.io/tls` 的 Kubernetes 密碼，其中包含 Tenant 必須信任才能允許用戶端 TLS 連線的憑證授權機構 (CA) 鏈。

設定 MinIO 環境變數

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

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

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

根據您的 Tenant 需求修改此設定。
以下 Helm 命令使用標準 Chart 建立 MinIO Tenant
```
helm install \
--namespace TENANT-NAMESPACE \
--create-namespace \
TENANT-NAME tenant-6.0.4.tgz
```
若要部署多個 Tenant，請建立一個 Helm Chart，其中包含新 Tenant 的詳細資訊，然後重複部署步驟。重新部署相同的 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 的其他文件。