...
Eroare Kubernetes · Helm

Error: INSTALLATION FAILED: release name "Cache": invalid release name, must match regex ^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$ and the length must not be longer than 53

Pe scurt

Numele release-ului are majuscule, underscore, spații sau e prea lung (peste 53 de caractere). Folosește doar litere mici, cifre și cratime, de exemplu cache sau cache-prod.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Numele release-ului ajunge în numele obiectelor Kubernetes (cache-redis-master, Secret-ul sh.helm.release.v1.cache.v1), deci trebuie să respecte aceleași reguli: litere mici, cifre, cratime și puncte, începând și terminând cu literă sau cifră. Limita de 53 de caractere lasă loc sufixelor pe care charturile le adaugă.

Greșeli tipice: majuscule (Cache, MagazinProd), underscore (cache_prod), nume generate din numele ramurii git (feature/Login) sau nume foarte lungi compuse automat în pipeline.

În pipeline, curăță numele înainte: litere mici și caractere nepermise înlocuite cu cratimă.

De ce apare: cauzele frecvente

1Majuscule

Greșit
YAML
helm install Cache bitnami/redis
Corect
YAML
helm install cache bitnami/redis

Doar litere mici.

2Underscore

Greșit
YAML
helm install cache_prod bitnami/redis
Corect
YAML
helm install cache-prod bitnami/redis

Underscore nu e permis; folosește cratimă.

3Nume din ramura git

Greșit
YAML
helm install "$BRANCH" ./chart   # feature/Login
Corect
YAML
helm install "$(echo $BRANCH | tr 'A-Z/_' 'a-z--' | cut -c1-40)" ./chart

Normalizezi numele înainte.

Repară tu

Repară eroarea, direct în pagină

Pentru cache-ul unei aplicații de rezervări la restaurant ai rulat helm install Cache bitnami/redis, iar Helm refuză numele. Instalează chartul ca release-ul cache.

Indiciu

Numele release-ului acceptă doar litere mici, cifre și cratime.

Alte forme ale mesajului

  • release name "cache_prod": invalid release name, must match regex

Cum o eviți pe viitor

  • Folosește pentru release-uri aceeași convenție ca pentru obiectele Kubernetes: litere mici și cratime.
  • Normalizează numele generate automat în pipeline.
  • Păstrează numele scurte, sub 40 de caractere, pentru sufixele charturilor.
  • Folosește un nume care descrie rolul release-ului (cache, cache-test), nu tehnologia sau persoana care l-a instalat.
  • Verifică numele cu helm install --dry-run înainte de livrare.

Întrebări frecvente

De ce 53 și nu 63?

Pentru că multe charturi adaugă sufixe la numele release-ului, iar numele obiectelor au maximum 63 de caractere.

Pot redenumi un release?

Nu. Instalezi unul nou cu numele dorit și îl dezinstalezi pe cel vechi.

Erori înrudite

← Toate erorile Kubernetes

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kubernetes de la zero, cu exerciții la fiecare lecție

Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.