Kustomize

From 탱이의 잡동사니
Jump to: navigation, search

Overview

Kustomize 내용 정리.

Kustomize does customize raw, template-free YAML files for multiple purposes, leaving the original YAML untouched and usable as-is.

Basic

Kustomize is a tool for customizing Kubernetes configurations. It has the following features to manage application configuration files:

  • generating resources from other sources.
  • setting cross-cutting fields for resources.
  • composing and customizing collections of resources.

Kustomize is a standalone tool to customize Kubernetes objects through a kustomization file.

Since 1.14, Kubectl also supports the management of Kubernetes objects using a kustomization file. To view Resources found in a directory containing a kustomization file, run the following command.

$ kubectl kustomize <kustomization_directory>

To apply those Resources, run kubectl apply with --kustomize or -k flag.

$ kubectl apply -k <kustomization_directory>

Generating resources

ConfigMap and Secret hold config or sesitive data that are used by other Kubernetes objects, such as Pods. The source of truth of ConfigMap or Secret are usually from somewhere else, such as .properties file or a ssh key file. Kustomize has secretGenerator and configMapGenerator, which generate Secret and ConfigMap from files or literals.

ConfigMapGenerator

To generate a ConfigMap from a file, add an entry to files list in configMapGenerator.

# Create a application.properties file
$ cat <<EOF >application.properties
FOO=Bar
EOF

$ cat <<EOF >./kustomization.yaml
configMapGenerator:
- name: example-configmap-1
  files:
  - application.properties
EOF

See also