Skip to content

v1.2.0

Choose a tag to compare

View all tags
@mukoubuchi mukoubuchi released this 11 Jun 22:49
· 40 commits to main since this release
v1.2.0
604901c

Highlights

This release upgrades the Milvus stack to 2.6, automates credential management, and adds end-to-end test coverage.

⚠️ Breaking change for instructors: Milvus 2.6 cannot read 2.3-era volumes. Before starting the upgraded environment, reset the volumes (sample data can simply be re-inserted):

cd setup/instructor && docker compose --profile all down -v && ./start-all.sh

Milvus 2.6

  • Milvus upgraded from v2.3.3 (EOL) to v2.6.18, following the official standalone compose layout (etcd v3.5.25, MinIO 2024-12-18, MQ_TYPE: woodpecker)
  • pymilvus upgraded to 2.6.15; the obsolete marshmallow pin was removed
  • All transitive Python dependencies are now pinned to exact versions for reproducible participant installs

Automated credential management

  • start-all.sh now generates random Milvus root and MinIO passwords on first start, stores them in setup/instructor/.env, waits for Milvus to become healthy, and rotates the root password away from the default (idempotent — safe to rerun)
  • Participant .env templates use a <password distributed by instructor> placeholder; the scripts refuse to run while any placeholder is unchanged

Delivery guidance

  • Remote delivery docs now recommend private networks (Tailscale/VPN) first; ngrok TCP is documented as a fallback with an explicit warning that Milvus gRPC traffic transits the tunnel unencrypted

Demo application

  • /search recovers automatically when the collection was dropped and recreated (no app restart needed after re-inserting data)

Tooling

  • New E2E smoke workflow (manual trigger): starts the full instructor environment incl. credential generation, then runs the participant flow (connection test, data insertion, search) end to end
  • New release workflow: participant zips are built and attached to every v* release
  • CI now runs shellcheck and ruff
  • The docs container is built from mkdocs.Dockerfile (no pip install at startup)
  • check_translation_sync.sh no longer leaves changed_files.txt behind on local runs
  • Linux participants: documented the CPU-only torch install (saves several GB)

Upgrade notes for instructors

  1. Reset volumes and restart: cd setup/instructor && docker compose --profile all down -v && ./start-all.sh
  2. Note the generated Milvus password printed by start-all.sh and share it with participants
  3. Distribute the regenerated zips (also attached to this release as assets)

Full Changelog: v1.1.0...v1.2.0

Assets 4
Loading