mirror of
https://github.com/milvus-io/milvus.git
synced 2026-07-21 10:15:43 +00:00
39c9b039d2
Cherry-pick from master pr: https://github.com/milvus-io/milvus/pull/50221 pr: https://github.com/milvus-io/milvus/pull/50515 issue: #47420 Backports two related master PRs onto 2.6: - #50221 — standardize error handling on merr + Sys/Input classification (629 files) - #50515 — error-handling casebook + guide/convention docs (follow-up to #50221) ### 2.6 adaptation notes master has diverged significantly from 2.6 (whole-repo `pkg/v2`→`pkg/v3` and `milvus-proto/go-api/v2`→`v3` module renames, plus many feature PRs not on 2.6), so the replay required: - Normalizing all `pkg/v3` / `go-api/v3` imports back to `v2`. - Dropping edits to master-only files/features absent on 2.6 (snapshot, search aggregation, struct-array search, external-collection refresh, two-stage delegator, storagev2 packed FFI extras, function/chain, etc.). - Extending the raw-error→merr cleanup to the 2.6 files the newly added ruleguard linter flags (master had already cleaned these in earlier work). - Aligning a set of test error-code/message expectations with the new merr classification (mirroring #50221's own test changes that didn't apply cleanly across the divergence). ### Verification - build (go + cgo core) ✓ - make verifiers (gofmt + golangci-lint, all modules) ✓ - test-go: all changed packages + pkg module ✓ - e2e L0/L1/L2 (standalone): python_client + restful_client_v2 ✓ — remaining failures are environment/topology only (multi-querynode/datanode cluster tests, and the auth-enabled subset which passes once `authorizationEnabled=true`). --------- Signed-off-by: zhenshan.cao <zhenshan.cao@zilliz.com> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Compile and install milvus cluster
Environment
OS: Ubuntu 20.04
go：1.21
cmake: >=3.18
gcc： 7.5
Install dependencies
Install compile dependencies
$ sudo apt install -y g++ gcc make libssl-dev zlib1g-dev libboost-regex-dev \
libboost-program-options-dev libboost-system-dev libboost-filesystem-dev \
libboost-serialization-dev python3-dev libboost-python-dev libcurl4-openssl-dev gfortran libtbb-dev
$ export GO111MODULE=on
$ go get github.com/golang/protobuf/protoc-gen-go@v1.3.2
Install OpenBlas library
install using apt
sudo apt install -y libopenblas-dev
or build from source code
$ wget https://github.com/xianyi/OpenBLAS/archive/v0.3.9.tar.gz && \
$ tar zxvf v0.3.9.tar.gz && cd OpenBLAS-0.3.9 && \
$ make TARGET=CORE2 DYNAMIC_ARCH=1 DYNAMIC_OLDER=1 USE_THREAD=0 USE_OPENMP=0 FC=gfortran CC=gcc COMMON_OPT="-O3 -g -fPIC" FCOMMON_OPT="-O3 -g -fPIC -frecursive" NMAX="NUM_THREADS=128" LIBPREFIX="libopenblas" INTERFACE64=0 NO_STATIC=1 && \
$ make PREFIX=/usr install
Compile
Generate the go files from proto file
$ make check-proto-product
Check code specifications
$ make verifiers
Compile milvus
$ make milvus
Install docker-compose
refer: https://docs.docker.com/compose/install/
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
$ docker-compose --version
$ docker compose --version
Start service
Start third-party service:
$ cd [milvus project path]/deployments/docker/cluster
$ docker-compose up -d
$ docker compose up -d
Start milvus cluster:
$ cd [milvus project path]
$ ./scripts/start_cluster.sh
Run unittest
Run all unittest including go and cpp cases:
$ make unittest
You also can run go unittest only:
$ make test-go
Run cpp unittest only:
$ make test-cpp
Run code coverage
Run code coverage including go and cpp:
$ make codecov
You also can run go code coverage only:
$ make codecov-go
Run cpp code coverage only:
$ make codecov-cpp