kubernetes-sigs/kustomize
1
0
Fork 0
mirror of https://github.com/kubernetes-sigs/kustomize.git synced 2026-06-12 01:14:22 +00:00
Code Issues Packages Projects Releases 1 Wiki Activity

Update ptrs to DAM doc.

Browse Source
This commit is contained in:
Jeffrey Regan
2018-10-10 15:54:37 -07:00
parent 9897ce8bf2
commit 3fe047f79c
2 changed files with 19 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
docs/eschewedFeatures.md
View File

@@ -1,5 +1,9 @@
# Eschewed Features # Eschewed Features
For a bigger picture about why kustomize
does some things and not others, see the
glossary entry for [DAM].
## Removal directives ## Removal directives
`kustomize` supports configurations that can be reasoned about as `kustomize` supports configurations that can be reasoned about as
@@ -74,6 +78,7 @@ In this way the resources, patches and bases used at _build time_
remain explicitly declared in version control. remain explicitly declared in version control.
[DAM]: glossary.md#declarative-application-management
[base]: glossary.md#base [base]: glossary.md#base
[kustomization]: glossary.md#kustomization [kustomization]: glossary.md#kustomization
[OTS workflow]: workflows.md#off-the-shelf-configuration [OTS workflow]: workflows.md#off-the-shelf-configuration

25
docs/glossary.md
View File

@@ -1,6 +1,7 @@
# Glossary # Glossary
[DAM]: #declarative-application-management [DAM]: #declarative-application-management
[Declarative Application Management]: https://github.com/kubernetes/community/blob/master/contributors/design-proposals/architecture/declarative-application-management.md
[JSON]: https://www.json.org/ [JSON]: https://www.json.org/
[JSONPatch]: https://tools.ietf.org/html/rfc6902 [JSONPatch]: https://tools.ietf.org/html/rfc6902
[Resource]: #resource [Resource]: #resource
@@ -98,20 +99,22 @@ periodically capturing someone else's upgrades to the
## declarative application management ## declarative application management
_Declarative Application Management_ (DAM) is a [set of Kustomize aspires to support [Declarative Application Management],
ideas](https://goo.gl/T66ZcD) aiming to ease management a set of best practices around managing k8s clusters.
of k8s clusters.
* Works with any configuration, be it bespoke, In brief, kustomize should
* Work with any configuration, be it bespoke,
off-the-shelf, stateless, stateful, etc. off-the-shelf, stateless, stateful, etc.
* Supports common customizations, and creation of * Support common customizations, and creation of
[variants] (dev vs. staging vs. production). [variants] (e.g. _development_ vs.
* Exposes and teaches native k8s APIs, rather than _staging_ vs. _production_).
hiding them. * Expose and teach native k8s APIs, rather than
* No friction integration with version control to hide them.
* Add no friction to version control integration to
support reviews and audit trails. support reviews and audit trails.
* Composable with other tools in a unix sense. * Compose with other tools in a unix sense.
* Eschews crossing the line into templating, domain * Eschew crossing the line into templating, domain
specific languages, etc., frustrating the other specific languages, etc., frustrating the other
goals. goals.