Merge pull request #826 from vmware-tanzu/simplify_readme
Simplify the main README.md to reduce duplication with website
This commit is contained in:
commit
4eb500cc41
@ -10,15 +10,28 @@ Please see the [Code of Conduct](./CODE_OF_CONDUCT.md).
|
|||||||
|
|
||||||
See [SCOPE.md](./SCOPE.md) for some guidelines about what we consider in and out of scope for Pinniped.
|
See [SCOPE.md](./SCOPE.md) for some guidelines about what we consider in and out of scope for Pinniped.
|
||||||
|
|
||||||
|
## Roadmap
|
||||||
|
|
||||||
|
The near-term and mid-term roadmap for the work planned for the project [maintainers](MAINTAINERS.md) is documented in [ROADMAP.md](ROADMAP.md).
|
||||||
|
|
||||||
## Community Meetings
|
## Community Meetings
|
||||||
|
|
||||||
Pinniped is better because of our contributors and maintainers. It is because of you that we can bring great software to the community. Please join us during our online community meetings, occuring every first and third Thursday of the month at 9AM PT / 12PM ET. Use [this Zoom Link](https://vmware.zoom.us/j/93798188973?pwd=T3pIMWxReEQvcWljNm1admRoZTFSZz09) to attend and add any agenda items you wish to discuss to [the notes document](https://hackmd.io/rd_kVJhjQfOvfAWzK8A3tQ?view). Join our [Google Group](https://groups.google.com/u/1/g/project-pinniped) to receive invites to this meeting.
|
Pinniped is better because of our contributors and [maintainers](MAINTAINERS.md). It is because of you that we can bring great
|
||||||
|
software to the community. Please join us during our online community meetings,
|
||||||
|
occurring every first and third Thursday of the month at 9 AM PT / 12 PM PT.
|
||||||
|
Use [this Zoom Link](https://vmware.zoom.us/j/93798188973?pwd=T3pIMWxReEQvcWljNm1admRoZTFSZz09)
|
||||||
|
to attend and add any agenda items you wish to discuss
|
||||||
|
to [the notes document](https://hackmd.io/rd_kVJhjQfOvfAWzK8A3tQ?view).
|
||||||
|
Join our [Google Group](https://groups.google.com/g/project-pinniped) to receive invites to this meeting.
|
||||||
|
|
||||||
If the meeting day falls on a US holiday, please consider that occurrence of the meeting to be canceled.
|
If the meeting day falls on a US holiday, please consider that occurrence of the meeting to be canceled.
|
||||||
|
|
||||||
## Discussion
|
## Discussion
|
||||||
|
|
||||||
Got a question, comment, or idea? Please don't hesitate to reach out via the GitHub [Discussions](https://github.com/vmware-tanzu/pinniped/discussions) tab at the top of this page or reach out in Kubernetes Slack Workspace within the [#pinniped channel](https://kubernetes.slack.com/archives/C01BW364RJA).
|
Got a question, comment, or idea? Please don't hesitate to reach out
|
||||||
|
via GitHub [Discussions](https://github.com/vmware-tanzu/pinniped/discussions),
|
||||||
|
GitHub [Issues](https://github.com/vmware-tanzu/pinniped/issues),
|
||||||
|
or in the Kubernetes Slack Workspace within the [#pinniped channel](https://kubernetes.slack.com/archives/C01BW364RJA).
|
||||||
|
|
||||||
## Issues
|
## Issues
|
||||||
|
|
||||||
@ -45,7 +58,7 @@ guidelines in the issue and pull request templates.
|
|||||||
To suggest a feature, please first open an
|
To suggest a feature, please first open an
|
||||||
[issue](https://github.com/vmware-tanzu/pinniped/issues/new?template=feature-proposal.md)
|
[issue](https://github.com/vmware-tanzu/pinniped/issues/new?template=feature-proposal.md)
|
||||||
and tag it with `proposal`, or create a new [Discussion](https://github.com/vmware-tanzu/pinniped/discussions).
|
and tag it with `proposal`, or create a new [Discussion](https://github.com/vmware-tanzu/pinniped/discussions).
|
||||||
The project team will work with you on your feature request.
|
The project [maintainers](MAINTAINERS.md) will work with you on your feature request.
|
||||||
|
|
||||||
Once the feature request has been validated, a [pull request](https://github.com/vmware-tanzu/pinniped/compare)
|
Once the feature request has been validated, a [pull request](https://github.com/vmware-tanzu/pinniped/compare)
|
||||||
can be opened to implement the feature.
|
can be opened to implement the feature.
|
||||||
@ -53,6 +66,10 @@ can be opened to implement the feature.
|
|||||||
For specifics on what to include in your feature request, please follow the
|
For specifics on what to include in your feature request, please follow the
|
||||||
guidelines in the issue and pull request templates.
|
guidelines in the issue and pull request templates.
|
||||||
|
|
||||||
|
### Reporting security vulnerabilities
|
||||||
|
|
||||||
|
Please follow the procedure described in [SECURITY.md](SECURITY.md).
|
||||||
|
|
||||||
## CLA
|
## CLA
|
||||||
|
|
||||||
We welcome contributions from everyone but we can only accept them if you sign
|
We welcome contributions from everyone but we can only accept them if you sign
|
||||||
|
76
README.md
76
README.md
@ -1,63 +1,51 @@
|
|||||||
|
<a href="https://pinniped.dev" target="_blank">
|
||||||
<img src="site/content/docs/img/pinniped_logo.svg" alt="Pinniped Logo" width="100%"/>
|
<img src="site/content/docs/img/pinniped_logo.svg" alt="Pinniped Logo" width="100%"/>
|
||||||
|
</a>
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
Pinniped provides identity services to Kubernetes.
|
Pinniped provides identity services to Kubernetes.
|
||||||
|
|
||||||
Pinniped allows cluster administrators to easily plug in external identity
|
- Easily plug in external identity providers into Kubernetes clusters while offering a simple install and configuration experience. Leverage first class integration with Kubernetes and kubectl command-line.
|
||||||
providers (IDPs) into Kubernetes clusters. This is achieved via a uniform
|
- Give users a consistent, unified login experience across all your clusters, including on-premises and managed cloud environments.
|
||||||
install procedure across all types and origins of Kubernetes clusters,
|
- Securely integrate with an enterprise IDP using standard protocols or use secure, externally managed identities instead of relying on simple, shared credentials.
|
||||||
declarative configuration via Kubernetes APIs, enterprise-grade integrations
|
|
||||||
with IDPs, and distribution-specific integration strategies.
|
|
||||||
|
|
||||||
### Example use cases
|
To learn more, please visit the Pinniped project's website, https://pinniped.dev.
|
||||||
|
|
||||||
* Your team uses a large enterprise IDP, and has many clusters that they
|
|
||||||
manage. Pinniped provides:
|
|
||||||
* Seamless and robust integration with the IDP
|
|
||||||
* Easy installation across clusters of any type and origin
|
|
||||||
* A simplified login flow across all clusters
|
|
||||||
* Your team shares a single cluster. Pinniped provides:
|
|
||||||
* Simple configuration to integrate an IDP
|
|
||||||
* Individual, revocable identities
|
|
||||||
|
|
||||||
### Architecture
|
|
||||||
|
|
||||||
The Pinniped Supervisor component offers identity federation to enable a user to
|
|
||||||
access multiple clusters with a single daily login to their external IDP. The
|
|
||||||
Pinniped Supervisor supports various external [IDP
|
|
||||||
types](https://github.com/vmware-tanzu/pinniped/tree/main/generated/1.20#k8s-api-idp-supervisor-pinniped-dev-v1alpha1).
|
|
||||||
|
|
||||||
The Pinniped Concierge component offers credential exchange to enable a user to
|
|
||||||
exchange an external credential for a short-lived, cluster-specific
|
|
||||||
credential. Pinniped supports various [authentication
|
|
||||||
methods](https://github.com/vmware-tanzu/pinniped/tree/main/generated/1.20#authenticationconciergepinnipeddevv1alpha1)
|
|
||||||
and implements different integration strategies for various Kubernetes
|
|
||||||
distributions to make authentication possible.
|
|
||||||
|
|
||||||
The Pinniped Concierge can be configured to hook into the Pinniped Supervisor's
|
|
||||||
federated credentials, or it can authenticate users directly via external IDP
|
|
||||||
credentials.
|
|
||||||
|
|
||||||
To learn more, see [architecture](https://pinniped.dev/docs/background/architecture/).
|
|
||||||
|
|
||||||
## Getting started with Pinniped
|
## Getting started with Pinniped
|
||||||
|
|
||||||
Care to kick the tires? It's easy to [install and try Pinniped](https://pinniped.dev/docs/).
|
Care to kick the tires? It's easy to [install and try Pinniped](https://pinniped.dev/docs/).
|
||||||
|
|
||||||
## Community meetings
|
|
||||||
|
|
||||||
Pinniped is better because of our contributors and maintainers. It is because of you that we can bring great software to the community. Please join us during our online community meetings, occurring every first and third Thursday of the month at 9 AM PT / 12 PM PT. Use [this Zoom Link](https://vmware.zoom.us/j/93798188973?pwd=T3pIMWxReEQvcWljNm1admRoZTFSZz09) to attend and add any agenda items you wish to discuss to [the notes document](https://hackmd.io/rd_kVJhjQfOvfAWzK8A3tQ?view). Join our [Google Group](https://groups.google.com/g/project-pinniped) to receive invites to this meeting.
|
|
||||||
|
|
||||||
If the meeting day falls on a US holiday, please consider that occurrence of the meeting to be canceled.
|
|
||||||
|
|
||||||
## Discussion
|
## Discussion
|
||||||
|
|
||||||
Got a question, comment, or idea? Please don't hesitate to reach out via the GitHub [Discussions](https://github.com/vmware-tanzu/pinniped/discussions) tab at the top of this page or reach out in Kubernetes Slack Workspace within the [#pinniped channel](https://kubernetes.slack.com/archives/C01BW364RJA).
|
Got a question, comment, or idea? Please don't hesitate to reach out
|
||||||
|
via GitHub [Discussions](https://github.com/vmware-tanzu/pinniped/discussions),
|
||||||
|
GitHub [Issues](https://github.com/vmware-tanzu/pinniped/issues),
|
||||||
|
or in the Kubernetes Slack Workspace within the [#pinniped channel](https://kubernetes.slack.com/archives/C01BW364RJA).
|
||||||
|
|
||||||
## Contributions
|
## Contributions
|
||||||
|
|
||||||
Contributions are welcome. Before contributing, please see the [contributing guide](CONTRIBUTING.md).
|
Want to get involved? Contributions are welcome.
|
||||||
|
|
||||||
|
Please see the [contributing guide](CONTRIBUTING.md) for more information about reporting bugs, requesting features,
|
||||||
|
building and testing the code, submitting PRs, and other contributor topics.
|
||||||
|
|
||||||
|
## Community meetings
|
||||||
|
|
||||||
|
Pinniped is better because of our contributors and [maintainers](MAINTAINERS.md). It is because of you that we can bring great
|
||||||
|
software to the community. Please join us during our online community meetings,
|
||||||
|
occurring every first and third Thursday of the month at 9 AM PT / 12 PM PT.
|
||||||
|
Use [this Zoom Link](https://vmware.zoom.us/j/93798188973?pwd=T3pIMWxReEQvcWljNm1admRoZTFSZz09)
|
||||||
|
to attend and add any agenda items you wish to discuss
|
||||||
|
to [the notes document](https://hackmd.io/rd_kVJhjQfOvfAWzK8A3tQ?view).
|
||||||
|
Join our [Google Group](https://groups.google.com/g/project-pinniped) to receive invites to this meeting.
|
||||||
|
|
||||||
|
If the meeting day falls on a US holiday, please consider that occurrence of the meeting to be canceled.
|
||||||
|
|
||||||
|
## Adopters
|
||||||
|
|
||||||
|
Some organizations and products using Pinniped are featured in [ADOPTERS.md](ADOPTERS.md).
|
||||||
|
Add your own organization or product [here](https://github.com/vmware-tanzu/pinniped/discussions/152).
|
||||||
|
|
||||||
## Reporting security vulnerabilities
|
## Reporting security vulnerabilities
|
||||||
|
|
||||||
@ -67,4 +55,4 @@ Please follow the procedure described in [SECURITY.md](SECURITY.md).
|
|||||||
|
|
||||||
Pinniped is open source and licensed under Apache License Version 2.0. See [LICENSE](LICENSE).
|
Pinniped is open source and licensed under Apache License Version 2.0. See [LICENSE](LICENSE).
|
||||||
|
|
||||||
Copyright 2020 the Pinniped contributors. All Rights Reserved.
|
Copyright 2020-2021 the Pinniped contributors. All Rights Reserved.
|
||||||
|
Loading…
Reference in New Issue
Block a user