Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Vald architecture document #366

Merged
merged 37 commits into from
May 28, 2020
Merged

Vald architecture document #366

merged 37 commits into from
May 28, 2020

Conversation

kevindiu
Copy link
Contributor

@kevindiu kevindiu commented May 7, 2020

#106 # Description:
This PR create a Vald Architecture document including the summary of each components in Vald and the data flow explanation.

Remaining task:

  • Update and Delete flow (another PR)
  • Fix image design

Related Issue:

How Has This Been Tested?:

Environment:

  • Golang Version: 1.14
  • Docker Version: 19.03.5
  • Kubernetes Version: 1.17.3
  • NGT Version: 1.9.1

Types of changes:

  • Bug fix [type/bug]
  • New feature [type/feature]
  • Add tests [type/test]
  • Security related changes [type/security]
  • Add documents [type/documentation]
  • Refactoring [type/refactoring]
  • Update dependencies [type/dependency]
  • Update benchmarks and performances [type/bench]
  • Update CI [type/ci]

Changes to Core Features:

  • Have you added an explanation of what your changes do and why you'd like us to include them?
  • Have you written new tests for your core changes, as applicable?
  • Have you successfully ran tests with your changes locally?

Checklist:

  • I have read the CONTRIBUTING document.
  • I have checked open Pull Requests for the similar feature or fixes?
  • I have added tests and benchmarks to cover my changes.
  • I have ensured all new and existing tests passed.
  • I have commented my code, particularly in hard-to-understand areas
  • I have updated the documentation accordingly.

@pull-assistant
Copy link

pull-assistant bot commented May 7, 2020

Score: 0.97

Best reviewed: commit by commit


Optimal code review plan (15 warnings, 3 commits squashed)

add architecture overview draft

docs/user/architecture.md 56% changes removed in add vector data spac...

fix

README.md 50% changes removed in Update doc path

update architecture doc

docs/user/architecture.md 59% changes removed in Apply suggestions fr...

     fix

update Vald Meta section

docs/user/architecture.md 59% changes removed in add vector data spac...

fix Vald backup

docs/user/architecture.md 64% changes removed in Apply suggestions fr...

fix grammar

docs/user/architecture.md 80% changes removed in draft data flow sect...

fix arch doc: vald agent section

docs/user/architecture.md 56% changes removed in Apply suggestions fr...

fix

docs/user/architecture.md 62% changes removed in Apply suggestions fr...

     fix Vald filter section

draft data flow section

docs/user/architecture.md 64% changes removed in explain more detail ...

edit search flow

docs/user/architecture.md 94% changes removed in separate insert and ...

add vector data space explaination

docs/user/architecture.md 42% changes removed in Apply suggestions fr...

Apply suggestions from code review

docs/user/architecture.md 57% changes removed in Apply suggestions fr...

move assets to assets/doc folder

docs/user/architecture.md 67% changes removed in change docs and imag...

     Apply suggestions from code review

     update vector data space explaination diagram

separate insert and search flow diagram

docs/user/architecture.md 88% changes removed in fix

     fix image

     fix image

     update vector data space diagram( Tree -> Index

     change docs and images path

     Update doc path

     🤖 Update license headers and formatting go codes

     Apply suggestions from code review

     Apply suggestions from code review

     Revert ":robot: Update license headers and formatting go codes"

     Apply suggestions from code review

explain more detail ... ... fix

Squashed 3 commits:

docs/overview/architecture.md 52% changes removed in update searching flo...

     update searching flow

     Apply suggestions from code review

     Revert ":robot: Update license headers and formatting go codes"

     Update docs/overview/architecture.md

     Merge branch 'master' into documentation/architecture_doc

     🤖 Automatically add contributor

Powered by Pull Assistant. Last update 41271d3 ... a3f34df. Read the comment docs.

@kpango kpango changed the title [Drafe] Vald architecture document [Draft] Vald architecture document May 8, 2020
docs/user/architecture.md Outdated Show resolved Hide resolved
@vankichi
Copy link
Contributor

/rebase

@vdaas-ci
Copy link
Collaborator

[REBASE] Rebase triggered by vankichi for branch: documentation/architecture_doc

@vdaas-ci vdaas-ci force-pushed the documentation/architecture_doc branch from 9a2f787 to 4b370f0 Compare May 12, 2020 02:21
@hlts2
Copy link
Collaborator

hlts2 commented May 12, 2020

LGTM

docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
Copy link
Contributor

@vankichi vankichi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@kevindiu I left some comments.
I think it is better each sentence written each row.
It helps to protect against unwanted changes.

docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
docs/user/architecture.md Outdated Show resolved Hide resolved
@vankichi
Copy link
Contributor

/rebase
/format

@vdaas-ci
Copy link
Collaborator

[REBASE] Rebase triggered by vankichi for branch: documentation/architecture_doc

@vdaas-ci vdaas-ci force-pushed the documentation/architecture_doc branch from 8946862 to 44299d4 Compare May 13, 2020 05:08
@vdaas-ci
Copy link
Collaborator

[FORMAT] Updating license headers and formatting go codes triggered by vankichi.

@kevindiu kevindiu force-pushed the documentation/architecture_doc branch from f71fb0c to d2a82c5 Compare May 13, 2020 08:26
@vankichi vankichi changed the title [Draft] Vald architecture document Vald architecture document May 14, 2020
@vankichi vankichi marked this pull request as ready for review May 14, 2020 01:07
@vankichi
Copy link
Contributor

@kpango @kmrmt @rinx
When you have time, could you please review Architecture Document?

@vankichi
Copy link
Contributor

/rebase

@vdaas-ci
Copy link
Collaborator

[REBASE] Rebase triggered by vankichi for branch: documentation/architecture_doc

@vdaas-ci vdaas-ci force-pushed the documentation/architecture_doc branch from bd7dd95 to bb3a5b1 Compare May 14, 2020 01:34
@kpango
Copy link
Collaborator

kpango commented May 14, 2020

/rebase
/format

@vdaas-ci
Copy link
Collaborator

[REBASE] Rebase triggered by kpango for branch: documentation/architecture_doc

@kevindiu
Copy link
Contributor Author

/rebase

@vdaas-ci
Copy link
Collaborator

[REBASE] Rebase triggered by kevindiu for branch: documentation/architecture_doc

@kevindiu
Copy link
Contributor Author

/rebase

@vdaas-ci
Copy link
Collaborator

[REBASE] Rebase triggered by kevindiu for branch: documentation/architecture_doc

1. Generate the corresponding UUID for internal use.
1. Forward the vector ID and UUID request to the Vald Meta.
1. Forward the vector information (vector ID, vector, and UUID) to Vald Backup Gateway.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why are all numbers 1?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is github markdown coding style.

  1. a
  2. b
  3. c

vankichi
vankichi previously approved these changes May 26, 2020
@vankichi
Copy link
Contributor

@kpango Could you review again about "Insert Data Flow" and "Search Data Flow" when you are free?

kmrmt
kmrmt previously approved these changes May 28, 2020
Copy link
Contributor

@kmrmt kmrmt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@kpango kpango dismissed stale reviews from kmrmt and vankichi via 7b65940 May 28, 2020 02:36
@kpango
Copy link
Collaborator

kpango commented May 28, 2020

/rebase
/format
/approve

@vdaas-ci
Copy link
Collaborator

[REBASE] Rebase triggered by kpango for branch: documentation/architecture_doc

@vdaas-ci
Copy link
Collaborator

[REBASE] Failed to rebase.

@rinx
Copy link
Contributor

rinx commented May 28, 2020

/add-contributors

@vdaas-ci
Copy link
Collaborator

[ADD CONTRIBUTORS] Add contributor kevindiu to CONTRIBUTORS triggered by rinx.

@kpango
Copy link
Collaborator

kpango commented May 28, 2020

/rebase
/format
/approve

@vdaas-ci
Copy link
Collaborator

[REBASE] Rebase triggered by kpango for branch: documentation/architecture_doc

@vdaas-ci
Copy link
Collaborator

[REBASE] Failed to rebase.

@kpango
Copy link
Collaborator

kpango commented May 28, 2020

/format
/approve

@vdaas-ci
Copy link
Collaborator

[FORMAT] Updating license headers and formatting go codes triggered by kpango.

@vdaas-ci
Copy link
Collaborator

[FORMAT] Failed to format.

@kpango
Copy link
Collaborator

kpango commented May 28, 2020

/approve

Copy link
Collaborator

@vdaas-ci vdaas-ci left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[APPROVED] This PR is approved by kpango.

@kpango kpango merged commit 12b26e2 into master May 28, 2020
@kpango kpango deleted the documentation/architecture_doc branch May 28, 2020 02:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants