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

✨ 📖 tmc: storage docs and apis #1971

Merged
merged 3 commits into from
Oct 10, 2022

Conversation

guymguym
Copy link
Contributor

Signed-off-by: Guy Margalit guymguym@gmail.com

Summary

This is the first story of the storage epic - kcp-dev/contrib-tmc#112

Related issue(s)

@openshift-ci openshift-ci bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. kind/api-change Categorizes issue or PR as related to adding, removing, or otherwise changing an API needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Sep 14, 2022
@openshift-ci
Copy link
Contributor

openshift-ci bot commented Sep 14, 2022

Hi @guymguym. Thanks for your PR.

I'm waiting for a kcp-dev member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@ncdc
Copy link
Member

ncdc commented Sep 14, 2022

/ok-to-test

@openshift-ci openshift-ci bot added ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Sep 14, 2022
@cooktheryan
Copy link

@guymguym just bumping this with Andy's suggestions

docs/storage.md Outdated Show resolved Hide resolved
docs/storage.md Outdated Show resolved Hide resolved
docs/storage.md Outdated Show resolved Hide resolved
@davidfestal davidfestal marked this pull request as ready for review October 3, 2022 09:35
@openshift-ci openshift-ci bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 3, 2022
@davidfestal
Copy link
Member

/lgtm

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Oct 3, 2022
@guymguym
Copy link
Contributor Author

guymguym commented Oct 3, 2022

/hold

@openshift-ci openshift-ci bot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Oct 3, 2022
@openshift-ci openshift-ci bot removed the lgtm Indicates that a PR is ready to be merged. label Oct 5, 2022
@guymguym guymguym force-pushed the guy-storage-docs branch 3 times, most recently from d1a3755 to b1994d3 Compare October 5, 2022 10:29
@guymguym
Copy link
Contributor Author

guymguym commented Oct 5, 2022

/unhold

@openshift-ci openshift-ci bot removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Oct 5, 2022
@guymguym
Copy link
Contributor Author

guymguym commented Oct 5, 2022

Hey @davidfestal @sttts @ncdc
I would be happy if you could review and let me know how is this level of detail, and I will fix.
Thanks

.gitignore Outdated Show resolved Hide resolved
docs/locations-and-scheduling.md Outdated Show resolved Hide resolved
This is the case with storage PVs, which are created on the workload cluster by a CSI driver.

Unlike the `Sync` state, the `Upsync` state is exclusive, and only a single cluster can be upsyncing a resource to KCP.
In addition, other clusters cannot be syncing down while the resource is upsyncing.
Copy link
Member

Choose a reason for hiding this comment

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

What is "clusters" here? Workspace?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ok I see the confusion, perhaps in this context it would be better to say "syncers"?

Copy link
Member

Choose a reason for hiding this comment

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

Yes, that's why I was asking - confusion 😄

Copy link
Contributor Author

Choose a reason for hiding this comment

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

does "syncers" help?

Copy link
Member

Choose a reason for hiding this comment

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

Yes

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hey @ncdc I reviewed today with @davidfestal and I think we resolved the confusion around my free use for the term "cluster".

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I changed many occurences to SyncTarget and some others to pcluster. I hope that pcluster is a good term to represent the infrastructure aspects of the downstream cluster.

@guymguym guymguym force-pushed the guy-storage-docs branch 3 times, most recently from 59b5e43 to 4c979fb Compare October 6, 2022 18:17
Signed-off-by: Guy Margalit <guymguym@gmail.com>
Signed-off-by: Guy Margalit <guymguym@gmail.com>
Signed-off-by: Guy Margalit <guymguym@gmail.com>
@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Oct 10, 2022
@davidfestal
Copy link
Member

/approve

@davidfestal davidfestal assigned ncdc and sttts and unassigned davidfestal Oct 10, 2022
@sttts
Copy link
Member

sttts commented Oct 10, 2022

/approve

@davidfestal davidfestal added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Oct 10, 2022
@openshift-ci
Copy link
Contributor

openshift-ci bot commented Oct 10, 2022

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: davidfestal, sttts

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-merge-robot openshift-merge-robot merged commit 525b295 into kcp-dev:main Oct 10, 2022
@kcp-ci-bot kcp-ci-bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Nov 23, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. kind/api-change Categorizes issue or PR as related to adding, removing, or otherwise changing an API lgtm Indicates that a PR is ready to be merged. ok-to-test Indicates a non-member PR verified by an org member that is safe to test. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Storage - Define and document the new APIs - PVC, PV, labels, annotations, etc.
7 participants