# 错误：发布名称超过 53 个字符

- **ID:** `kubernetes/helm-release-name-too-long`
- **领域:** kubernetes
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 95%

## 根因

Helm 对发布名称强制限制为 53 个字符，因为发布名称用作 Kubernetes 资源名称（如 ConfigMap、Secret），这些资源名称限制为 63 个字符，留出 10 个字符给 Helm 的后缀。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| Helm 3.10 | active | — | — |
| Helm 3.12 | active | — | — |
| Kubernetes 1.25 | active | — | — |

## 解决方案

1. ```
   Shorten the release name to 53 characters or less. For example, rename 'my-very-long-application-release-v2' to 'my-app-v2'.
   ```
2. ```
   Use a Helm alias or environment variable to map a long name to a short one: `helm install short-name ./chart --set fullName=my-very-long-application-release-v2`.
   ```

## 无效尝试

- **** — Adding a random suffix to the release name does not reduce length; it may exceed the limit further. (80% 失败率)
- **** — Modifying Helm source code to bypass the limit is not portable and breaks compatibility with other Helm installations. (90% 失败率)