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

storage: CSI inline volumes in beta #15705

Merged

Conversation

pohly
Copy link
Contributor

@pohly pohly commented Aug 6, 2019

Kubernetes 1.16 graduates this feature to beta.

Related-to: #14704,
kubernetes/enhancements#596

@k8s-ci-robot k8s-ci-robot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Aug 6, 2019
@pohly
Copy link
Contributor Author

pohly commented Aug 6, 2019

/hold

The feature has not been promoted to beta yet.

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Aug 6, 2019
@k8s-ci-robot k8s-ci-robot added language/en Issues or PRs related to English language sig/docs Categorizes an issue or PR as relevant to SIG Docs. labels Aug 6, 2019
@netlify
Copy link

netlify bot commented Aug 6, 2019

Deploy preview for kubernetes-io-master-staging ready!

Built with commit 23be7aa

https://deploy-preview-15705--kubernetes-io-master-staging.netlify.com

@zacharysarah
Copy link
Contributor

@pohly 👋 Please change the base from master to dev-1.16.

/milestone 1.16

@k8s-ci-robot k8s-ci-robot added this to the 1.16 milestone Aug 7, 2019
@pohly pohly changed the base branch from master to dev-1.16 August 29, 2019 18:17
@msau42
Copy link
Member

msau42 commented Aug 29, 2019

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 29, 2019
@pohly pohly changed the title WIP: storage: CSI inline volumes in beta storage: CSI inline volumes in beta Aug 29, 2019
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Aug 29, 2019
@pohly
Copy link
Contributor Author

pohly commented Aug 29, 2019

/hold cancel

kubernetes/kubernetes#82004 has been merged.

I also changed the base to dev-1.16. Do I also have to change master?

@k8s-ci-robot k8s-ci-robot removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Aug 29, 2019
@msau42
Copy link
Member

msau42 commented Aug 29, 2019

You should not need to update master

@@ -1342,7 +1343,9 @@ spec:
foo: bar
```

This feature requires CSIInlineVolume feature gate to be enabled:
This feature requires CSIInlineVolume feature gate to be enabled. It
is enabled by default in Kubernetes >= 1.16. In Kubernetes v1.15, it
Copy link
Contributor

Choose a reason for hiding this comment

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

@pohly , is line 1346 required, as the default is enabled for v1.16?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Personally I prefer to keep the information about older releases if it doesn't get too long, because then users don't need to run a mental diff against older documentation to figure out the history. Some people have to work with more than just one release of Kubernetes, so that history is relevant.

That this feature gate exists is also relevant, regardless of the history and whether its enabled or disabled by default.

Copy link
Contributor

Choose a reason for hiding this comment

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

@pohly I agree with @kbhawkey on this. Saying "It
is enabled by default in Kubernetes >= 1.16" already explains it is not enabled by default in previous releases.

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 assume future releases of the documentation will still have that paragraph. With that in mind I changed the second sentence to "It is enabled by default starting with Kubernetes 1.16.".

The alternative, "It is enabled by default in Kubernetes 1.16", would look weird in documentation for Kubernetes 1.17...

Copy link
Contributor

Choose a reason for hiding this comment

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

@pohly Thanks for jumping on this. Looks like the change you mentioned It is enabled by default starting with Kubernetes 1.16 is not yet in the doc.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Oh, sorry, forgot the final git push. It's there now.

@@ -1316,6 +1316,7 @@ Learn how to
#### CSI ephemeral volumes

{{< feature-state for_k8s_version="v1.15" state="alpha" >}}
{{< feature-state for_k8s_version="v1.16" state="beta" >}}
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: You could remove line 1318 as the feature is now beta.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Same here: I find history important.

Copy link
Contributor

Choose a reason for hiding this comment

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

@pohly They can always reference command-line-tools-reference/feature-gates.md for 1.15 state.

Copy link
Contributor

Choose a reason for hiding this comment

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

hello @pohly. The best place to record the state and history of a feature/feature gate is the feature gates reference page. If needed, you could link to the reference page. I think the feature-state shortcode is typically used to label the current state of the feature.

Copy link
Member

Choose a reason for hiding this comment

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

The k8s.io site has a toggle for release (or 1.14, 1.15, etc) right?

Copy link
Contributor

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

@pohly pohly Sep 9, 2019

Choose a reason for hiding this comment

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

I removed the line for alpha in 1.15.

@simplytunde
Copy link
Contributor

/lgtm

@simplytunde
Copy link
Contributor

Once the 2 issues raised have been addressed, this can be merged.

@simplytunde
Copy link
Contributor

@pohly This PR is deadline for merging is Sep 9.

As pointed out during review, this information is better captured in
the feature gates reference page.
@pohly
Copy link
Contributor Author

pohly commented Sep 9, 2019

@simplytunde: please have another look, I updated the PR.

@k8s-ci-robot k8s-ci-robot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Sep 9, 2019
@k8sio-netlify-preview-bot
Copy link
Collaborator

Deploy preview for kubernetes-io-vnext-staging processing.

Building with commit 5db933e

https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/5d765fe7859f1e0008e8aa37

@k8s-ci-robot k8s-ci-robot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Sep 9, 2019
@simplytunde
Copy link
Contributor

Awesome @pohly . Thanks for all your work.
/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Sep 9, 2019
@simplytunde
Copy link
Contributor

/approve

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: simplytunde

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

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Sep 9, 2019
@k8s-ci-robot k8s-ci-robot merged commit 5b2906c into kubernetes:dev-1.16 Sep 9, 2019
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. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants