Napomena prev.: оригинální článek napsal Josh Rosso — architekt z VMware, který dříve pracoval ve společnostech jako CoreOS a Heptio a je také spoluautorem Kubernetes alb-ingress-controller. Autor sdílí malý recept, který může být velmi užitečný pro

Píšete YAML manifesty pro Kubernetes ve vim? Strávili jste nespočet hodin snahou pochopit, kde by v této specifikaci mělo být další pole? Možná byste uvítali rychlé připomenutí rozdílu args i command? Есть хорошие новости! Vim легко привязать к , abyste získali automatické doplnění, validaci a další výhody. V článku si povíme, jak nastavit klienta jazykového serveru pro tento účel.
(V původním článku je také , kde autor vypráví a demonstruje obsah materiálu.)
Jazykový server
Jazykové servery (language servers) informují editory a IDE o možnostech programovacích jazyků a komunikují mezi sebou prostřednictvím speciálního protokolu — (LSP). To je skvělý přístup: umožňuje jedné implementaci zasobovat data pro mnoho editorů/IDE. Já už o — jazykový server pro Golang — a jak jej lze použít v . Kroky pro získání automatického doplnění v YAML pro Kubernetes jsou podobné.

Aby vim fungoval popsaným způsobem, je třeba nainstalovat klienta jazykového serveru. Dva známé způsoby, které znám, jsou i . V článku budu zvažovat coc.vim — to je v současnosti nejpopulárnější plugin. Nainstalovat jej můžete přes :
" Použijte stabilní verzi (doporučeno)
Plug 'neoclide/coc.nvim', {'branch': 'release'}
" Nebo sestavte ze zdrojového kódu pomocí yarn: https://yarnpkg.com
Plug 'neoclide/coc.nvim', {'do': 'yarn install --frozen-lockfile'} Za pokretanje coc (a tímto i server yaml-language-server) je potřeba mít nainstalovaný node.js:
curl -sL install-node.now.sh/lts | bash Kada coc.vim poté nastavte serverové rozšíření coc-yaml přímo z vim:
:CocInstall coc-yaml 
Nakonec pravděpodobně budete chtít začít s konfigurací coc-vim, která je uvedena . Zvláště aktivuje kombinaci +mezerník pro vyvolání automatického doplnění.
Nastavení detekce yaml-language-server
Kako bi coc měl by využít yaml-language-server, je třeba od něj požádat, aby při editaci YAML souborů načítal schéma z Kubernetes. To se provádí editací coc-config:
:CocConfig V konfiguraci bude třeba přidat kubernetes za sve datoteke yaml. Dodatno koristim jezički server za golang, tako da moja ukupna konfiguracija izgleda ovako:
{
"languageserver": {
"golang": {
"command": "gopls",
"rootPatterns": ["go.mod"],
"filetypes": ["go"]
}
},
"yaml.schemas": {
"kubernetes": "/*.yaml"
}
} kubernetes — rezervisano polje koje obaveštava jezički server o potrebi učitavanja Kubernetes šeme sa URL-a, definisanog u . yaml.schemas može se proširiti podrškom za dodatne šeme — više informacija možete pronaći u .
Sada možete kreirati YAML datoteku i početi koristiti automatsko popunjavanje. Pritiskom na +mezerník ili neku drugu kombinaciju, podešenu u vim, trebali bi se prikazati dostupna polja i dokumentacija u skladu sa trenutnim kontekstom:

Ovde funkcioniše +razmak, jer sam podesio inoremap coc#refresh(). Ako to niste uradili — pogledajte za primer konfiguracije.
Izbor verzije Kubernetes API
U vreme pisanja ovog članka, yaml-language-server dolazi sa šemama Kubernetes 1.14.0. Nije pronađen način za dinamičko biranje šeme, pa sam otvorio . Na sreću, pošto je jezički server napisan u typescript-u, vrlo je lako ručno promeniti verziju. Dovoljno je pronaći datoteku server.ts.
Da biste je pronašli na svojoj mašini, jednostavno otvorite YAML datoteku u vim-u i potražite proces sa yaml-language-server.
ps aux | grep -i yaml-language-server
joshrosso 2380 45.9 0.2 5586084 69324 ?? S 9:32PM 0:00.43 /usr/local/Cellar/node/13.5.0/bin/node /Users/joshrosso/.config/coc/extensions/node_modules/coc-yaml/node_modules/yaml-language-server/out/server/src/server.js --node-ipc --node-ipc --clientProcessId=2379
joshrosso 2382 0.0 0.0 4399352 788 s001 S+ 9:32PM 0:00.00 grep -i yaml-language-serverZa nas je relevantan proces 2380: upravo njega koristi vim tokom editovanja YAML datoteke.
Kao što se lako može videti, datoteka se nalazi u /Users/joshrosso/.config/coc/extensions/node_modules/coc-yaml/node_modules/yaml-language-server/out/server/src/server.js. Dovoljno je urediti je, menjajući vrednost KUBERNETES_SCHEMA_URL, na primer, na verziju 1.17.0:
// old 1.14.0 schema
//exports.KUBERNETES_SCHEMA_URL = "https://raw.githubusercontent.com/garethr/kubernetes-json-schema/master/v1.14.0-standalone-strict/all.json";
// new 1.17.0 schema in instrumenta repo
exports.KUBERNETES_SCHEMA_URL = "https://raw.githubusercontent.com/instrumenta/kubernetes-json-schema/master/v1.17.0-standalone-strict/all.json"; U zavisnosti od verzije koja se koristi, coc-yaml mesto promenljive u kodu može varirati. Takođe, obratite pažnju da sam promenio repozitorij sa garethr na instrumenta. Čini se da garethr je prešao na podršku za šeme upravo tamo.
Da biste proverili da li je promena stupila na snagu, proverite da li se pojavljuje polje koje ranije [u prošlim verzijama Kubernetes-a] nije postojalo. Na primer, u šemi za K8s 1.14 nije bilo :

Sažetak
Nadam se da vam je ova prilika donijela jednako zadovoljstvo kao i meni. Srećno sa YAML-om! Ne zaboravite da pogledate ove repozitorije kako biste bolje razumjeli alate spomenute u članku:
- coc-vim: ;
- coc-yaml: .
P.S. od prevodioca
A tu je i , i .
Takođe pročitajte na našem blogu:
- «»;
- «».
Izvor: habr.com
