You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
154 lines
7.2 KiB
154 lines
7.2 KiB
# 使用Kubernetes部署MinIO [](https://slack.min.io) [](https://hub.docker.com/r/minio/minio/)
|
|
|
|
Kubernetes的部署和状态集提供了在独立，分布式或共享模式下部署MinIO服务器的完美平台。 在Kubernetes上部署MinIO有多种选择，您可以选择最适合您的。
|
|
|
|
- MinIO [Helm](https://helm.sh) Chart通过一个简单的命令即可提供自定义而且简单的MinIO部署。更多关于MinIO Helm部署的资料，请访问[这里](#prerequisites).
|
|
|
|
- 你也可以浏览Kubernetes [MinIO示例](https://github.com/minio/minio/blob/master/docs/orchestration/kubernetes/README.md) ，通过`.yaml`文件来部署MinIO。
|
|
|
|
<a name="prerequisites"></a>
|
|
## 1. 前提条件
|
|
|
|
* 默认standaline模式下，需要开启Beta API的Kubernetes 1.4+。
|
|
* [distributed 模式](#distributed-minio)，需要开启Beta API的Kubernetes 1.5+。
|
|
* 底层支持PV provisioner。
|
|
* 你的K8s集群里需要有Helm package manager [installed](https://github.com/kubernetes/helm#install)。
|
|
|
|
## 2. 使用Helm Chart部署MinIO
|
|
|
|
安装 MinIO chart
|
|
|
|
```bash
|
|
$ helm install stable/minio
|
|
```
|
|
以上命令以默认配置在Kubernetes群集上部署MinIO。 以下部分列出了MinIO图表的所有可配置参数及其默认值。
|
|
|
|
### 配置
|
|
|
|
| 参数 | 描述 | 默认值 |
|
|
|----------------------------|-------------------------------------|---------------------------------------------------------|
|
|
| `image` | MinIO镜像名称 | `minio/minio` |
|
|
| `imageTag` | MinIO镜像tag. 可选值在 [这里](https://hub.docker.com/r/minio/minio/tags/).| `RELEASE.2017-08-05T00-00-53Z`|
|
|
| `imagePullPolicy` | Image pull policy | `Always` |
|
|
| `mode` | MinIO server模式 (`standalone`, `shared` 或者 `distributed`)| `standalone` |
|
|
| `numberOfNodes` | 节点数 (仅对分布式模式生效). 可选值 4 <= x <= 16 | `4` |
|
|
| `accessKey` | 默认access key | `AKIAIOSFODNN7EXAMPLE` |
|
|
| `secretKey` | 默认secret key | `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY` |
|
|
| `configPath` | 默认配置文件路径 | `~/.minio` |
|
|
| `mountPath` | 默认挂载路径| `/export` |
|
|
| `serviceType` | Kubernetes service type | `LoadBalancer` |
|
|
| `servicePort` | Kubernetes端口 | `9000` |
|
|
| `persistence.enabled` | 是否使用持久卷存储数据 | `true` |
|
|
| `persistence.size` | 持久卷大小 | `10Gi` |
|
|
| `persistence.storageClass` | 持久卷类型 | `generic` |
|
|
| `persistence.accessMode` | ReadWriteOnce 或者 ReadOnly | `ReadWriteOnce` |
|
|
| `resources` | CPU/Memory 资源需求/限制 | Memory: `256Mi`, CPU: `100m` |
|
|
|
|
你可以通过`--set key=value[,key=value]`给`helm install`。 比如,
|
|
|
|
```bash
|
|
$ helm install --name my-release \
|
|
--set persistence.size=100Gi \
|
|
stable/minio
|
|
```
|
|
|
|
上述命令部署了一个带上100G持久卷的MinIO服务。
|
|
|
|
或者，您可以提供一个YAML文件，用于在安装chart时指定参数值。 例如，
|
|
|
|
```bash
|
|
$ helm install --name my-release -f values.yaml stable/minio
|
|
```
|
|
|
|
### 分布式MinIO
|
|
|
|
默认情况下，此图表以独立模式提供MinIO服务器。 要在[分布式模式](https://docs.min.io/cn/distributed-minio-quickstart-guide)中配置MinIO服务器，请将`mode`字段设置为`distributed`,
|
|
|
|
```bash
|
|
$ helm install --set mode=distributed stable/minio
|
|
```
|
|
|
|
上述命令部署了个带有4个节点的分布式MinIO服务器。 要更改分布式MinIO服务器中的节点数，请设置`numberOfNodes`属性。
|
|
|
|
|
|
```bash
|
|
$ helm install --set mode=distributed,numberOfNodes=8 stable/minio
|
|
```
|
|
|
|
上述命令部署了个带有8个节点的分布式MinIO服务器。注意一下，`numberOfNodes`取值范围是[4,16]。
|
|
|
|
#### StatefulSet [限制](http://kubernetes.io/docs/concepts/abstractions/controllers/statefulsets/#limitations)，适用于分布式MinIO
|
|
|
|
* StatefulSets需要持久化存储，所以如果 `mode`设成 `distributed`的话，`persistence.enabled`参数不生效。
|
|
* 卸载分布式MinIO版本时，需要手动删除与StatefulSet关联的卷。
|
|
|
|
### Shared MinIO
|
|
|
|
如需采用[shared mode](https://github.com/minio/minio/blob/master/docs/shared-backend/README.md)部署MinIO, 将`mode` 设为`shared`,
|
|
|
|
```bash
|
|
$ helm install --set mode=shared stable/minio
|
|
```
|
|
|
|
上述命令规定了4个MinIO服务器节点，一个存储。 要更改共享的MinIO部署中的节点数，请设置`numberOfNodes`字段，
|
|
|
|
```bash
|
|
$ helm install --set mode=shared,numberOfNodes=8 stable/minio
|
|
```
|
|
|
|
上述命令规定了MinIO服务有8个节点，采用shared模式。
|
|
|
|
### 持久化
|
|
|
|
这里规定了PersistentVolumeClaim并将相应的持久卷挂载到默认位置`/export`。 您需要Kubernetes集群中的物理存储才能使其工作。 如果您宁愿使用`emptyDir`，请通过以下方式禁用PersistentVolumeClaim：
|
|
|
|
```bash
|
|
$ helm install --set persistence.enabled=false stable/minio
|
|
```
|
|
|
|
> *"当Pod分配给节点时，首先创建一个emptyDir卷，只要该节点上的Pod正在运行，它就会存在。 当某个Pod由于任何原因从节点中删除时，emptyDir中的数据将永久删除。"*
|
|
|
|
## 3. 使用Helm更新MinIO版本
|
|
|
|
您可以更新现有的MinIO Helm Release以使用较新的MinIO Docker镜像。 为此，请使用`helm upgrade`命令：
|
|
|
|
```bash
|
|
$ helm upgrade --set imageTag=<replace-with-minio-docker-image-tag> <helm-release-name> stable/minio
|
|
```
|
|
|
|
如果更新成功，你可以看到下面的输出信息
|
|
|
|
```bash
|
|
Release "your-helm-release" has been upgraded. Happy Helming!
|
|
```
|
|
|
|
## 4. 卸载Chart
|
|
|
|
假设你的版本被命名为`my-release`，使用下面的命令删除它：
|
|
|
|
```bash
|
|
$ helm delete my-release
|
|
```
|
|
|
|
该命令删除与chart关联的所有Kubernetes组件，并删除该release。
|
|
|
|
### 提示
|
|
|
|
* 在Kubernetes群集中运行的chart的实例称为release。 安装chart后，Helm会自动分配唯一的release名称。 你也可以通过下面的命令设置你心仪的名称：
|
|
|
|
```bash
|
|
$ helm install --name my-release stable/minio
|
|
```
|
|
|
|
* 为了覆盖默认的秘钥，可在运行helm install时将access key和secret key做为参数传进去。
|
|
|
|
```bash
|
|
$ helm install --set accessKey=myaccesskey,secretKey=mysecretkey \
|
|
stable/minio
|
|
```
|
|
|
|
### 了解更多
|
|
|
|
- [MinIO纠删码快速入门](https://docs.min.io/cn/minio-erasure-code-quickstart-guide)
|
|
- [Kubernetes文档](https://kubernetes.io/docs/home/)
|
|
- [Helm package manager for kubernetes](https://helm.sh/)
|
|
|