milvus 0.10.1 → 0.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a4dd23dd2d85a1a231214808ee57ece287c47fde46084f726831dc47e7aaed7
-  data.tar.gz: 52bca3e02f864a52c5c85c9f1aa725a16641fedaafb4b5ed8a7c6964664b9fe8
+  metadata.gz: c38f7235b815b1f48dd2d61e445b99ca675f974d1dddeba02796bf02e353fdd1
+  data.tar.gz: 4af6a551675f63cb17ee6f2c80a8ca000ea98ff028eeefa71f9593061ac04969
 SHA512:
-  metadata.gz: 3c60bf9de09afaebc7cf0382529b07440680f50ed5f94c8ededb416f8cf29ddbaa7183527235c5daa12ce37412ca9b2b822e0b871d70fb67101ab291eb62c305
-  data.tar.gz: 7b5b2b34f19ee53b33e025f6e9c170584fcf4b86c647e79c6acf519b0a3560e3b68f02fbcc60bdaafd27e41165704cf07dfdc1f4a52ddee198327ca7f8cd0278
+  metadata.gz: 37d2666740b3e9df096e5f8b024a72fff37b60c53810f8dcbd5f0b14c4a008060d5cad78109664b74d7e2e76d21c8559cbb6c079b046032acd09491c5a3c3109
+  data.tar.gz: 7c10d887561876c02e6f869807b01c339b2412137e3cefb584ce5451da815eafec06f5c4ea83bbd231862b9742aad08d711566a2660193016b9eb809eca7798b

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [0.10.2] - 2024-07-28
+- Added Roles management
+- Added Users management
+- Added docker-compose.yml with directions to run Milvus in Docker
+
 ## [0.10.1] - 2024-07-04 🇺🇸
 - Fixes and improvements to the gem.
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    milvus (0.10.1)
+    milvus (0.10.2)
       faraday (>= 2.0.1, < 3)
 
 GEM

data/README.md

@@ -22,6 +22,11 @@ Available for paid consulting engagements! [Email me](mailto:andrei@sourcelabs.i
 ## API Docs
 https://docs.zilliz.com/reference/restful/data-plane-v2
 
+## TODOs
+- [X] Support for [User endpoints](https://docs.zilliz.com/reference/restful/user-operations-v2)
+- [X] Support for [Role endpoints](https://docs.zilliz.com/reference/restful/role-operations-v2)
+- [ ] Support for [Alias endpoints](https://docs.zilliz.com/reference/restful/alias-operations-v2)
+
 ## Installation
 
 Install the gem and add to the application's Gemfile by executing:
@@ -267,12 +272,62 @@ client.partitions.drop(
 )
 ```
 
+### Roles
+```ruby
+# List roles available on the server
+client.roles.list
+```
+```ruby
+# Describe the role
+client.roles.describe(role_name: 'public')
+```
+
+### Users
+```ruby
+# Create new user
+client.users.create(user_name: 'user_name', password: 'password')
+```
+```ruby
+# List of roles assigned to the user
+client.users.describe(user_name: 'user_name')
+```
+```ruby
+# List all users in the specified database.
+client.users.list
+```
+```ruby
+# Drop existing user
+client.users.drop(user_name: 'user_name')
+```
+```ruby
+# Update password for the user
+client.users.update_password(user_name: 'user_name', password: 'old_password', new_password: 'new_password')
+```
+```ruby
+# Grant role to the user
+client.users.grant_role(user_name: 'user_name', role_name: 'admin')
+```
+```ruby
+# Revoke role from the user 
+client.users.revoke_role(user_name: 'user_name', role_name: 'admin')
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## Development with Docker
+
+Run `docker compose run --rm ruby_app bash` and install required gems (`bundle install`). It will give you a fully working development environment with Milvius services and gem's code.
+
+For example inside docker container run `bin/console` and inside the ruby console:
+```ruby
+client = Milvus::Client.new(url: ENV["MILVUS_URL"])
+client.collections.list
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/patterns-ai-core/milvus.

data/docker-compose.yml

@@ -0,0 +1,77 @@
+services:
+  ruby_app:
+    image: ruby:bullseye
+    working_dir: /usr/src/app
+    volumes:
+      - .:/usr/src/app
+      - bundle:/usr/local/bundle
+    depends_on:
+      - standalone
+    environment:
+      MILVUS_URL: "http://standalone:19530"
+
+  etcd:
+    container_name: milvus-etcd
+    image: quay.io/coreos/etcd:v3.5.5
+    environment:
+      - ETCD_AUTO_COMPACTION_MODE=revision
+      - ETCD_AUTO_COMPACTION_RETENTION=1000
+      - ETCD_QUOTA_BACKEND_BYTES=4294967296
+      - ETCD_SNAPSHOT_COUNT=50000
+    volumes:
+      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/etcd:/etcd
+    command: etcd -advertise-client-urls=http://127.0.0.1:2379 -listen-client-urls http://0.0.0.0:2379 --data-dir /etcd
+    healthcheck:
+      test: ["CMD", "etcdctl", "endpoint", "health"]
+      interval: 30s
+      timeout: 20s
+      retries: 3
+
+  minio:
+    container_name: milvus-minio
+    image: minio/minio:RELEASE.2023-03-20T20-16-18Z
+    environment:
+      MINIO_ACCESS_KEY: minioadmin
+      MINIO_SECRET_KEY: minioadmin
+    ports:
+      - "9001:9001"
+      - "9000:9000"
+    volumes:
+      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/minio:/minio_data
+    command: minio server /minio_data --console-address ":9001"
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
+      interval: 30s
+      timeout: 20s
+      retries: 3
+
+  standalone:
+    container_name: milvus-standalone
+    image: milvusdb/milvus:v2.4.5
+    command: ["milvus", "run", "standalone"]
+    security_opt:
+      - seccomp:unconfined
+    environment:
+      ETCD_ENDPOINTS: etcd:2379
+      MINIO_ADDRESS: minio:9000
+    volumes:
+      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/milvus:/var/lib/milvus
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9091/healthz"]
+      interval: 30s
+      start_period: 90s
+      timeout: 20s
+      retries: 3
+    ports:
+      - "19530:19530"
+      - "9091:9091"
+    depends_on:
+      - "etcd"
+      - "minio"
+
+networks:
+  default:
+    name: milvus
+
+volumes:
+  bundle:

data/lib/milvus/client.rb

@@ -29,6 +29,14 @@ module Milvus
       @indexes ||= Milvus::Indexes.new(client: self)
     end
 
+    def roles
+      @roles ||= Milvus::Roles.new(client: self)
+    end
+
+    def users
+      @users ||= Milvus::Users.new(client: self)
+    end
+
     def connection
       @connection ||= Faraday.new(url: "#{url}/#{API_VERSION}/") do |faraday|
         if api_key

data/lib/milvus/roles.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Milvus
+  class Roles < Base
+    PATH = "roles"
+
+    # Lists available roles on the server
+    #
+    # @return [Hash] The response from the server.
+    def list
+      response = client.connection.post("#{PATH}/list") do |req|
+        req.body = {}
+      end
+
+      response.body
+    end
+
+    # This operation inserts data into a specific collection.
+    #
+    # @param role_name [String] The name of the collection to insert data into.
+    # @return [Hash] The response from the server.
+    def describe(role_name:)
+      response = client.connection.post("#{PATH}/describe") do |req|
+        req.body = {
+          roleName: role_name
+        }
+      end
+
+      response.body
+    end
+  end
+end

data/lib/milvus/users.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Milvus
+  class Users < Base
+    PATH = "users"
+
+    # Create a user
+    #
+    # @param user_name [String] Username for the user
+    # @param password [String] Password for the user
+    # @return [Hash] Server response
+    def create(user_name:, password:)
+      response = client.connection.post("#{PATH}/create") do |req|
+        req.body = {
+          userName: user_name,
+          password: password
+        }
+      end
+
+      response.body
+    end
+
+    # Describe a user
+    #
+    # @param user_name [String] Username for the user
+    # @return [Hash] Server response
+    def describe(user_name:)
+      response = client.connection.post("#{PATH}/describe") do |req|
+        req.body = {
+          userName: user_name
+        }
+      end
+
+      response.body
+    end
+
+    # List users
+    #
+    # @return [Hash] Server response
+    def list
+      response = client.connection.post("#{PATH}/list") do |req|
+        req.body = {}
+      end
+
+      response.body
+    end
+
+    # Drops a user
+    #
+    # @param user_name [String] Username for the user
+    # @return [Hash] Server response
+    def drop(user_name:)
+      response = client.connection.post("#{PATH}/drop") do |req|
+        req.body = {
+          userName: user_name
+        }
+      end
+
+      response.body
+    end
+
+    def update_password(user_name:, password:, new_password:)
+      response = client.connection.post("#{PATH}/update_password") do |req|
+        req.body = {
+          userName: user_name,
+          password: password,
+          newPassword: new_password
+        }
+      end
+
+      response.body
+    end
+
+    def grant_role(user_name:, role_name:)
+      response = client.connection.post("#{PATH}/grant_role") do |req|
+        req.body = {
+          userName: user_name,
+          roleName: role_name
+        }
+      end
+
+      response.body
+    end
+
+    def revoke_role(user_name:, role_name:)
+      response = client.connection.post("#{PATH}/revoke_role") do |req|
+        req.body = {
+          userName: user_name,
+          roleName: role_name
+        }
+      end
+
+      response.body
+    end
+  end
+end

data/lib/milvus/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Milvus
-  VERSION = "0.10.1"
+  VERSION = "0.10.2"
 end

data/lib/milvus.rb

@@ -11,4 +11,6 @@ module Milvus
   autoload :Entities, "milvus/entities"
   autoload :Indexes, "milvus/indexes"
   autoload :Partitions, "milvus/partitions"
+  autoload :Roles, "milvus/roles"
+  autoload :Users, "milvus/users"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: milvus
 version: !ruby/object:Gem::Version
-  version: 0.10.1
+  version: 0.10.2
 platform: ruby
 authors:
 - Andrei Bondarev
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-04 00:00:00.000000000 Z
+date: 2024-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry-byebug
@@ -60,6 +60,7 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- docker-compose.yml
 - lib/milvus.rb
 - lib/milvus/base.rb
 - lib/milvus/client.rb
@@ -69,6 +70,8 @@ files:
 - lib/milvus/error.rb
 - lib/milvus/indexes.rb
 - lib/milvus/partitions.rb
+- lib/milvus/roles.rb
+- lib/milvus/users.rb
 - lib/milvus/version.rb
 - sig/milvus.rbs
 homepage: https://github.com/andreibondarev/milvus