使用 kustomize 对 kubernetes 对象进行声明式管理

补丁实战

策略合并补丁

基准文件：/test/bases/deploy.yml

apiVersion: apps/v1
kind: Deployment
metadata:
  namespace: spms-standard
  name: my-nginx
spec:
  selector:
    matchLabels:
      run: my-nginx
  replicas: 2
  template:
    metadata:
      labels:
        run: my-nginx
    spec:
      containers:
      - name: my-nginx
        image: nginx
        ports:
        - containerPort: 80

覆盖中的补丁文件：/test/dev/deploy.yml

apiVersion: apps/v1
kind: Deployment
metadata:
  namespace: spms-standard
  name: my-nginx
spec:
  selector:
    matchLabels:
      run: my-nginx
  replicas: 3
  template:
    metadata:
      labels:
        run: my-nginx
    spec:
      containers:
      - name: my-nginx2
        image: nginx
        ports:
        - containerPort: 80

覆盖中的 /test/dev/kustomization.yaml

resources:
  - ../bases
patches:
  - path: spms.yml

执行构建

kubectl kustomize  /test/dev

得到如下 YAML

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-nginx
  namespace: spms-standard
spec:
  replicas: 3
  selector:
    matchLabels:
      run: my-nginx
  template:
    metadata:
      labels:
        run: my-nginx
    spec:
      containers:
      - image: nginx    # 补丁新增
        name: my-nginx2
        ports:
        - containerPort: 80
      - image: nginx
        name: my-nginx
        ports:
        - containerPort: 80

JSON 补丁

非所有资源或者字段都支持策略性合并补丁。为了支持对任何资源的任何字段进行修改， Kustomize 提供通过 patchesJson6902 来应用 JSON 补丁的能力。 为了给 JSON 补丁找到正确的资源，需要在 kustomization.yaml 文件中指定资源的组（group）、 版本（version）、类别（kind）和名称（name）。

示例如下：

基准中的 Ingress 对象的文件： /test/bases/shark-ing.yml

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  namespace: spms-standard
  name: spms-standard-ingress-gateway
spec:
  ingressClassName: nginx
  rules:
  - http:
      paths:
      - path: "/spms-standard"
        pathType: Prefix
        backend:
          service:
            name: spms-standard-support-gateway
            port:
              number: 8080

覆盖中的 Ingress 对象的 JSON 补丁文件： /test/bases/shark-ing.yml

注意： 这里是增加了两个

- op: add
  path: /spec/rules/0/http/paths/-
  value:
     path: "/spms-digital"
     pathType: Prefix
     backend:
       service:
         name: spms-standard-support-gateway
         port:
           number: 8080
- op: add
  path: /spec/rules/0/http/paths/-
  value:
     path: "/spms-shark"
     pathType: Prefix
     backend:
       service:
         name: spms-standard-support-gateway
         port:
           number: 8080

• op 是预算符，值可以是: add remove replace
• path 是被操作的对象的YAML文件的路径

  /spec/rules/0/http/paths/ 对象如下内容：

  spec:
   rules:
   - http:
       paths:
  

  列表中的第一个元素的索引是 0， - 表示列表的最后位置

  覆盖中的 /test/dev/kustomization.yaml

  resources:
    - ../bases
  patches:
    - target:
        group: networking.k8s.io
        version: v1
        kind: Ingress
        namespace: spms-standard
        name: spms-standard-ingress-gateway
      path: spms-ing.yml
  

  以上文件中的

  • group 对应基准中的 Ingress 对象文件： /test/bases/shark-ing.yml 中 apiVersion 的值中 networking.k8s.io 部分。
  • version 对应基准中的 Ingress 对象文件： /test/bases/shark-ing.yml 中 apiVersion 的值中 v1 部分。
  • kind 对应基准中的 Ingress 对象文件： /test/bases/shark-ing.yml 中 kind 的值。
  • namespace对应基准中的 Ingress 对象文件： /test/bases/shark-ing.yml 中 namespace 的值。
  • name对应基准中的 Ingress 对象文件： /test/bases/shark-ing.yml 中 name 的值。

    执行构建

    kubectl kustomize  /test/dev
    

    将会得到如下完整的 YAML 文件

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      name: spms-standard-ingress-gateway
      namespace: spms-standard
    spec:
      ingressClassName: nginx
      rules:
      - http:
          paths:
          - backend:
              service:
                name: spms-standard-support-gateway
                port:
                  number: 8080
            path: /spms-standard
            pathType: Prefix
          - backend:
              service:
                name: spms-standard-support-gateway
                port:
                  number: 8080
            path: /spms-digital
            pathType: Prefix
          - backend:
              service:
                name: spms-standard-support-gateway
                port:
                  number: 8080
            path: /spms-shark
            pathType: Prefix