Како ефикасније користити кубецтл: детаљан водич

Ако радите са Кубернетес-ом, онда је кубецтл вероватно један од услужних програма које најчешће користите. И кад год проведете много времена радећи са одређеним алатом, исплати се да га добро проучите и научите како да га ефикасно користите.

Тим Кубернетес ааС са Маил.ру превео је чланак Данијела Вајбела у коме ћете пронаћи савете и трикове за ефикасан рад са кубецтл-ом. Такође ће вам помоћи да стекнете дубље разумевање Кубернетеса.

Према речима аутора, циљ чланка је да ваш свакодневни рад са Кубернетесом учини не само ефикаснијим, већ и пријатнијим!

Увод: Шта је кубецтл

Пре него што научите да ефикасније користите кубецтл, морате стећи основно разумевање шта је то и како функционише.

Из перспективе корисника, кубецтл је контролна табла која вам омогућава да обављате Кубернетес операције.

Технички гледано, кубецтл је Кубернетес АПИ клијент.

Кубернетес АПИ је ХТТП РЕСТ АПИ. Овај АПИ је прави Кубернетес кориснички интерфејс, преко којег се потпуно контролише. То значи да је свака Кубернетес операција изложена као АПИ крајња тачка и да се може извршити са ХТТП захтевом до те крајње тачке.

Стога је главни посао кубецтл-а да прави ХТТП захтеве Кубернетес АПИ-ју:

Кубернетес је систем у потпуности оријентисан на ресурсе. То значи да одржава интерно стање ресурса и да су све Кубернетес операције ЦРУД операције.

Ви имате потпуну контролу над Кубернетес-ом тако што управљате овим ресурсима, а Кубернетес схвата шта да ради на основу тренутног стања ресурса. Из тог разлога, Кубернетес АПИ референца је организована као листа типова ресурса са њиховим повезаним операцијама.

Погледајмо пример.

Рецимо да желите да креирате РеплицаСет ресурс. Да бисте то урадили, опишете РеплицаСет у датотеци по имену replicaset.yaml, а затим покрените команду:

$ kubectl create -f replicaset.yaml

Ово ће створити РеплицаСет ресурс. Али шта се дешава иза кулиса?

Кубернетес има операцију креирања РеплицаСет-а. Као и свака друга операција, изложена је као АПИ крајња тачка. Конкретна АПИ крајња тачка за ову операцију изгледа овако:

POST /apis/apps/v1/namespaces/{namespace}/replicasets

АПИ крајње тачке за све Кубернетес операције се могу наћи на АПИ референце (укључујући горњу крајњу тачку). Да бисте упутили стварни захтев крајњој тачки, прво морате да додате УРЛ АПИ сервера путањама крајње тачке које су наведене у АПИ референци.

Дакле, када извршите горњу команду, кубецтл шаље ХТТП ПОСТ захтев горњој АПИ крајњој тачки. Дефиниција РеплицаСет коју сте навели у датотеци replicaset.yaml, шаље се у телу захтева.

Овако кубецтл ради за све команде које су у интеракцији са Кубернетес кластером. У свим овим случајевима, кубецтл једноставно шаље ХТТП захтеве одговарајућим крајњим тачкама Кубернетес АПИ-ја.

Имајте на уму да можете у потпуности управљати Кубернетес-ом користећи услужни програм као што је curlручним слањем ХТТП захтева Кубернетес АПИ-ју. Кубецтл једноставно олакшава коришћење Кубернетес АПИ-ја.

Ово су основе онога што је кубецтл и како функционише. Али постоји још нешто о Кубернетес АПИ-ју што би сваки корисник кубецтл требао знати. Хајде да на брзину завиримо у унутрашњи свет Кубернетеса.

Унутрашњи свет Кубернетеса

Кубернетес се састоји од скупа независних компоненти које се покрећу као засебни процеси на чворовима кластера. Неке компоненте раде на главним чворовима, друге на радним чворовима, при чему свака компонента обавља свој специфични задатак.

Ево најважнијих компоненти на главним чворовима:

1. складиште - чува дефиниције ресурса (обично је то итд).
2. АПИ сервер — обезбеђује АПИ и управља складиштењем.
3. Цонтроллер Манагер — Осигурава да су статуси ресурса у складу са спецификацијама.
4. Планер — распоређује подове на радничким чворовима.

А ево једне најважније компоненте на радничким чворовима:

1. Кубелет — управља покретањем контејнера на радном чвору.

Да бисмо разумели како ове компоненте раде заједно, погледајмо пример.

Претпоставимо да сте управо завршили kubectl create -f replicaset.yaml, након чега је кубецтл направио ХТТП ПОСТ захтев за РеплицаСет АПИ крајња тачка (пролажење дефиниције ресурса РеплицаСет).

Шта се дешава у кластеру?

1. Након обављања kubectl create -f replicaset.yaml АПИ сервер чува дефиницију вашег РеплицаСет ресурса у складишту:

   

2. Затим, РеплицаСет контролер се покреће у менаџеру контролера, који управља креирањем, модификацијом и брисањем РеплицаСет ресурса:

   

3. РеплицаСет контролер креира дефиницију под за сваку РеплицаСет реплику (према шаблону под у дефиницији РеплицаСет) и чува их у складишту:

   

4. Планер је покренут, пратећи модуле који још нису додељени ниједном радничком чвору:

   

5. Планер бира одговарајући радни чвор за сваки под и додаје ове информације дефиницији модула у продавници:

   

6. На радном чвору којем је под додељена, Кубелет се покреће, он прати подове додељене овом чвору:

   

7. Кубелет чита дефиницију под из складишта и даје инструкције времену извођења контејнера, као што је Доцкер, да покрене контејнере на чвору:

   

Испод је текстуална верзија овог описа.

АПИ захтев за крајњу тачку креирања РеплицаСет-а обрађује АПИ сервер. АПИ сервер аутентификује захтев и чува дефиницију РеплицаСет ресурса у складишту.

Овај догађај покреће РеплицаСет контролер, који је подпроцес менаџера контролера. РеплицаСет контролер надгледа креирање, ажурирање и брисање РеплицаСет ресурса у продавници и прима обавештење о догађају када се то догоди.

Посао РеплицаСет контролера је да обезбеди да постоји потребан број РеплицаСет подова. У нашем примеру још увек нема подова, тако да РеплицаСет контролер креира ове дефиниције модула (према шаблону под у дефиницији РеплицаСет-а) и складишти их у складишту.

Креирање нових подова покреће планер који прати дефиниције подова које још нису заказане за радне чворове. Планер бира одговарајући радни чвор за сваки под и ажурира дефиниције модула у спремишту.

Имајте на уму да до ове тачке нигде у кластеру није био покренут код радног оптерећења. Све што је до сада урађено - ово је креирање и ажурирање ресурса у спремишту на главном чвору.

Последњи догађај покреће Кубелетс, који надгледају подове заказане за њихове радне чворове. Кубелет радног чвора на коме су инсталирани ваши РеплицаСет подови мора да наложи времену извођења контејнера, као што је Доцкер, да преузме потребне слике контејнера и покрене их.

У овом тренутку, ваша РеплицаСет апликација коначно ради!

Улога Кубернетес АПИ-ја

Као што сте видели у претходном примеру, Кубернетес компоненте (осим АПИ сервера и складишта) прате промене ресурса у складишту и мењају информације о ресурсима у складишту.

Наравно, ове компоненте не комуницирају директно са складиштем, већ само преко Кубернетес АПИ-ја.

Размотрите следеће примере:

1. РеплицаСет контролер користи АПИ крајњу тачку лист РеплицаСетс са параметром watch за праћење промена у РеплицаСет ресурсима.
2. РеплицаСет контролер користи АПИ крајњу тачку креирај Под (креирати под) за креирање махуна.
3. Планер користи АПИ крајњу тачку патцх под (уреди под) да ажурирате подове са информацијама о изабраном радном чвору.

Као што видите, ово је исти АПИ којем кубецтл приступа. Коришћење истог АПИ-ја за интерне компоненте и екстерне кориснике је основни концепт у дизајну Кубернетес-а.

Сада можемо да сумирамо како Кубернетес функционише:

1. Складишни простори наводе, односно Кубернетес ресурсе.
2. АПИ сервер обезбеђује интерфејс за складиште у облику Кубернетес АПИ-ја.
3. Све остале Кубернетес компоненте и корисници читају, посматрају и манипулишу Кубернетес стањем (ресурсима) преко АПИ-ја.

Познавање ових концепата ће вам помоћи да боље разумете кубецтл и извучете максимум из њега.

Хајде сада да погледамо неке специфичне савете и трикове који ће вам помоћи да побољшате вашу продуктивност помоћу кубецтл-а.

1. Убрзајте унос помоћу довршавања команде

Једна од најкориснијих, али често занемарених техника за побољшање перформанси помоћу кубецтл-а је довршавање команде.

Довршавање команде вам омогућава да аутоматски довршите делове кубецтл команди помоћу тастера Таб. Ово функционише за подкоманде, опције и аргументе, укључујући нешто тако сложено као што су имена ресурса.

Погледајте како функционише довршавање команде кубецтл:

Довршавање команде ради за Басх и Зсх шкољке.

Службени водич садржи детаљна упутства за подешавање аутоматског довршавања, али у наставку ћемо дати кратак извод.

Како функционише довршавање команде

Довршавање наредбе је функција љуске која ради помоћу скрипте за довршавање. Скрипта екстензије је схелл скрипта која дефинише понашање екстензије за одређену команду.

Кубецтл аутоматски генерише и емитује скрипте проширења за Басх и Зсх користећи следеће команде:

$ kubectl completion bash

Или:

$ kubectl completion zsh

У теорији, довољно је повезати излаз ових команди са одговарајућом командном љуском како би кубецтл могао да допуни команде.

У пракси, начин повезивања је другачији за Басх (укључујући разлике између Линук-а и МацОС-а) и Зсх. У наставку ћемо погледати све ове опције.

Басх на Линук-у

Басх скрипта за завршетак зависи од басх-цомплетион пакета, тако да морате прво да је инсталирате:

$ sudo apt-get install bash-completion

Или:

$ yum install bash-completion

Можете тестирати да ли је пакет успешно инсталиран помоћу следеће команде:

$ type _init_completion

Ако ово даје код функције љуске, онда је басх-цомплетион исправно инсталиран. Ако команда даје грешку „Није пронађено“, морате да додате следећи ред у своју датотеку ~ / .bashrc:

$ source /usr/share/bash-completion/bash_completion

Да ли је потребно додати ову линију у датотеку ~ / .bashrc или не зависи од менаџера пакета који сте користили да инсталирате басх-цомплетион. Ово је неопходно за АПТ, али не и за ИУМ.

Након инсталирања басх-цомплетион-а, потребно је да све конфигуришете тако да скрипта за завршетак кубецтл буде омогућена у свим сесијама љуске.

Један од начина да то урадите је додавање следећег реда у датотеку ~ / .bashrc:

source <(kubectl completion bash)

Други начин је да додате скрипту екстензије кубецтл у директоријум /etc/bash_completion.d (креирајте га ако не постоји):

$ kubectl completion bash >/etc/bash_completion.d/kubectl

Све скрипте додатака у каталогу /etc/bash_completion.d се аутоматски укључују у басх-довршење.

Обе опције су подједнако применљиве.

Након поновног покретања љуске, завршетак команде кубецтл ће радити.

Басх на МацОС-у

На МацОС-у је подешавање мало компликованије. Чињеница је да МацОС подразумевано користи Басх верзију 3.2, а кубецтл скрипта за аутодовршавање захтева Басх верзију од најмање 4.1 и не ради у Басх 3.2.

Постоје проблеми са лиценцирањем повезани са коришћењем застареле верзије Басх-а на МацОС-у. Басх верзија 4 је лиценцирана под ГПЛв3, коју Аппле не подржава.

Да бисте конфигурисали кубецтл аутодовршавање на МацОС-у, потребно је да инсталирате новију верзију Басх-а. Такође можете поставити ажурирани Басх као подразумевану љуску, што ће вам уштедети много проблема у будућности. Није тешко, детаљи су дати у чланку „Ажурирање Басх-а на МацОС-у'.

Пре него што наставите, уверите се да користите најновију верзију Басх-а (проверите излаз bash --version).

Басх скрипта за завршетак зависи од пројекта басх-завршетак, тако да прво морате да га инсталирате.

Можете инсталирати басх-цомплетион користећи Хомебрев:

$ brew install bash-completion@2

Овде @2 означава басх-цомплетион верзију 2. кубецтл аутоцомплетион захтева басх-цомплетион в2, а басх-цомплетион в2 захтева минимум Басх верзију 4.1.

Командни излаз brew-install садржи одељак Упозорења, који наводи шта треба додати датотеци ~/.bash_profile:

export BASH_COMPLETION_COMPAT_DIR=/usr/local/etc/bash_completion.d
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . 
"/usr/local/etc/profile.d/bash_completion.sh"

Међутим, препоручујем да не додајете ове редове ~/.bash_profile, и у ~/.bashrc. У овом случају, аутодовршавање ће бити доступно не само у главној, већ иу подређеним командним шкољкама.

Након поновног покретања командне љуске, можете да проверите да ли је инсталација исправна помоћу следеће команде:

$ type _init_completion

Ако видите функцију љуске у излазу, онда је све исправно конфигурисано.

Сада морамо да обезбедимо да је кубецтл аутоматско довршавање омогућено у свим сесијама.

Један од начина је да додате следећи ред у свој ~/.bashrc:

source <(kubectl completion bash)

Други начин је додавање скрипте за аутоматско довршавање у фасциклу /usr/local/etc/bash_completion.d:

$ kubectl completion bash
>/usr/local/etc/bash_completion.d/kubectl

Овај метод ће радити само ако сте инсталирали басх-цомплетион користећи Хомебрев. У овом случају, басх-цомплетион учитава све скрипте из овог директоријума.

Ако сте инсталирали кубецтл користећи Хомебрев, онда нема потребе да извршите претходни корак, пошто ће скрипта за аутоматско довршавање аутоматски бити смештена у фасциклу /usr/local/etc/bash_completion.d током инсталације. У овом случају, кубецтл аутоцомплетион ће почети да ради чим инсталирате басх-цомплетион.

Као резултат, све ове опције су еквивалентне.

Зсх

Скрипте за аутоматско довршавање за Зсх не захтевају никакве зависности. Све што треба да урадите је да их омогућите када учитате командну љуску.

То можете учинити додавањем линије у свој ~/.zshrc фајл:

source <(kubectl completion zsh)

Ако добијете грешку not found: compdef након поновног покретања љуске, потребно је да омогућите уграђену функцију compdef. Можете га омогућити додавањем на почетак датотеке ~/.zshrc следеће:

autoload -Uz compinit
compinit

2. Брзо погледајте спецификације ресурса

Када креирате дефиниције ИАМЛ ресурса, морате знати поља и њихово значење за те ресурсе. Једно место за тражење ових информација је у АПИ референци, која садржи комплетне спецификације за све ресурсе.

Међутим, прелазак на веб претраживач сваки пут када треба да тражите нешто је незгодно. Стога кубецтл обезбеђује команду kubectl explain, који приказује спецификације свих ресурса директно у вашем терминалу.

Формат команде је следећи:

$ kubectl explain resource[.field]...

Команда ће дати спецификацију траженог ресурса или поља. Приказане информације су идентичне онима садржаним у приручнику за АПИ.

Подразумевано kubectl explain приказује само први ниво угнежђења поља.

Погледајте како то изгледа може бити овде.

Можете приказати цело стабло ако додате опцију --recursive:

$ kubectl explain deployment.spec --recursive

Ако не знате тачно који су ресурси потребни, можете их све приказати следећом командом:

$ kubectl api-resources

Ова команда приказује имена ресурса у облику множине, нпр. deployments уместо deployment. Такође приказује кратко име, на пример deploy, за оне ресурсе који га имају. Не брините о овим разликама. Све ове опције именовања су еквивалентне за кубецтл. То јест, можете користити било који од њих за kubectl explain.

Све следеће команде су еквивалентне:

$ kubectl explain deployments.spec
# или
$ kubectl explain deployment.spec
# или        
$ kubectl explain deploy.spec

3. Користите прилагођени излазни формат колоне

Подразумевани формат излаза команде kubectl get:

$ kubectl get pods
NAME                     READY    STATUS    RESTARTS  AGE
engine-544b6b6467-22qr6   1/1     Running     0       78d
engine-544b6b6467-lw5t8   1/1     Running     0       78d
engine-544b6b6467-tvgmg   1/1     Running     0       78d
web-ui-6db964458-8pdw4    1/1     Running     0       78d

Овај формат је згодан, али садржи ограничену количину информација. У поређењу са пуним форматом дефиниције ресурса, овде је приказано само неколико поља.

У овом случају, можете користити прилагођени излазни формат колоне. Омогућава вам да одредите које податке желите да избаците. Можете приказати било које поље ресурса као засебну колону.

Употреба прилагођеног формата се одређује помоћу опција:

-o custom-columns=<header>:<jsonpath>[,<header>:<jsonpath>]...

Можете дефинисати сваку излазну колону као пар <header>:<jsonpath>Где <header> је назив колоне и <jsonpath> — израз који дефинише поље ресурса.

Погледајмо једноставан пример:

$ kubectl get pods -o custom-columns='NAME:metadata.name'

NAME
engine-544b6b6467-22qr6
engine-544b6b6467-lw5t8
engine-544b6b6467-tvgmg
web-ui-6db964458-8pdw4

Излаз садржи једну колону са именима подова.

Израз опције бира имена подова из поља metadata.name. То је зато што је име капсуле дефинисано у пољу имена детета metadata у опису ресурса под. Више детаља можете пронаћи у АПИ водич или откуцајте команду kubectl explain pod.metadata.name.

Сада рецимо да желите да додате додатну колону излазу, на пример да прикажете чвор на којем се изводи сваки под. Да бисте то урадили, можете једноставно додати одговарајућу спецификацију колоне у опцију прилагођених колона:

$ kubectl get pods 
  -o custom-columns='NAME:metadata.name,NODE:spec.nodeName'

NAME                       NODE
engine-544b6b6467-22qr6    ip-10-0-80-67.ec2.internal
engine-544b6b6467-lw5t8    ip-10-0-36-80.ec2.internal
engine-544b6b6467-tvgmg    ip-10-0-118-34.ec2.internal
web-ui-6db964458-8pdw4     ip-10-0-118-34.ec2.internal

Израз бира име чвора из spec.nodeName — када је под додељен чвору, његово име се уписује у поље spec.nodeName спецификација ресурса под. Детаљније информације се могу наћи у излазу kubectl explain pod.spec.nodeName.

Имајте на уму да поља ресурса Кубернетес разликују велика и мала слова.

Можете да видите било које поље ресурса као колону. Само прегледајте спецификацију ресурса и испробајте је са свим пољима која вам се свиђају.

Али прво, хајде да ближе погледамо изразе за избор поља.

ЈСОНПатх изрази

Изрази за избор поља ресурса се заснивају на ЈСОНПатх.

ЈСОНПатх је језик за преузимање података из ЈСОН докумената. Одабир једног поља је најједноставнији случај употребе за ЈСОНПатх. Има много већи глас, укључујући бираче, филтере и тако даље.

Кубецтл објашњење подржава ограничен број ЈСОНПатх функција. Могућности и примери њихове употребе описани су у наставку:

# Выбрать все элементы списка
$ kubectl get pods -o custom-columns='DATA:spec.containers[*].image'
# Выбрать специфический элемент списка
$ kubectl get pods -o custom-columns='DATA:spec.containers[0].image'
# Выбрать элементы списка, попадающие под фильтр
$ kubectl get pods -o custom-columns='DATA:spec.containers[?(@.image!="nginx")].image'
# Выбрать все поля по указанному пути, независимо от их имени
$ kubectl get pods -o custom-columns='DATA:metadata.*'
# Выбрать все поля с указанным именем, вне зависимости от их расположения
$ kubectl get pods -o custom-columns='DATA:..image'

Оператор [] је посебно важан. Многа поља ресурса Кубернетес-а су листе, а овај оператор вам омогућава да изаберете чланове тих листа. Често се користи са џокер знаком као што је [*] за одабир свих елемената листе.

Примери примене

Могућности за коришћење прилагођеног излазног формата колоне су бескрајне, јер можете приказати било које поље или комбинацију поља ресурса у излазу. Ево неких примера апликација, али слободно их истражите и пронађите апликације које вам одговарају.

1. Приказ слика контејнера за махуне:

   $ kubectl get pods 
     -o custom-columns='NAME:metadata.name,IMAGES:spec.containers[*].image'
   
   NAME                        IMAGES
   engine-544b6b6467-22qr6     rabbitmq:3.7.8-management,nginx
   engine-544b6b6467-lw5t8     rabbitmq:3.7.8-management,nginx
   engine-544b6b6467-tvgmg     rabbitmq:3.7.8-management,nginx
   web-ui-6db964458-8pdw4      wordpress

   Ова команда приказује називе слика контејнера за сваки под.

   Запамтите да под може да садржи неколико контејнера, тада ће имена слика бити приказана у једном реду, одвојена зарезима.

2. Приказ зона доступности чворова:

   $ kubectl get nodes 
     -o 
   custom-columns='NAME:metadata.name,ZONE:metadata.labels.failure-domain.beta.kubernetes.io/zone'
   
   NAME                          ZONE
   ip-10-0-118-34.ec2.internal   us-east-1b
   ip-10-0-36-80.ec2.internal    us-east-1a
   ip-10-0-80-67.ec2.internal    us-east-1b

   Ова команда је корисна ако је ваш кластер хостован у јавном облаку. Приказује зону доступности за сваки чвор.

   Зона доступности је концепт облака који ограничава зону репликације на географски регион.

   Зоне доступности за сваки чвор се добијају преко посебне ознаке - failure-domain.beta.kubernetes.io/zone. Ако кластер ради у јавном облаку, ова ознака се аутоматски креира и попуњава називима зона доступности за сваки чвор.

   Ознаке нису део спецификације Кубернетес ресурса, тако да нећете наћи информације о њима АПИ водич. Међутим, могу се видети (као и све друге ознаке) ако затражите информације о чворовима у ИАМЛ или ЈСОН формату:

   $ kubectl get nodes -o yaml
   # или
   $ kubectl get nodes -o json

   Ово је одличан начин да сазнате више о ресурсима, поред учења спецификација ресурса.

4. Лако прелазите између кластера и именских простора

Када кубецтл упути захтев Кубернетес АПИ-ју, он прво чита кубецонфиг датотеку да би добио све потребне параметре за везу.

Подразумевано је кубецонфиг датотека ~/.kube/config. Обично се ова датотека креира или ажурира посебном командом.

Када радите са више кластера, ваша кубецонфиг датотека садржи подешавања за повезивање са свим тим кластерима. Потребан вам је начин да кажете команди кубецтл са којим кластером радите.

Унутар кластера, можете креирати више именских простора — тип виртуелног кластера унутар физичког кластера. Кубецтл такође одређује који простор имена ће користити на основу кубецонфиг датотеке. То значи да вам је такође потребан начин да кажете команди кубецтл са којим именским простором да ради.

У овом поглављу ћемо објаснити како функционише и како да ефикасно функционише.

Имајте на уму да можда имате више датотека кубецонфиг наведених у променљивој окружења КУБЕЦОНФИГ. У овом случају, све ове датотеке ће бити комбиноване у једну заједничку конфигурацију током времена извршавања. Такође можете променити подразумевану кубецонфиг датотеку тако што ћете покренути кубецтл са параметром --kubeconfig. Погледај званична документација.

кубецонфиг датотеке

Хајде да видимо шта тачно садржи датотека кубецонфиг:

Као што видите, датотека кубецонфиг садржи скуп контекста. Контекст се састоји од три елемента:

• Кластер — АПИ УРЛ сервера кластера.
• Корисник - акредитиви за аутентификацију корисника у кластеру.
• Именски простор - именски простор који се користи приликом придруживања кластеру.

У пракси, они често користе један контекст по кластеру у свом кубецонфигу. Међутим, можете имати више контекста по кластеру, који се разликују по кориснику или именском простору. Међутим, ова конфигурација са више контекста је неуобичајена, тако да обично постоји мапирање један-на-један између кластера и контекста.

У сваком тренутку, један од контекста је актуелан:

Када кубецтл чита конфигурациону датотеку, увек узима информације из тренутног контекста. У горњем примеру, кубецтл ће се повезати са Харе кластером.

Сходно томе, да бисте прешли на други кластер, потребно је да промените тренутни контекст у датотеци кубецонфиг:

Сада ће се кубецтл повезати са Фок кластером.

Да бисте прешли на други именски простор у истом кластеру, потребно је да промените вредност елемента именског простора за тренутни контекст:

У горњем примеру, кубецтл ће користити Прод именски простор Фок кластера (претходно је постављен простор имена Тест).

Имајте на уму да кубецтл такође нуди опције --cluster, --user, --namespace и --context, који вам омогућавају да препишете појединачне елементе и сам тренутни контекст, без обзира на то шта је подешено у кубецонфиг-у. Погледај kubectl options.

У теорији, можете ручно променити подешавања у кубецонфиг-у. Али то је незгодно. Да бисте поједноставили ове операције, постоје различити услужни програми који вам омогућавају да аутоматски мењате параметре.

Користите кубецтк

Веома популаран услужни програм за пребацивање између кластера и именских простора.

Услужни програм обезбеђује команде kubectx и kubens да промените тренутни контекст и именски простор.

Као што је поменуто, промена тренутног контекста значи промену кластера ако имате само један контекст по кластеру.

Ево примера покретања ових команди:

У суштини, ове команде једноставно уређују кубецонфиг датотеку као што је горе описано.

за инсталацију kubectx, пратите упутства на Гитхуб.

Обе команде подржавају аутоматско довршавање имена контекста и именског простора, што елиминише потребу да се у потпуности откуцају. Упутства за подешавање аутоматског довршавања овде.

Још једна корисна карактеристика kubectx је интерактивни режим. Ради заједно са услужним програмом фзф, који се мора инсталирати засебно. Инсталирање фзф-а аутоматски чини интерактивни режим доступним у kubectx. Интерактивно, можете изабрати контекст и именски простор кроз интерактивни бесплатни интерфејс за претрагу који обезбеђује фзф.

Коришћење псеудонима љуске

Не требају вам посебне алатке да промените тренутни контекст и простор имена јер кубецтл такође обезбеђује команде за ово. Да, тим kubectl config пружа подкоманде за уређивање кубецонфиг датотека.

Вот некоторие них:

• kubectl config get-contexts: приказ свих контекста;
• kubectl config current-context: добити тренутни контекст;
• kubectl config use-context: промените тренутни контекст;
• kubectl config set-context: Промените елемент контекста.

Међутим, директно коришћење ових команди није баш згодно јер су дугачке. За њих можете направити псеудониме љуске које је лако извршити.

Направио сам скуп алијаса на основу ових команди које пружају функционалност сличну кубецтк-у. Овде их можете видети у акцији:

Имајте на уму да псеудоними користе фзф да обезбеде интерактивни бесплатни интерфејс за тражење (као што је кубецтк-ов интерактивни режим). То значи да вам треба инсталл фзфда користимо ове псеудониме.

Ево дефиниција самих алијаса:

# Получить текущий контекст
alias krc='kubectl config current-context'
# Список всех контекстов
alias klc='kubectl config get-contexts -o name | sed "s/^/  /;|^  $(krc)$|s/ /*/"'
# Изменить текущий контекст
alias kcc='kubectl config use-context "$(klc | fzf -e | sed "s/^..//")"'

# Получить текущее пространство имен
alias krn='kubectl config get-contexts --no-headers "$(krc)" | awk "{print $5}" | sed "s/^$/default/"'
# Список всех пространств имен
alias kln='kubectl get -o name ns | sed "s|^.*/|  |;|^  $(krn)$|s/ /*/"'
# Изменить текущее пространство имен
alias kcn='kubectl config set-context --current --namespace "$(kln | fzf -e | sed "s/^..//")"'

Да бисте поставили ове псеудониме, морате додати горње дефиниције у своју датотеку ~/.bashrc или ~/.zshrc и поново покрените своју шкољку.

Коришћење додатака

Кубецтл вам омогућава да учитате додатке који се извршавају на исти начин као и основне команде. Можете, на пример, да инсталирате кубецтл-фоо додатак и да га покренете извршавањем команде kubectl foo.

Било би згодно променити контекст и именски простор на овај начин, на пример покретањем kubectl ctx да промени контекст и kubectl ns да промените именски простор.

Написао сам два додатка који ово раде:

• кубецтл-цтк
• кубецтл-нс

Рад додатака је заснован на псеудонима из претходног одељка.

Ево како функционишу:

Имајте на уму да додаци користе фзф да обезбеде интерактивни бесплатни интерфејс за претрагу (као што је интерактивни режим кубецтк-а). То значи да вам треба инсталл фзфда користимо ове псеудониме.

Да бисте инсталирали додатке, потребно је да преузмете схелл скрипте под називом кубецтл-цтк и кубецтл-нс у било који директоријум у вашој ПАТХ променљивој и учините их извршним са нпр. chmod +x. Одмах након тога моћи ћете да користите kubectl ctx и kubectl ns.

5. Смањите унос са аутоматским алиасима

Алијаси љуске су добар начин да се убрза унос. Пројекат кубецтл-алиасес садржи око 800 пречица за основне кубецтл команде.

Можда се питате – како памтите 800 алијаса? Али не морате их све запамтити, јер су изграђени према једноставној шеми, која је дата у наставку:

На пример:

1. кгпооиамл - кубецтл гет подс оиамл
2. ксисгсвцв — кубецтл -н кубе-систем гет свц в
3. ксисрмцм -кубецтл -н кубе-систем рм цм
4. кгдепаллсл - кубецтл добити имплементацију свих сл

Као што видите, алиаси се састоје од компоненти, од којих свака представља одређени елемент команде кубецтл. Сваки псеудоним може имати једну компоненту за основну команду, операцију и ресурс и више компоненти за параметре. Једноставно „насељате“ ове компоненте с лева на десно према дијаграму изнад.

Тренутни детаљни дијаграм је на ГитХуб. Тамо такође можете пронаћи пуна листа алијаса.

На пример, алиас кгпооиамлалл је еквивалентан команди kubectl get pods -o yaml --all-namespaces.

Релативни редослед опција није важан: команда kgpooyamlall је еквивалентна команди kgpoalloyaml.

Не морате да користите све компоненте као псеудониме. На пример k, kg, klo, ksys, kgpo такође се може користити. Штавише, можете комбиновати псеудониме и редовне команде или опције на командној линији:

На пример:

1. Уместо kubectl proxy можете написати k proxy.
2. Уместо kubectl get roles можете написати kg roles (тренутно не постоји псеудоним за ресурс Улоге).
3. Да бисте добили податке за одређени под, можете користити команду kgpo my-pod — kubectl get pod my-pod.

Имајте на уму да неки алиаси захтевају аргумент командне линије. На пример, алиас kgpol средства kubectl get pods -l. Опција -l захтева аргумент - спецификацију ознаке. Ако користите псеудоним, то ће изгледати тако kgpol app=ui.

Пошто неки алијаси захтевају аргументе, алијаси а, ф и л се морају користити последњи.

Уопштено говорећи, када се ухватите у коштац са овом шемом, можете интуитивно да изведете псеудониме из команди које желите да извршите и уштедите много времена за куцање.

Инсталација

Да бисте инсталирали кубецтл-алиасес, потребно је да преузмете датотеку .кубецтл_алиасес са ГитХуб-а и укључите га у датотеку ~/.bashrc или ~/.zshrc:

source ~/.kubectl_aliases

Аутоцомплетион

Као што смо раније рекли, често додајете додатне речи псеудониму на командној линији. На пример:

$ kgpooyaml test-pod-d4b77b989

Ако користите довршавање команде кубецтл, вероватно сте користили аутоматско довршавање за ствари као што су имена ресурса. Али да ли се то може урадити када се користе алиаси?

Ово је веома важно питање јер ако аутоматско довршавање не ради, изгубићете неке од предности алијаса.

Одговор зависи од тога коју шкољку користите:

1. За Зсх, довршавање псеудонима ради одмах.
2. За Басх, нажалост, потребно је мало труда да би аутоматско довршавање функционисало.

Омогућавање аутоматског довршавања за псеудониме у Басх-у

Проблем са Басх-ом је у томе што покушава да доврши (сваки пут када притиснете Таб) псеудоним, а не команду на коју се псеудоним односи (као Зсх, на пример). Пошто немате скрипте за довршавање за свих 800 алијаса, аутоматско довршавање не ради.

Пројекат потпуни алиас пружа опште решење за овај проблем. Повезује се са механизмом довршавања за псеудониме, интерно проширује псеудоним на команду и враћа опције довршавања за завршену команду. То значи да се допуна за алиас понаша потпуно исто као и за пуну команду.

У наставку ћу прво објаснити како да инсталирам комплетан алиас, а затим како да га конфигуришем да омогући завршетак за све кубецтл псеудониме.

Инсталирање комплетног алијаса

Пре свега, комплетан алиас зависи од басх-завршетак. Стога, пре него што инсталирате потпуни алиас, морате се уверити да је басх-цомплетион инсталиран. Упутства за инсталацију су претходно давана за Линук и МацОС.

Важна напомена за кориснике МацОС-а: Као и кубецтл скрипта за аутодовршавање, потпуни алиас не ради са Басх 3.2, што је подразумевано на МацОС-у. Конкретно, фулл-алиас зависи од басх-цомплетион в2 (brew install bash-completion@2), што захтева најмање Басх 4.1. То значи да за коришћење потпуног алијаса на МацОС-у морате да инсталирате новију верзију Басх-а.

Морате преузети скрипту басх_цомплетион.сх од ГитХуб спремиште и укључите га у своју датотеку ~/.bashrc:

source ~/bash_completion.sh

Након поновног покретања љуске, комплетан алиас ће бити у потпуности инсталиран.

Омогућавање аутоматског довршавања за кубецтл псеудониме

Технички комплетан алиас обезбеђује функцију омотача _complete_alias. Ова функција проверава псеудоним и враћа савете за завршетак за команду алиас.

Да бисте повезали функцију са одређеним алијасом, потребно је да користите уграђени Басх механизам завршити, за инсталацију _complete_alias као функција довршавања алијаса.

Као пример, узмимо псеудоним к, који означава команду кубецтл. за инсталацију _complete_alias Као функцију комплемента за овај алиас, требало би да покренете следећу команду:

$ complete -F _complete_alias k

Резултат овога је да кад год аутоматски довршите псеудоним к, функција се позива _complete_alias, који проверава псеудоним и враћа наговештаје за завршетак команде kubectl.

Као други пример, узмимо псеудоним kg, што означава kubectl get:

$ complete -F _complete_alias kg

Као у претходном примеру, када аутоматски допуните кг, добијате исте наговештаје за довршавање које бисте добили за kubectl get.

Имајте на уму да можете користити комплетан алиас за било који псеудоним на вашем систему.

Стога, да бисте омогућили аутоматско довршавање за све кубецтл псеудониме, потребно је да покренете горњу команду за сваки од њих. Следећи исечак ради управо то, под условом да сте подесили кубецтл-алиасес на ~/.kubectl-aliases:

for _a in $(sed '/^alias /!d;s/^alias //;s/=.*$//' ~/.kubectl_aliases); 
do
  complete -F _complete_alias "$_a"
done

Овај део кода треба да се стави у ваш ~/.bashrc, поново покрените командну љуску и аутоматско довршавање ће постати доступно за свих 800 кубецтл алијаса.

6. Проширивање кубецтл-а са додацима

Полазећи од верзија 1.12, кубецтл подржава механизам додатака, који вам омогућавају да проширите његове функције додатним командама.

Ако сте упознати са Механизми Гит додатака, онда су кубецтл додаци изграђени на истом принципу.

У овом поглављу ћемо покрити како да инсталирате додатке, где да их пронађете и како да креирате сопствене додатке.

Инсталирање додатака

Кубецтл додаци се дистрибуирају као једноставне извршне датотеке са именом као kubectl-x. Префикс kubectl- је обавезан, а затим следи нова кубецтл подкоманда која вам омогућава да позовете додатак.

На пример, додатак хелло ће бити дистрибуиран као датотека под називом kubectl-hello.

Да бисте инсталирали додатак, потребно је да копирате датотеку kubectl-x у било који директоријум у вашем ПАТХ и учините га извршним, на пример са chmod +x. Одмах након тога можете позвати додатак са kubectl x.

Можете користити следећу команду да наведете све додатке који су тренутно инсталирани на вашем систему:

$ kubectl plugin list

Ова команда ће такође приказати упозорења ако имате више додатака са истим именом или ако постоји датотека додатака која није извршна.

Проналажење и инсталирање додатака користећи Крев

Кубецтл додаци се могу делити или поново користити као софтверски пакети. Али где можете пронаћи додатке које су други поделили?

Пројецт Крев има за циљ да обезбеди јединствено решење за дељење, претрагу, инсталирање и управљање кубецтл додацима. Пројекат себе назива „менаџер пакета за кубецтл додатке“ (Крев је сличан скувати).

Крев је листа кубецтл додатака које можете изабрати и инсталирати. У исто време, Крев је такође додатак за кубецтл.

То значи да инсталирање Крев-а у суштини функционише као инсталирање било ког другог кубецтл додатка. Детаљна упутства можете пронаћи на ГитХуб страница.

Најважније Крев команде су:

# Поиск в списке плагинов
$ kubectl krew search [<query>]
# Посмотреть информацию о плагине
$ kubectl krew info <plugin>
# Установить плагин
$ kubectl krew install <plugin>
# Обновить все плагины до последней версии
$ kubectl krew upgrade
# Посмотреть все плагины, установленные через Krew
$ kubectl krew list
# Деинсталлировать плагин
$ kubectl krew remove <plugin>

Имајте на уму да инсталирање додатака помоћу Крев-а не омета инсталирање додатака користећи стандардни метод описан горе.

Имајте на уму да команда kubectl krew list приказује само додатке који су инсталирани помоћу Крев-а, док команда kubectl plugin list наводи све додатке, односно оне инсталиране помоћу Крев-а и оне инсталиране на друге методе.

Проналажење додатака на другом месту

Крев је млад пројекат, тренутно у свом раду листа само око 30 додатака. Ако не можете да пронађете оно што вам је потребно, додатне компоненте можете пронаћи негде другде, као што је ГитХуб.

Препоручујем да погледате ГитХуб одељак кубецтл-плугинс. Тамо ћете наћи десетине доступних додатака које вреди проверити.

Писање сопствених додатака

можете сами креирајте додатке - Није тешко. Морате да креирате извршни фајл који ради оно што вам је потребно, дајте му име kubectl-x и инсталирајте како је горе описано.

Датотека може бити басх скрипта, питхон скрипта или компајлирана ГО апликација - није важно. Једини услов је да се може директно извршити у оперативном систему.

Хајде да одмах направимо пример додатка. У претходном одељку, користили сте команду кубецтл да бисте навели контејнере за сваки под. Ову команду је лако претворити у додатак који можете позвати са нпр. kubectl img.

Креирајте датотеку kubectl-img следећи садржај:

#!/bin/bash
kubectl get pods -o custom-columns='NAME:metadata.name,IMAGES:spec.containers[*].image'

Сада учините датотеку извршном са chmod +x kubectl-img и преместите га у било који директоријум у вашем ПАТХ. Одмах након тога можете користити додатак kubectl img.

Као што је поменуто, кубецтл додаци могу бити написани у било ком програмском или скрипт језику. Ако користите схелл скрипте, предност је што можете лако да позовете кубецтл из додатка. Међутим, можете писати сложеније додатке на стварним програмским језицима користећи Кубернетес клијентска библиотека. Ако користите Го, такође можете да користите кли-рунтиме библиотека, који постоји посебно за писање кубецтл додатака.

Како да делите своје додатке

Ако мислите да би ваши додаци могли бити корисни другима, слободно их поделите на ГитХуб-у. Обавезно их додајте у тему кубецтл-плугинс.

Такође можете затражити да се дода ваш додатак Крев лист. Упутства о томе како то учинити су у ГитХуб спремишта.

Завршетак команде

Додаци тренутно не подржавају аутоматско довршавање. То јест, морате унети пуно име додатка и пуна имена аргумената.

ГитХуб кубецтл спремиште за ову функцију има отворени захтев. Дакле, могуће је да ће ова функција бити имплементирана некада у будућности.

Срећно!!!

Шта још читати на тему:

1. Три нивоа аутоматског скалирања у Кубернетесу и како их ефикасно користити.
2. Кубернетес у духу пиратерије са шаблоном за имплементацију.
3. Наш канал Око Кубернетеса у Телеграму.

Извор: ввв.хабр.цом