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

error: must specify one of -f and -k

Pe scurt

kubectl apply (sau delete, diff) nu știe ce fișier să folosească: ai scris numele fișierului fără -f. Scrie kubectl apply -f web.yaml (sau -f folder/), iar -k doar pentru un folder cu kustomization.yaml.

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

Ce înseamnă

kubectl apply primește obiectele din fișiere date prin -f (fișier, folder, URL sau - pentru stdin) sau dintr-un folder Kustomize prin -k. Dacă niciuna nu apare, comanda nu are ce aplica și se oprește.

Cea mai frecventă cauză este kubectl apply web.yaml, fără -f: kubectl ignoră argumentul liber și se plânge că lipsesc opțiunile. Mai apare când -f e lipit greșit (-fweb.yaml funcționează, dar - f web.yaml nu) sau când o variabilă de shell cu numele fișierului e goală.

Același mesaj îl dau și kubectl delete și kubectl diff când nu primesc nici fișier, nici tip și nume.

De ce apare: cauzele frecvente

1Lipsește -f

Greșit
YAML
kubectl apply web.yaml
Corect
YAML
kubectl apply -f web.yaml

Argumentul liber nu e interpretat ca fișier. -f spune că urmează un fișier, un folder sau un URL.

2Vrei să aplici tot folderul

Greșit
YAML
kubectl apply manifeste/
Corect
YAML
kubectl apply -f manifeste/

-f acceptă și un folder: aplică toate fișierele .yaml, .yml și .json din el.

3Folosești -k fără Kustomize

Greșit
YAML
kubectl apply -k web.yaml
Corect
YAML
kubectl apply -f web.yaml

-k cere un folder cu kustomization.yaml, nu un manifest simplu.

Repară tu

Repară eroarea, direct în pagină

Ai scris manifestul ~/k8s/vitrina.yaml pentru vitrina unui magazin de flori (un Deployment cu 2 replici), dar kubectl apply vitrina.yaml dă must specify one of -f and -k. Aplică fișierul corect și verifică faptul că pornesc ambele replici.

Indiciu

Numele fișierului vine după opțiunea -f.

Alte forme ale mesajului

  • error: must specify one of -f and -k error: unknown command "web.yaml"

Cum o eviți pe viitor

  • Ține manifestele într-un folder și aplică-l întreg: kubectl apply -f k8s/.
  • Înainte de apply, verifică ce s-ar schimba cu kubectl diff -f k8s/.
  • Folosește -R pentru foldere cu subfoldere.
  • Scrie comenzile des folosite într-un script sau Makefile al proiectului, ca toată echipa să le ruleze identic.

Întrebări frecvente

Care e diferența dintre -f și -k?

-f citește manifeste gata scrise. -k rulează întâi Kustomize pe un folder cu kustomization.yaml (care combină și modifică manifeste) și aplică rezultatul.

Pot aplica YAML scris direct în terminal?

Da, cu -f - și un here-document: kubectl apply -f - <<EOF ... EOF. Liniuța înseamnă stdin.

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.