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。
1.启动本地 Kubernetes 集群
$ minikube start
2. 启动 Milvus
使用 Kubernetes 包管理工具 Helm 能够简化本步骤。
使用 Kubernetes 包管理工具 Helm 添加 Milvus chart 仓库:
$ helm repo add milvus https://milvus-io.github.io/milvus-helm/
将 Milvus chart 更新至最新版本:
$ helm repo update
安装 Milvus Helm chart:
设置发布命名(release name)以标记或追踪该 chart 部署。
- 本教程使用
my-release
作为 release name。如需使用不同的 release name, 请在以下命令中修改相应的 release name。 - Release name 中只能包含字母、数字以及下划线,不能包含点。
安装 Milvus 分布式版:
$ helm install my-release milvus/milvus
使用 Helm 安装时,默认设定为安装分布式版 Milvus,无需修改命令行。
详见 Milvus Helm charts。
如果启动成功,Milvus pod 将在 READY
下显示 1/1
:
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
my-release-etcd-0 1/1 Running 0 33s
my-release-milvus-datacoord-574b99bbb7-t898f 1/1 Running 0 33s
my-release-milvus-datanode-54568fc948-9rwbk 1/1 Running 0 33s
my-release-milvus-indexcoord-576b44d56-wh6vk 1/1 Running 0 33s
my-release-milvus-indexnode-67ff57745f-7lml8 1/1 Running 0 33s
my-release-milvus-proxy-55f98ffbbb-r68qt 1/1 Running 0 33s
my-release-milvus-pulsar-6475b86778-68r4l 1/1 Running 0 33s
my-release-milvus-querycoord-74d8895985-m5sdr 1/1 Running 0 33s
my-release-milvus-querynode-68486d847c-q5fg7 1/1 Running 0 33s
my-release-milvus-rootcoord-746d8b5b99-2strx 1/1 Running 0 33s
my-release-minio-68bbbf8459-2qxwv 1/1 Running 0 33s
3.连接 Milvus
打开新终端窗口,从你的本地端口转发至 Milvus 服务:
$ kubectl port-forward service/my-release-milvus 19530
Forwarding from 127.0.0.1:19530 -> 19530
4. 卸载 Milvus 实例
$ helm uninstall my-release
5. 停用集群
如需关闭 minikube 虚拟机但保留所有已创建资源,运行以下命令停用集群:
$ minikube stop
请运行命令
minikube start
以重新启动集群。
6. 删除集群
如无需重启集群,运行以下命令删除 minikube 虚拟机及包括持久卷(persistent volume)在内的所有已创建资源:
minikube delete
如需留存日志,在删除集群前从每个 pod 的
stderr
中复制日志及相关资源。运行 kubectl logs (podname)
指令获取 pod 标准错误流。
阅读 升级指南 2.0 了解如何升级 Milvus 2.0 版本。