版本:v1.8

补丁策略

在默认情况下,KubeVela 会将需要打补丁的值通过 CUE 的 merge 来进行合并。但是目前 CUE 无法处理有冲突的字段名。

KubeVela 提供了一系列补丁策略来帮助解决冲突的问题。在编写补丁型运维特征和工作流时,如果你发现值冲突的问题,可以结合使用这些补丁策略。值得注意的是,补丁策略并不是 CUE 官方提供的功能, 而是 KubeVela 扩展开发而来。

关于如何在定义中打补丁,请参考 在定义中打补丁

我们以编写一个环境变量补丁的运维特征来分别介绍补丁策略的使用方法。

如果你希望为指定容器添加多个环境变量,你可以使用 +patchKey=name 注释来找到这个容器。此时,KubeVela 会执行 merge 操作,将这些环境变量与已有的环境变量进行合并。这意味着,patchKey 无法处理重复的字段名。

在 KubeVela 1.4 版本之后,你可以使用 , 分割多个 patchKey,如 patchKey=name,image。

在环境中部署如下 definition:

  1. myenv: {
  2. type: "trait"
  3. annotations: {}
  4. labels: {
  5. "ui-hidden": "true"
  6. }
  7. description: "Add env on K8s pod for your workload which follows the pod spec in path 'spec.template'"
  8. attributes: appliesToWorkloads: ["*"]
  9. }
  10. template: {
  11. patch: {
  12. spec: template: spec: {
  13. // +patchKey=name
  14. containers: [{
  15. name: context.name
  16. env: [
  17. for k, v in parameter.env {
  18. name: k
  19. value: v
  20. },
  21. ]
  22. }]
  23. }
  24. }
  25. parameter: {
  26. env: [string]: string
  27. }
  28. }

在如下应用中使用这个策略型补丁:

  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4. name: webservice-app
  5. spec:
  6. components:
  7. - name: express-server
  8. type: webservice
  9. properties:
  10. image: crccheck/hello-world
  11. env:
  12. - name: OLD
  13. value: old
  14. traits:
  15. - type: myenv
  16. properties:
  17. env:
  18. NEW: new

在不使用 myenv 这个补丁特征之前,应用的环境变量为:

  1. spec:
  2. containers:
  3. - env:
  4. - name: OLD
  5. value: old

在使用了 myenv 这个补丁特征之后,应用的环境变量为:

  1. spec:
  2. containers:
  3. - env:
  4. - name: OLD
  5. value: old
  6. - name: NEW
  7. value: new

最终,我们可以看到应用的环境变量中包含了两个环境变量:OLD=oldNEW=new

如果你希望在合并环境变量的同时,能够覆盖重复的环境变量值的话,你可以使用 +patchStrategy=retainKeys 注释。

这个注解的策略,与 Kubernetes 官方的 retainKeys 策略类似。

在下面这个例子中,+patchKey=name 会指定 patch 应该应用到哪个容器上,而 +patchStrategy=retainKeys 则会指定在合并环境变量时,如果遇到重复的环境变量名,则覆盖环境变量值。

  1. myenv: {
  2. type: "trait"
  3. annotations: {}
  4. labels: {
  5. "ui-hidden": "true"
  6. }
  7. description: "Add env on K8s pod for your workload which follows the pod spec in path 'spec.template'"
  8. attributes: appliesToWorkloads: ["*"]
  9. }
  10. template: {
  11. patch: {
  12. spec: template: spec: {
  13. // +patchKey=name
  14. containers: [{
  15. name: context.name
  16. // +patchStrategy=retainKeys
  17. env: [
  18. for k, v in parameter.env {
  19. name: k
  20. value: v
  21. },
  22. ]
  23. }]
  24. }
  25. }
  26. parameter: {
  27. env: [string]: string
  28. }
  29. }

在如下应用中使用这个策略型补丁:

  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4. name: webservice-app
  5. spec:
  6. components:
  7. - name: express-server
  8. type: webservice
  9. properties:
  10. image: crccheck/hello-world
  11. env:
  12. - name: OLD
  13. value: old
  14. - name: OLD2
  15. value: old2
  16. traits:
  17. - type: myenv
  18. properties:
  19. env:
  20. NEW: new
  21. OLD2: override

在不使用 myenv 这个补丁特征之前,应用的环境变量为:

  1. spec:
  2. containers:
  3. - env:
  4. - name: OLD
  5. value: old
  6. - name: OLD2
  7. value: old2

在使用了 myenv 这个补丁特征之后,应用的环境变量为:

  1. spec:
  2. containers:
  3. - env:
  4. - name: OLD
  5. value: old
  6. - name: OLD2
  7. value: override
  8. - name: NEW
  9. value: new

最终,我们可以看到应用的环境变量中包含了三个环境变量:OLD=oldOLD2=overrideNEW=new

如果你希望直接替换掉整个环境变量数组的话,你可以使用 +patchStrategy=replace 注释。

在下面这个例子中,+patchKey=name 会指定 patch 应该应用到哪个容器上,而 +patchStrategy=replace 则会指定在合并数组时,直接替换整个环境变量数组。

  1. myenv: {
  2. type: "trait"
  3. annotations: {}
  4. labels: {
  5. "ui-hidden": "true"
  6. }
  7. description: "Add env on K8s pod for your workload which follows the pod spec in path 'spec.template'"
  8. attributes: appliesToWorkloads: ["*"]
  9. }
  10. template: {
  11. patch: {
  12. spec: template: spec: {
  13. // +patchKey=name
  14. containers: [{
  15. name: context.name
  16. // +patchStrategy=replace
  17. env: [
  18. for k, v in parameter.env {
  19. name: k
  20. value: v
  21. },
  22. ]
  23. }]
  24. }
  25. }
  26. parameter: {
  27. env: [string]: string
  28. }
  29. }

在如下应用中使用这个策略型补丁:

  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4. name: webservice-app
  5. spec:
  6. components:
  7. - name: express-server
  8. type: webservice
  9. properties:
  10. image: crccheck/hello-world
  11. env:
  12. - name: OLD
  13. value: old
  14. - name: OLD2
  15. value: old2
  16. traits:
  17. - type: myenv
  18. properties:
  19. env:
  20. NEW: replace

在不使用 myenv 这个补丁特征之前,应用的环境变量为:

  1. spec:
  2. containers:
  3. - env:
  4. - name: OLD
  5. value: old
  6. - name: OLD2
  7. value: old2

在使用了 myenv 这个补丁特征之后,应用的环境变量为:

  1. spec:
  2. containers:
  3. - env:
  4. - name: NEW
  5. value: replace

最终,我们可以看到应用的环境变量中只保留了新的环境变量:NEW=replace

Last updated on 2023年5月6日 by Tianxin Dong