Helm模板CRD名称超长处理及range与printf联用报错问题

1. 定义CRD名称截断模板（_helpers.tpl） #

在_helpers.tpl中添加可复用的名称处理模板，确保生成的CRD名称最长不超过63字符，同时符合Kubernetes DNS命名规范：

{{/* 生成截断后的合法CRD名称（最长63字符） */}}
{{- define "crd.name.truncated" -}}
{{- /* 拼接基础名称与后缀，统一转小写 */}}
{{- $baseName := printf "%s-scale-out" $.Values.common.info.name | lower -}}
{{- /* 长度超限则截断，清理末尾可能残留的连字符 */}}
{{- if gt (len $baseName) 63 -}}
{{- $baseName | trunc 63 | trimSuffix "-" -}}
{{- else -}}
{{- $baseName -}}
{{- end -}}
{{- end -}}

2. 批量创建CRD的Range循环配置 #

在CRD模板文件（如templates/crd.yaml）中，通过range循环批量生成N个CRD，注意传递根上下文避免变量访问错误：

{{/* 读取values中配置的CRD数量并转为整数 */}}
{{- $crdCount := .Values.crd.count | int -}}
{{/* 循环生成每个CRD实例 */}}
{{- range $index := until $crdCount -}}
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  {{/* 调用截断模板生成基础名称，追加编号区分不同实例 */}}
  name: {{ include "crd.name.truncated" $ }}-{{ add $index 1 }}
spec:
  # 此处填写你的CRD spec定义
  group: your-group.example.com
  names:
    kind: YourResource
    plural: yourresources
  scope: Namespaced
  versions:
  - name: v1
    served: true
    storage: true
    schema:
      openAPIV3Schema:
        type: object
        properties:
          spec:
            type: object
{{- end -}}

3. 常见报错修复 #

上下文丢失导致的Values访问错误 #

range循环内默认的.指向当前循环变量（如$index），而非根上下文，必须用$.Values替代.Values，否则会出现"找不到Values字段"的报错。

printf参数错误 #

若直接在循环内用printf拼接名称，需确保引用根上下文变量：

# 错误写法（循环内.指向$index）
printf "%s-scale-out" .Values.common.info.name
# 正确写法
printf "%s-scale-out" $.Values.common.info.name

名称合法性问题 #

截断后的名称可能以连字符-结尾，需用trimSuffix "-"清理，避免违反Kubernetes资源命名规范。

类型转换错误 #

如果values.yaml中crd.count是字符串类型，必须用int函数转为整数，否则until函数会报错。

验证方法 #

执行helm template命令预览生成的CRD配置，确认名称格式和长度符合要求：

helm template ./your-chart --set crd.count=2

内容的提问来源于stack exchange，提问作者Park jinhong