Лако управљајте конфигурацијама микросервиса помоћу мицроцонфиг.ио

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

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

Погледајмо пример. Рецимо да имамо једноставну апликацију са конфигурационим фајлом иамл. Ово може бити било која микросервис на било ком језику. Хајде да видимо како се оквир може применити на ову услугу.

Али прво, ради веће погодности, хајде да направимо празан пројекат у Идеа ИДЕ, након што смо инсталирали додатак мицроцонфиг.ио у њега:

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

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

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

Структура датотеке дев.иамл биће прилично једноставно:

mainorder:
    components:
         - order

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

У самој датотеци поставки услуге налог Хајде да наведемо само један параметар за сада:

spring.application.name: order

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

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

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

Хајде да додамо још једну услугу плаћање и компликовати постојећу.
В налог:

eureka:
 instance.preferIpAddress: true
 client:
   serviceUrl:
     defaultZone: http://192.89.89.111:6782/eureka/
server.port: 9999
spring.application.name: order
db.url: 192.168.0.100

В плаћање:

eureka:
 instance.preferIpAddress: true
 client:
   serviceUrl:
     defaultZone: http://192.89.89.111:6782/eureka/
server.port: 9998
spring.application.name: payments
db.url: 192.168.0.100

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

А сада додајмо линију сваком нашем пројекту #инцлуде еурека.

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

#include eureka
server.port: 9999
spring.application.name: order
db.url: 192.168.0.100

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

Вреди напоменути да оквир прати сваку промену приликом регенерисања конфигурационих датотека и смешта је у посебну датотеку поред главне конфигурационе датотеке. Унос у његовом дневнику изгледа овако: „Спремљено 1 својство се мења у ордер/дифф-апплицатион.иамл" Ово вам омогућава да брзо откријете промене у великим конфигурационим датотекама.

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

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

 client:
   serviceUrl:
     defaultZone: http://${endpoints@eurekaip}:6782/eureka/

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

Садржај Дев датотеке:

eurekaip: 192.89.89.111
dbip: 192.168.0.100

Можемо креирати исту конфигурацију за портове наших услуга:

server.port: ${ports@order}.

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

Оквир пружа много готових чувара места, на пример, можете добити име директоријума у ​​којем се налази конфигурациона датотека и доделити га:

#include eureka, oracle
server.port: ${ports@order}
spring.application.name: ${this@name}

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

client:
   serviceUrl:
     defaultZone: http://${endpoints@eurekaip}:6782/eureka/
 spring.application.name: ${this@name}

Конфигурациони фајл налог биће сведено на један ред:

#include eureka, oracle
server.port: ${ports@order}

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

Рецимо да морате да додате прилагођена подешавања евиденције у услугу, која се чувају у посебној датотеци, на пример, логбацк.кмл. Хајде да направимо засебну групу подешавања за то:

У основној конфигурацији, рећи ћемо оквиру где да поставимо датотеку подешавања евиденције која нам је потребна помоћу чувара места @ЦонфигДир:

microconfig.template.logback.fromFile: ${logback@configDir}/logback.xml

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

<file>logs/${this@name}.log</file>

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

#include eureka, oracle, logback
server.port: ${ports@order}

Време је да се детаљније упознате са свим доступним чуварима места оквира:

${тхис@енв} - враћа име тренутног окружења.
${…@наме} — враћа назив компоненте.
${…@цонфигДир} — враћа пуну путању до конфигурационог директоријума компоненте.
${…@ресултДир} — враћа пуну путању до одредишног директоријума компоненте (резултујуће датотеке ће бити смештене у овај директоријум).
${тхис@цонфигРоот} — враћа пуну путању до основног директоријума складишта конфигурација.

Систем вам такође омогућава да добијете променљиве окружења, на пример путању до јава:
${енв@ЈАВА_ХОМЕ}
Или, пошто је оквир уписан ЈАВА, можемо добити системске променљиве сличне позиву Систем::гетПроперти користећи структуру попут ове:
${[емаил заштићен]}
Вреди поменути подршку за језик проширења Спринг ЕЛ. Следећи изрази су применљиви у конфигурацији:

connection.timeoutInMs: #{5 * 60 * 1000}
datasource.maximum-pool-size: #{${[email protected]} + 10} 

и можете користити локалне променљиве у конфигурационим датотекама користећи израз #вар:

#var feedRoot: ${[email protected]}/feed
folder:
 root: ${this@feedRoot}
 success: ${this@feedRoot}/archive
 error: ${this@feedRoot}/error

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

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

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