github.com/wmuizelaar/kpt@v0.0.0-20221018115725-bd564717b2ed/site/book/07-effective-customizations/00.md (about)

     1  Kubernetes configuration packages and customizations go hand in hand, all the 
     2  packaging tools enable package customization, since every package needs to be adapted to each specific use. In this chapter we cover effective 
     3  customizations techniques that kpt rendering and packaging enables.  We show how
     4  providing customization through parameters has some [pitfalls] and recommend
     5  alternatives where the contents of the package are not hidden behind a facade.
     6  Some of these alternatives are only possible because kpt has made an investment 
     7  into bulk editing with [KRM functions] and upstream merging. 
     8  
     9  ### Prerequisites
    10  
    11  Before reading this chapter you should familiarize yourself with [chapter 4]
    12  which talks about using functions as well as [updating a package page] in 
    13  [chapter 3].
    14  
    15  [chapter 4]: /book/04-using-functions/
    16  [chapter 3]: /book/03-packages/
    17  [pitfalls]: https://github.com/kubernetes/design-proposals-archive/blob/main/architecture/declarative-application-management.md#parameterization-pitfalls
    18  [KRM functions]: https://github.com/kubernetes-sigs/kustomize/blob/master/cmd/config/docs/api-conventions/functions-spec.md
    19  [updating a package page]: /book/03-packages/05-updating-a-package.md