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

docs: add overview and migrate existing to github #1805

Open
wants to merge 3 commits into
base: develop
Choose a base branch
from

Conversation

tiagolobocastro
Copy link
Contributor

@tiagolobocastro tiagolobocastro commented Jan 22, 2025

feat: parse human size for malloc and null bdevs

Parse a size with unit post-fix for the malloc and null bdevs.
This makes it much easier to use, example:
size=1TiB vs size_mb=1048576

Signed-off-by: Tiago Castro <[email protected]>

docs: move older design docs into the git repo

Signed-off-by: Tiago Castro <[email protected]>

docs: add overview for arch and improve csi

Adds an overview png for the README
Improves slight CSI wording and adds a CSI diagram

Signed-off-by: Tiago Castro <[email protected]>

README.md Outdated Show resolved Hide resolved
Copy link
Contributor

Choose a reason for hiding this comment

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

Shall we be showing linkages for control-plane agents and csi-node plugin? The ha-node-agent to csi-node one for example.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Wanted this to be csi only, will add more complete diagram on another section later on

PublicApi --> Rest
Rest --> |gRPC| InternalApi
InternalApi --> |gRPC| InternalServices
Node_1 <--> PublicApi
Copy link
Contributor

Choose a reason for hiding this comment

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

What does this csi-node to REST public API link represent? Where do we do that?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It represents exactly that, we've had to do that to for one of the latest fixes on v2.7.2 unfortunately as the CSI volume context becomes stale and it's immutable so we can't modify it.

doc/img/overview.drawio.png Outdated Show resolved Hide resolved
doc/design/control-plane-behaviour.md Outdated Show resolved Hide resolved
doc/design/control-plane-behaviour.md Outdated Show resolved Hide resolved
doc/design/control-plane-behaviour.md Outdated Show resolved Hide resolved
doc/design/control-plane-behaviour.md Outdated Show resolved Hide resolved
doc/design/control-plane-behaviour.md Outdated Show resolved Hide resolved
doc/design/k8s/kubectl-plugin.md Outdated Show resolved Hide resolved
doc/design/k8s/kubectl-plugin.md Outdated Show resolved Hide resolved
doc/design/k8s/kubectl-plugin.md Outdated Show resolved Hide resolved
doc/design/k8s/kubectl-plugin.md Outdated Show resolved Hide resolved
doc/design/k8s/kubectl-plugin.md Outdated Show resolved Hide resolved
Parse a size with unit post-fix for the malloc and null bdevs.
This makes it much easier to use, example:
size=1TiB vs size_mb=1048576

Signed-off-by: Tiago Castro <[email protected]>
Adds an overview png for the README
Improves slight CSI wording and adds a CSI diagram

Signed-off-by: Tiago Castro <[email protected]>
@tiagolobocastro tiagolobocastro force-pushed the docs branch 7 times, most recently from 30f791b to 77a7e88 Compare January 27, 2025 13:49
@tiagolobocastro
Copy link
Contributor Author

Could not get the images to display within the mermaid graph sadly :(

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants