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
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
helm install Cache bitnami/redishelm install cache bitnami/redisDoar litere mici.
2Underscore
helm install cache_prod bitnami/redishelm install cache-prod bitnami/redisUnderscore nu e permis; folosește cratimă.
3Nume din ramura git
helm install "$BRANCH" ./chart # feature/Loginhelm install "$(echo $BRANCH | tr 'A-Z/_' 'a-z--' | cut -c1-40)" ./chartNormalizezi numele înainte.
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.
Reparația
Numele invalid:
helm install Cache bitnami/redis || trueError: 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 53Numele corect:
helm install cache bitnami/redis
helm listNAME: cache
LAST DEPLOYED: Thu Jan 15 10:00:06 2026
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
CHART NAME: redis
CHART VERSION: 20.3.0
APP VERSION: 7.4.1
** Please be patient while the chart is being deployed **
Redis can be accessed via port 6379 on the following DNS name from within your cluster:
cache-redis-master.default.svc.cluster.local
To get your password run:
export REDIS_PASSWORD=$(kubectl get secret --namespace default cache-redis -o jsonpath="{.data.redis-password}" | base64 -d)
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
cache default 1 2026-01-15 10:00:06.123462789 +0200 EET deployed redis-20.3.0 7.4.1De ce merge
Numele release-ului devine parte din numele obiectelor Kubernetes, care nu pot avea majuscule. Cu cache, numele respectă regula, iar chartul creează cache-redis-master și Secret-ul cache-redis. Numele obiectelor rezultate respectă și ele regulile Kubernetes, deci instalarea merge mai departe fără alte erori.
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
The Deployment "Web_App" is invalid: metadata.name: Invalid value: "Web_App": a lowercase RFC 1123 subdomain must consist of lower case alphanumeric characters, '-' or '.', and must start and end with an alphanumeric character Numele obiectului nu respectă regulile Kubernetes: doar litere mici, cifre, - și ., începând și terminând cu literă sau cifră. Înlocuiește majusculele și underscore-ul: Web_App devine web-app. Error: "helm install" requires 2 arguments
Usage: helm install [NAME] [CHART] [flags] helm install cere numele release-ului și chartul, în această ordine. Ai dat doar chartul: adaugă un nume (helm install cache bitnami/redis) sau folosește --generate-name. Error: INSTALLATION FAILED: cannot re-use a name that is still in use Există deja un release cu acest nume în namespace. Ca să-l modifici, folosește helm upgrade (sau helm upgrade --install, care merge și la prima instalare); helm install e doar pentru release-uri noi. Î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.
