id: install_cluster-helm.md label: Helm order: 1

group: install_cluster-docker.md

安装 Milvus 分布式版

{{fragments/installation_guide_cluster.md}}

{{tab}}

我们推荐使用 minikube 在 Kubernetes 上安装 Milvus。 如下图所示,Minikube 默认安装 storageclass 组件。 如需使用其他方式安装 Milvus,请手动配置 storageclass。 详见改变默认 StorageClass

Storageclass

1.启动本地 Kubernetes 集群

  1. $ minikube start

2. 启动 Milvus

使用 Kubernetes 包管理工具 Helm 能够简化本步骤。

使用 Kubernetes 包管理工具 Helm 添加 Milvus chart 仓库:

  1. $ helm repo add milvus https://milvus-io.github.io/milvus-helm/

将 Milvus chart 更新至最新版本:

  1. $ helm repo update

安装 Milvus Helm chart:

设置发布命名(release name)以标记或追踪该 chart 部署。

  • 本教程使用 my-release 作为 release name。如需使用不同的 release name, 请在以下命令中修改相应的 release name。
  • Release name 中只能包含字母、数字以及下划线,不能包含点。

安装 Milvus 分布式版:

  1. $ helm install my-release milvus/milvus
使用 Helm 安装时,默认设定为安装分布式版 Milvus,无需修改命令行。 详见 Milvus Helm charts

如果启动成功,Milvus pod 将在 READY 下显示 1/1

  1. $ kubectl get pods
  2. NAME READY STATUS RESTARTS AGE
  3. my-release-etcd-0 1/1 Running 0 33s
  4. my-release-milvus-datacoord-574b99bbb7-t898f 1/1 Running 0 33s
  5. my-release-milvus-datanode-54568fc948-9rwbk 1/1 Running 0 33s
  6. my-release-milvus-indexcoord-576b44d56-wh6vk 1/1 Running 0 33s
  7. my-release-milvus-indexnode-67ff57745f-7lml8 1/1 Running 0 33s
  8. my-release-milvus-proxy-55f98ffbbb-r68qt 1/1 Running 0 33s
  9. my-release-milvus-pulsar-6475b86778-68r4l 1/1 Running 0 33s
  10. my-release-milvus-querycoord-74d8895985-m5sdr 1/1 Running 0 33s
  11. my-release-milvus-querynode-68486d847c-q5fg7 1/1 Running 0 33s
  12. my-release-milvus-rootcoord-746d8b5b99-2strx 1/1 Running 0 33s
  13. my-release-minio-68bbbf8459-2qxwv 1/1 Running 0 33s

3.连接 Milvus

打开新终端窗口,从你的本地端口转发至 Milvus 服务:

  1. $ kubectl port-forward service/my-release-milvus 19530
  2. Forwarding from 127.0.0.1:19530 -> 19530

4. 卸载 Milvus 实例

  1. $ helm uninstall my-release

5. 停用集群

如需关闭 minikube 虚拟机但保留所有已创建资源,运行以下命令停用集群:

  1. $ minikube stop
请运行命令minikube start以重新启动集群。

6. 删除集群

如无需重启集群,运行以下命令删除 minikube 虚拟机及包括持久卷(persistent volume)在内的所有已创建资源:

  1. minikube delete
如需留存日志,在删除集群前从每个 pod 的 stderr 中复制日志及相关资源。运行 kubectl logs (podname) 指令获取 pod 标准错误流。


阅读 升级指南 2.0 了解如何升级 Milvus 2.0 版本。