Update docs for merge3

This commit is contained in:
Jonathan Wong
2019-12-13 04:16:02 -08:00
parent 8095b16c9a
commit e35e0bff60

View File

@@ -1,24 +1,22 @@
## merge3 ## merge3
[Alpha] Merge Resource configuration files (3-way) [Alpha] Merge diff of Resource configuration files into a destination (3-way)
### Synopsis ### Synopsis
[Alpha] Merge Resource configuration files (3-way) [Alpha] Merge diff of Resource configuration files into a destination (3-way)
Merge (3-way) reads Kubernetes Resource yaml configuration files from source packages and updated Merge3 performs a 3-way merge by applying the diff between 2 sets of Resources to a 3rd set.
packages then writes the result to stdout and a destination package.
Resources are merged using the Resource [apiVersion, kind, name, namespace] as the key. If any of Merge3 may be for rebasing changes to a forked set of configuration -- e.g. compute the difference between the original
these are missing, merge will default the missing values to empty. set of Resources that was forked and an updated set of those Resources, then apply that difference to the fork.
Resources specified in the updated packages have higher-precedence and Resources specified If a field value differs between the ORIGINAL_DIR and UPDATED_DIR, the value from the UPDATED_DIR is taken and applied
in the original packages have lower-precedence. Resources specified in the destination to the Resource in the DEST_DIR.
packages either keep, clear, or recursively merge their values.
For information on merge rules, run: For information on merge rules, run:
kustomize config docs merge3 kustomize config docs-merge3
### Examples ### Examples