Kubernetes kustomize: Difference between revisions

From 탱이의 잡동사니
Jump to navigation Jump to search
No edit summary
No edit summary
Line 5: Line 5:


== Basic ==
== 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.
Kustomize is a standalone tool to customize Kubernetes objects through a kustomization file.


Line 10: Line 15:
<pre>
<pre>
$ kubectl kustomize <kustomization_directory>
$ kubectl kustomize <kustomization_directory>
$ kubectl kustomize ./k8s
apiVersion: v1
kind: Service
metadata:
  labels:
    app: simple-golang
  name: svc-cluster-simple-golang
spec:
  ports:
  - name: http
    port: 8090
    protocol: TCP
    targetPort: 8090
  selector:
    app: simple-golang
  type: ClusterIP
---
apiVersion: v1
kind: Service
metadata:
  labels:
    app: simple-golang
  name: svc-nodeport-simple-golang
spec:
  ports:
  - port: 8090
    protocol: TCP
  selector:
    app: simple-golang
  type: NodePort
---
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: simple-golang
  name: simple-golang
spec:
  replicas: 1
  selector:
    matchLabels:
      app: simple-golang
  template:
    metadata:
      labels:
        app: simple-golang
        deployment: simple-golang
    spec:
      containers:
      - image: simple_golang_k8s:latest
        name: simple-golang
        ports:
        - containerPort: 8090
        resources:
          limits:
            cpu: "1"
            memory: 256M
          requests:
            cpu: 100m
            memory: 128M
---
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  labels:
    app: simple-golang
  name: ingress-simple-golang
spec:
  backend:
    serviceName: svc-nodeport-simple-golang
    servicePort: 8090
  rules:
  - host: foo.mydomain.com
    http:
      paths:
      - backend:
          serviceName: svc-nodeport-simple-golang
          servicePort: 8090
</pre>
</pre>


Line 94: Line 20:
<pre>
<pre>
$ kubectl apply -k <kustomization_directory>
$ kubectl apply -k <kustomization_directory>
</pre>
== 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.
<pre>
# 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
</pre>
</pre>


== See also ==
== See also ==
* https://blog.stack-labs.com/code/kustomize-101/ - Kustomize - The right way to do templating in Kubernetes
* https://blog.stack-labs.com/code/kustomize-101/ - Kustomize - The right way to do templating in Kubernetes
* https://kubernetes.io/docs/tasks/manage-kubernetes-objects/kustomization - Declarative management of kubernetes objects using kustomize


[[category:kubernetes]]
[[category:kubernetes]]

Revision as of 15:15, 20 February 2020

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