韩国服务器部署Milvus前要准备哪些依赖,如何验证服务可用?

发布人:A5数据发布时间:2026-11-12 11:02阅读量:51

首次在韩国服务器部署 Milvus,建议先按单机测试或小规模服务的目标准备环境,再使用官方发布包中与 Milvus 版本匹配的 Docker Compose 配置启动。Milvus Standalone 通常还需要 etcd 保存元数据,并需要对象存储保存数据文件;采用官方 Compose 配置时,这些依赖一般会与 Milvus 一起编排。部署前应确认服务器资源、Docker 环境、磁盘空间和访问端口,启动后再分别验证容器状态、健康接口及实际读写查询。

部署概述配图

以下以 Linux x86_64 服务器、Docker Compose、Milvus Standalone 为例。韩国机房不会改变 Milvus 的依赖组成,但应确认服务器能够访问所需镜像仓库和软件源;如需远程连接,还要控制防火墙开放范围,避免将内部依赖端口直接暴露到公网。

A5idc数据提供韩国首尔地区的物理服务器资源,覆盖不同CPU、内存、存储及网络线路配置,可作为Milvus Standalone、向量数据库和容器化服务的部署基础。针对向量数据写入、索引构建与查询等业务,品牌可结合业务访问地区、数据规模和程序负载,提供相应的服务器方案,并支持从常规建站资源到更高计算与存储需求的配置组合。

部署前准备

资源与系统条件

单机试运行可将 4 vCPU、8 GB 内存和 SSD 作为起步参考;数据规模、向量维度、并发查询和索引类型都会影响实际资源需求。生产负载较大时,应根据数据量和查询压力单独评估容量,不要把起步配置当作性能保证。

建议准备:

  • 受支持的 64 位 Linux 发行版,例如 Ubuntu LTS。
  • 可用的 SSD 磁盘空间,并为 Docker 数据目录预留增长余量。
  • 具有 sudo 权限的部署账号。
  • 能访问 Docker 镜像仓库及 Milvus 发布文件的网络。
  • 一个固定的 Milvus 版本,以及与该版本对应的 Compose 配置。

先确认系统架构、磁盘和内存:

uname -m
free -h
df -h

uname -m 应显示 x86_64;若是其他架构,应先核对目标 Milvus 版本及其依赖镜像是否支持,不能直接照搬 x86_64 部署步骤。df -h 用于检查 Docker 数据目录所在文件系统是否有足够空间。

软件依赖与端口规划

部署需要 Docker Engine 和 Docker Compose 插件。先检查是否已安装:

docker --version
docker compose version

两条命令都应返回版本信息。若命令不存在,应按当前 Linux 发行版的官方安装方式安装 Docker Engine 和 Compose 插件,并确认 Docker 服务已启动。不要混用旧版 docker-compose 和新版 docker compose 命令,除非已确认配置兼容。

Milvus 常见访问端口包括:

端口用途建议访问范围
19530SDK、客户端连接 Milvus仅业务服务器或管理网段
9091Milvus 健康检查及管理相关接口本机或受控管理网段
2379etcd 客户端通信仅 Compose 内部网络
9000、9001对象存储服务接口及控制台仅 Compose 内部网络,确有需要时再单独开放

实际映射以下载的 Compose 文件为准。不要因为服务器位于韩国就默认放行所有端口;公网侧通常只需允许受信任的客户端访问 Milvus 服务端口。etcd 和对象存储端口不应直接暴露给公网。

下载并检查部署配置

固定版本并取得官方 Compose 文件

选择一个明确的 Milvus 版本,并使用该版本发布的官方 Standalone Compose 文件。下面以 v2.5.0 展示命令格式;实际部署时,应将版本号替换为计划使用且已核验的版本,避免混用不同版本的配置文件与镜像。

export MILVUS_VERSION=v2.5.0
mkdir -p "$HOME/milvus-deploy"
cd "$HOME/milvus-deploy"

curl -fL \
  "https://github.com/milvus-io/milvus/releases/download/${MILVUS_VERSION}/milvus-standalone-docker-compose.yml" \
  -o docker-compose.yml

若服务器没有 curl,可使用发行版提供的下载工具。下载失败时,先检查 DNS、出站网络和发布文件版本是否正确,不要改用来源不明的配置文件。

检查文件是否存在并查看实际内容:

test -s docker-compose.yml && echo "Compose 文件已下载"
grep -nE 'image:|ports:|volumes:|etcd|minio|milvus' docker-compose.yml

应能看到 Milvus 及其依赖服务的镜像、端口和数据卷配置。不同发布版本的服务名、镜像标签和配置项可能变化,后续命令以文件中的服务定义为准。

校验配置并拉取镜像

运行配置解析,提前发现 YAML 缩进、变量或 Compose 兼容问题:

docker compose -f docker-compose.yml config

命令成功时会输出解析后的配置;若提示未知字段或缺少变量,应先对照该 Milvus 版本的部署说明处理,不要直接删改不理解的配置项。

启动前拉取镜像:

docker compose -f docker-compose.yml pull

此步骤可能受韩国服务器到镜像仓库的网络状况影响。若拉取失败,先查看报错中的镜像名称、标签及网络错误;不要把依赖镜像替换成未经核验的其他版本。

启动 Milvus Standalone

在配置校验和镜像拉取成功后,启动整组服务:

docker compose -f docker-compose.yml up -d

查看容器状态:

docker compose -f docker-compose.yml ps

预期是 Milvus、etcd、对象存储等所需容器处于 Up 或相应的健康状态。若某个容器持续重启,不要反复执行启动命令掩盖问题,应先查看日志:

docker compose -f docker-compose.yml logs --tail=100

也可以只查看某个服务。服务名需以 Compose 文件为准,例如:

docker compose -f docker-compose.yml config --services
docker compose -f docker-compose.yml logs --tail=100 milvus-standalone

如果配置中的 Milvus 服务不叫 milvus-standalone,将日志命令中的服务名换成 config --services 输出的实际名称。

分层验证服务可用性

检查健康接口和监听端口

先从服务器本机检查 Milvus 健康接口:

curl -i http://127.0.0.1:9091/healthz

健康时通常会返回 HTTP 成功状态及表示正常的响应内容。具体返回文本可能随版本不同而变化,应以 HTTP 状态和对应版本文档为准。若连接被拒绝,检查容器状态、端口映射及启动日志;若本机可访问而远程不可访问,再检查云防火墙、安全组和系统防火墙规则。

检查主机是否在预期端口监听:

ss -lntp | grep -E '19530|9091'

没有输出不一定代表服务未启动:Compose 文件可能只绑定容器内部网络,或将端口绑定到其他地址。应同时检查配置中的 ports 和容器状态,不能仅凭 ss 判断整个服务是否异常。

使用 Python 验证连接、写入和查询

健康接口只能说明服务端具备基本响应能力;还应使用客户端完成一次实际写入和查询。建议在独立虚拟环境中安装与 Milvus 服务版本兼容的 pymilvus,并参考所用版本的兼容说明选择客户端版本。

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install pymilvus

将以下内容保存为 verify_milvus.py。示例使用本机地址和临时集合名;若在另一台机器运行,应将地址换成韩国服务器可达的 IP 或域名,并确保防火墙只允许该客户端来源访问。

from pymilvus import MilvusClient

client = MilvusClient(uri="http://127.0.0.1:19530")

collection_name = "milvus_deploy_check"
if client.has_collection(collection_name):
    client.drop_collection(collection_name)

client.create_collection(
    collection_name=collection_name,
    dimension=4,
)

client.insert(
    collection_name=collection_name,
    data=[
        {"id": 1, "vector": [0.1, 0.2, 0.3, 0.4], "label": "check"}
    ],
)

result = client.search(
    collection_name=collection_name,
    data=[[0.1, 0.2, 0.3, 0.4]],
    limit=1,
    output_fields=["label"],
)

print(result)
client.drop_collection(collection_name)
client.close()

运行验证:

python verify_milvus.py

成功时,程序应完成连接、创建集合、插入数据、搜索并输出命中结果,最后删除本次测试集合。该脚本会删除同名集合,因此应只在新部署的测试环境运行,或先确认该集合没有需要保留的数据。若客户端报连接错误,优先核对地址、端口映射和防火墙;若连接成功但建集合或写入失败,查看 Milvus、etcd 和对象存储日志,确认依赖服务均正常。

常见失败与处理顺序

现象优先检查判断与处理
镜像拉取超时或失败出站网络、DNS、镜像标签确认服务器可访问镜像仓库,核对 Compose 中镜像标签是否存在;不要随意更换标签
Milvus 容器反复重启Milvus 与依赖服务日志、内存检查 etcd、对象存储是否已启动,查看是否出现内存不足、数据目录权限或配置错误
健康接口无法连接容器状态、9091 映射确认服务已就绪且配置映射了该端口;按日志判断是启动尚未完成还是服务异常
本机可连接,远程客户端超时端口映射、防火墙、安全组、路由检查 19530 是否绑定到可达地址,并仅对业务来源开放;不要公开内部依赖端口
客户端版本不兼容或调用失败Milvus 与 PyMilvus 版本、SDK API按对应版本兼容说明调整客户端版本和调用方式,再执行连接与读写验证

韩国机房与客户端所在地之间的网络质量会影响远程连接时延;服务端本机验证成功,并不等于跨地域客户端网络也已验证。远程验收应从实际业务来源发起连接测试。

结果检查与回滚

验收前逐项确认:

  • Docker Engine 和 Compose 命令可正常执行,配置文件通过 docker compose config 校验。
  • Milvus、etcd、对象存储等必需容器处于运行状态,日志没有持续重启或依赖连接失败信息。
  • 本机健康接口返回正常,Milvus 客户端能够完成创建集合、写入、搜索和清理测试。
  • 远程访问仅对需要的客户端来源开放;etcd 和对象存储端口未暴露到公网。
  • 数据卷和磁盘目录位置明确,已确认后续数据保留策略。

如果部署验证失败,需要停止服务,可在部署目录执行:

docker compose -f docker-compose.yml down

该命令会停止并移除 Compose 容器和网络,通常保留命名数据卷;是否保留应以配置文件中的卷定义为准。不要把 down 与 down -v 混用:-v 会删除 Compose 管理的数据卷,可能造成 Milvus 数据、元数据及对象存储文件丢失。只有确认这是可丢弃的全新测试环境,或已备份并验证恢复方案后,才考虑删除数据卷。

回滚检查应确认容器已停止、服务端口不再监听,并核实数据卷仍按预期保留。若需要恢复部署,先修正配置或资源问题,再重新执行配置校验、启动和客户端读写验证。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8987.html

相关推荐