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

Add details for storage and knative services #5605

Merged
merged 3 commits into from
Jul 13, 2023

Conversation

skonto
Copy link
Contributor

@skonto skonto commented Jun 16, 2023

Proposed Changes

  • Adds a section for storage integration with Knative Services. Could be expanded with more examples in the feature.

@netlify
Copy link

netlify bot commented Jun 16, 2023

Deploy Preview for knative ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 2cc7748
🔍 Latest deploy log https://app.netlify.com/sites/knative/deploys/64af9e43a892040008ee8402
😎 Deploy Preview https://deploy-preview-5605--knative.netlify.app/docs/serving/services/storage
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@knative-prow knative-prow bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Jun 16, 2023
Comment on lines 3 to 5
Knative Serving integrates with K8s storage capabilities via supporting a subset of ephemeral storage volumes and via PersistentVolumeClaims(PVCs) volume types.
In detail Knative Serving supports emptyDir by default, secret, configmap, projection and PVCs volume types.
For more details on volume configuration check the related [feature flags](../configuration/feature-flags.md) when applicable.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Knative Serving integrates with K8s storage capabilities via supporting a subset of ephemeral storage volumes and via PersistentVolumeClaims(PVCs) volume types.
In detail Knative Serving supports emptyDir by default, secret, configmap, projection and PVCs volume types.
For more details on volume configuration check the related [feature flags](../configuration/feature-flags.md) when applicable.
By default Serving supports the mounting the [volume types](https://kubernetes.io/docs/concepts/storage/volumes):`emptyDir`, `secret`, `configMap` and `projected`. [PersistentVolumes](https://kubernetes.io/docs/concepts/storage/persistent-volumes/) are supported but require a [feature flag](../configuration/feature-flags.md) to be enabled.

In detail Knative Serving supports emptyDir by default, secret, configmap, projection and PVCs volume types.
For more details on volume configuration check the related [feature flags](../configuration/feature-flags.md) when applicable.

Here is an example of using PVCs:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Here is an example of using PVCs:
Here is an example of using a persistent volume claim with a Knative Service:

Comment on lines 40 to 41
The example assumes that the user has enabled PVC support via the corresponding feature flag.

Copy link
Member

Choose a reason for hiding this comment

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

Can drop this since we mention it above

Suggested change
The example assumes that the user has enabled PVC support via the corresponding feature flag.

Comment on lines 42 to 43
!!! warning
Mounting large volumes may add considerable overhead to the application's start up time.
Copy link
Member

Choose a reason for hiding this comment

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

I'd consider moving this before the example

config/nav.yml Outdated
@@ -131,6 +131,7 @@ nav:
# TODO: Add security section to docs?
- Configure resource requests and limits: serving/services/configure-requests-limits-services.md
- HTTPS redirection: serving/services/http-protocol.md
- Configuring storage: serving/services/storage.md
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- Configuring storage: serving/services/storage.md
- Volume Support: serving/services/storage.md

@knative-prow knative-prow bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jun 28, 2023
@skonto
Copy link
Contributor Author

skonto commented Jun 28, 2023

@dprotaso thanks, comments addressed.

@skonto
Copy link
Contributor Author

skonto commented Jul 3, 2023

@dprotaso gentle ping.

add missing whitespace
Copy link
Member

@ReToCode ReToCode left a comment

Choose a reason for hiding this comment

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

/lgtm
/approve

@knative-prow knative-prow bot added the lgtm Indicates that a PR is ready to be merged. label Jul 13, 2023
@knative-prow
Copy link

knative-prow bot commented Jul 13, 2023

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: ReToCode, skonto

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

@knative-prow knative-prow bot merged commit d60f9ca into knative:main Jul 13, 2023
16 checks passed
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. lgtm Indicates that a PR is ready to be merged. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants