A Kustomize generator plugin to merge YAML files seamlessly for real-world use cases.
Merger provides schemaless merge with different merge strategies (StrategicMerge).
The main goal of the Merger plugin is to provide a more flexible way to merge YAML files
and extend the strict merge capacities of Kustomize.
Kustomize's default patch strategy for the lists (arrays) is replace, and to change that
for the Kubernetes Custom Resource, you must provide the OpenAPI schema of that custom resource,
which is only helpful if the lists of that CR have a unique id.
Many people are asking for such functionalities as easy merging CRs, creating a ConfigMap from arbitrary YAML files, and for more details on the challenge of providing OpenAPI schema to merge files, please read the following post: Set OpenAPI patch strategy for Kubernetes Custom Resources.
- Generate multiple resources/manifests from a single base without copying the resources multiple times.
- Merge any manifests (even CustomResources) without needing their OpenAPI schema.
- Merge applications configuration YAML files into a ConfigMap or Secret.
- Merge manifests with a list of maps without a unique identifier
(when using
x-kubernetes-patch-merge-keyis not possible). - Merge YAML files with different merge strategies (StrategicMerge).
---
apiVersion: generators.kustomize.devopshive.net/v1alpha1
kind: Merger
metadata:
name: merge
annotations:
# Containerized KRM function.
config.kubernetes.io/function: |
container:
image: ghcr.io/devopshivehq/kustomize-generator-merger
mounts:
- type: bind
src: ./
dst: /mnt
# Exec KRM functions.
# config.kubernetes.io/function: |
# exec:
# path: kustomize-plugin-merger
spec:
resources:
- name: example
input:
# Available options: overlay,patch.
# - Overlay: Produce multiple outputs by merging each source with the destination.
# - Patch: Produce a single output by merging all sources together then with the destination.
method: overlay
files:
# The same as in the KRM container above, omit it if Exec KRM is used.
root: /mnt
sources:
- src01.yaml
- src02.yaml
destination: dst.yaml
merge:
# Available options: replace,append,combine.
# - Replace: All keys in source will merge and replace what's in the destination.
# - Append: Maps from source merged with destination, but the lists will be appended from source to destination.
# - Combine: Maps from source merged with destination, but the lists will be combined together.
strategy: combine
output:
# Available options: raw,configmap,secret
format: rawThis section shows a couple of use cases where Merger can help.
In this case, you have multiple CronJobs, all of which share the same body,
but each has a different command or other config.
No plans from Kustomize to support non-manifest files merge and storing them into ConfigMap or Secret. Using Merger you can merge any YAML files like application configuration.
Currently, in Kustomize, it's not possible to merge resources without a unique identifier, even with Open API schema.
It's possible to do that using the merge strategy append in Merger (later on, combineWithKey will also be supported).
In some use cases (e.g., Crossplane Compositions),
you could have a really long YAML manifest, and it's hard to read. You can split that file
and use the Merger patch input method to make it a single manifest again.
- Support
combinemerge strategy with an identifier key (similar tox-kubernetes-patch-merge-key). - Configure the output indentation.
- Provide better docs for Merger options.
Please note that this project is still under development and could have breaking changes, but it will follow the SemVer convention.
All feedback and contributions are welcome. If you find any issues or want to contribute, please feel free to fill an issue or create a PR.
Merger is an open-source software licensed using the Apache License 2.0. Please see LICENSE for details.
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "github-actions[bot]")
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent