...
Eroare Kubernetes · kubectl, kubeconfig și conexiunea la cluster

error: unable to read URL "https://k8s.io/examples/aplication/deployment.yaml", server reported 404 Not Found, status code=404

Pe scurt

kubectl a încercat să descarce manifestul de la adresa dată cu -f, iar serverul a răspuns 404: URL-ul e greșit sau fișierul a fost mutat. Deschide adresa în browser, corectează calea și, la GitHub, folosește linkul raw.

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

Ce înseamnă

-f acceptă și adrese https: kubectl descarcă fișierul și îl aplică. Mesajul spune că descărcarea a eșuat, cu codul HTTP primit. 404 înseamnă că la adresa respectivă nu e nimic: o literă greșită în cale, un fișier mutat într-o versiune nouă a documentației sau o ramură git redenumită (master față de main).

O capcană frecventă e linkul către pagina GitHub a fișierului (github.com/.../blob/...): acela întoarce o pagină HTML, nu YAML-ul, iar kubectl dă altă eroare, de parsare. Pentru fișierele de pe GitHub folosește linkul „Raw” (raw.githubusercontent.com/...).

Alte coduri au alte cauze: 403 (acces interzis, repository privat), erori de rețea sau certificat (proxy, firewall).

De ce apare: cauzele frecvente

1Greșeală în cale

Greșit
YAML
kubectl apply -f https://k8s.io/examples/aplication/deployment.yaml
Corect
YAML
kubectl apply -f https://k8s.io/examples/application/deployment.yaml

aplication nu există în documentație; calea corectă e application.

2Link spre pagina GitHub, nu spre fișier

Greșit
YAML
kubectl apply -f https://github.com/org/repo/blob/main/k8s/app.yaml
Corect
YAML
kubectl apply -f https://raw.githubusercontent.com/org/repo/main/k8s/app.yaml

Pagina blob e HTML; varianta raw este fișierul YAML.

3Ramura sau versiunea s-a schimbat

Greșit
YAML
kubectl apply -f https://raw.githubusercontent.com/org/repo/master/app.yaml
Corect
YAML
kubectl apply -f https://raw.githubusercontent.com/org/repo/main/app.yaml

Când un proiect redenumește ramura, linkurile vechi dau 404.

Repară tu

Repară eroarea, direct în pagină

Documentația Kubernetes are un exemplu de Deployment la https://k8s.io/examples/application/deployment.yaml. Colegul tău a scris adresa greșit și kubectl apply -f https://k8s.io/examples/aplication/deployment.yaml dă server reported 404 Not Found. Aplică exemplul de la adresa corectă și verifică Deploymentul creat.

Indiciu

Compară literă cu literă cuvântul application din cale.

Alte forme ale mesajului

  • error: unable to read URL "https://raw.githubusercontent.com/org/repo/master/app.yaml", server reported 404 Not Found, status code=404

Cum o eviți pe viitor

  • Descarcă manifestele externe, citește-le și păstrează-le în proiect, în loc să aplici direct de pe internet.
  • Folosește linkuri cu versiune fixă (un tag), nu ramuri care se mută.
  • Verifică adresa cu curl -sI URL înainte să o dai la kubectl.

Întrebări frecvente

E sigur să aplici manifeste direct de pe internet?

Doar din surse în care ai încredere și, ideal, după ce le-ai citit. Un manifest poate crea orice în cluster, inclusiv permisiuni largi.

De ce în browser merge, iar în kubectl nu?

Fie browserul a urmat o redirecționare pe care o pagină o face doar pentru oameni, fie ai deschis varianta HTML. kubectl are nevoie de fișierul brut.

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.