គ្រប់គ្រងការកំណត់រចនាសម្ព័ន្ធមីក្រូសេវាយ៉ាងងាយស្រួលជាមួយ microconfig.io

បញ្ហាចម្បងមួយក្នុងការអភិវឌ្ឍន៍ និងប្រតិបត្តិការជាបន្តបន្ទាប់នៃសេវាកម្មមីក្រូគឺការកំណត់រចនាសម្ព័ន្ធមានសមត្ថកិច្ច និងត្រឹមត្រូវនៃករណីរបស់ពួកគេ។ តាមគំនិតរបស់ខ្ញុំ ក្របខ័ណ្ឌថ្មីអាចជួយក្នុងរឿងនេះបាន។ microconfig.io. វា​អនុញ្ញាត​ឱ្យ​អ្នក​ដោះស្រាយ​ភារកិច្ច​កំណត់​រចនាសម្ព័ន្ធ​កម្មវិធី​ទម្លាប់​មួយ​ចំនួន​យ៉ាង​ប្រណិត។

ប្រសិនបើអ្នកមានសេវាមីក្រូជាច្រើន ហើយពួកវានីមួយៗភ្ជាប់មកជាមួយឯកសារ/ឯកសារកំណត់រចនាសម្ព័ន្ធផ្ទាល់ខ្លួនរបស់វា នោះមានប្រូបាបខ្ពស់ក្នុងការបង្កើតកំហុសមួយក្នុងចំនោមពួកគេ ដែលអាចពិបាកនឹងចាប់បានដោយគ្មានជំនាញត្រឹមត្រូវ និងប្រព័ន្ធកត់ត្រា។ ភារកិច្ចចម្បងដែលក្របខ័ណ្ឌកំណត់សម្រាប់ខ្លួនវាគឺដើម្បីកាត់បន្ថយប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធវត្ថុដែលស្ទួនជាអប្បបរមា ដោយកាត់បន្ថយលទ្ធភាពនៃការបន្ថែមកំហុស។

សូមក្រឡេកមើលឧទាហរណ៍មួយ។ ឧបមាថាយើងមានកម្មវិធីសាមញ្ញមួយដែលមានឯកសារកំណត់រចនាសម្ព័ន្ធ យ៉ាមល. នេះអាចជាសេវាមីក្រូណាមួយនៅក្នុងភាសាណាមួយ។ សូមមើលពីរបៀបដែលក្របខ័ណ្ឌអាចត្រូវបានអនុវត្តចំពោះសេវាកម្មនេះ។

ប៉ុន្តែជាដំបូង ដើម្បីភាពងាយស្រួលកាន់តែច្រើន យើងបង្កើតគម្រោងទទេមួយនៅក្នុង Idea IDE បន្ទាប់ពីដំឡើងកម្មវិធីជំនួយ microconfig.io នៅក្នុងវា៖

យើងរៀបចំការកំណត់រចនាសម្ព័ន្ធការបើកដំណើរការកម្មវិធីជំនួយ អ្នកអាចប្រើការកំណត់លំនាំដើមដូចនៅក្នុងរូបថតអេក្រង់ខាងលើ។

សេវាកម្មរបស់យើងត្រូវបានគេហៅថាលំដាប់ បន្ទាប់មកនៅក្នុងគម្រោងថ្មី យើងនឹងបង្កើតរចនាសម្ព័ន្ធស្រដៀងគ្នានេះ៖

ដាក់ឯកសារកំណត់រចនាសម្ព័ន្ធនៅក្នុងថតដែលមានឈ្មោះសេវាកម្ម - application.yaml. សេវាកម្មមីក្រូទាំងអស់ត្រូវបានដាក់ឱ្យដំណើរការនៅក្នុងប្រភេទនៃបរិស្ថានមួយចំនួន ដូច្នេះបន្ថែមលើការបង្កើតការកំណត់សម្រាប់សេវាកម្មខ្លួនវា ចាំបាច់ត្រូវពណ៌នាអំពីបរិស្ថានដោយខ្លួនឯង៖ សម្រាប់បញ្ហានេះយើងនឹងបង្កើតថតឯកសារ envs ហើយបន្ថែមឯកសារទៅវាជាមួយឈ្មោះនៃបរិយាកាសការងាររបស់យើង។ ដូច្នេះ ក្របខ័ណ្ឌនឹងបង្កើតឯកសារកំណត់រចនាសម្ព័ន្ធសម្រាប់សេវាកម្មនៅក្នុងបរិស្ថាន devចាប់តាំងពីប៉ារ៉ាម៉ែត្រនេះត្រូវបានកំណត់នៅក្នុងការកំណត់កម្មវិធីជំនួយ។

រចនាសម្ព័ន្ធឯកសារ dev.yaml វានឹងសាមញ្ញណាស់៖

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

បញ្ហាចម្បងជាមួយនឹងការកំណត់ទាំងនេះគឺវត្តមាននៃចំនួនដ៏ច្រើននៃការចម្លងបិទភ្ជាប់នៅក្នុងការកំណត់សេវាកម្ម។ តោះមើលពីរបៀបដែលក្របខ័ណ្ឌនឹងជួយកម្ចាត់វា។ ចូរចាប់ផ្តើមដោយជាក់ស្តែងបំផុត - វត្តមាននៃការកំណត់រចនាសម្ព័ន្ធ អ៊ូរី នៅក្នុងការពិពណ៌នាអំពីសេវាមីក្រូនីមួយៗ។ តោះ​បង្កើត​ថត​ថ្មី​ជាមួយ​ឯកសារ​ការ​កំណត់ ហើយ​បន្ថែម​ការ​កំណត់​ថ្មី​ទៅ​វា៖

ហើយឥឡូវនេះ ចូរបន្ថែមបន្ទាត់ទៅគម្រោងនីមួយៗរបស់យើង។ # រួមបញ្ចូល eureka.

ក្របខណ្ឌនឹងស្វែងរកការកំណត់រចនាសម្ព័ន្ធ eureka ដោយស្វ័យប្រវត្តិ ហើយចម្លងវាទៅឯកសារកំណត់រចនាសម្ព័ន្ធសេវាកម្ម ខណៈដែលការកំណត់រចនាសម្ព័ន្ធ eureka ដាច់ដោយឡែកនឹងមិនត្រូវបានបង្កើតទេ ដោយសារយើងនឹងមិនបញ្ជាក់វានៅក្នុងឯកសារបរិស្ថាន dev.yaml. ស្វីស ការបញ្ជាទិញ:

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

យើងក៏អាចផ្លាស់ទីការកំណត់មូលដ្ឋានទិន្នន័យទៅជាការកំណត់រចនាសម្ព័ន្ធដាច់ដោយឡែកដោយផ្លាស់ប្តូរបន្ទាត់នាំចូលទៅ # រួមបញ្ចូល eureka, oracle.

វាគួរឱ្យកត់សម្គាល់ថាក្របខ័ណ្ឌតាមដានការផ្លាស់ប្តូរនីមួយៗនៅពេលបង្កើតឯកសារកំណត់រចនាសម្ព័ន្ធឡើងវិញហើយដាក់វានៅក្នុងឯកសារពិសេសមួយនៅជាប់នឹងឯកសារកំណត់រចនាសម្ព័ន្ធសំខាន់។ ធាតុ​ក្នុង​កំណត់​ហេតុ​របស់​វា​មើល​ទៅ​ដូច​នេះ៖ “បាន​រក្សា​ទុក 1 ទ្រព្យ​សម្បត្តិ​ផ្លាស់​ប្តូរ​ទៅ order/diff-application.yaml" នេះអនុញ្ញាតឱ្យអ្នករកឃើញការផ្លាស់ប្តូរយ៉ាងឆាប់រហ័សចំពោះឯកសារកំណត់រចនាសម្ព័ន្ធធំ។

ការដកផ្នែកទូទៅនៃការកំណត់ចេញអនុញ្ញាតឱ្យអ្នកកម្ចាត់ការចម្លងបិទភ្ជាប់ដែលមិនចាំបាច់ជាច្រើន ប៉ុន្តែមិនអនុញ្ញាតឱ្យអ្នកបង្កើតការកំណត់រចនាសម្ព័ន្ធដោយភាពបត់បែនសម្រាប់បរិស្ថានផ្សេងៗនោះទេ ចំណុចបញ្ចប់នៃសេវាកម្មរបស់យើងគឺមានតែមួយគត់ និងពិបាកសរសេរកូដ វាអាក្រក់ណាស់។ តោះព្យាយាមលុបវាចេញ។

ដំណោះស្រាយដ៏ល្អគឺត្រូវរក្សាចំណុចបញ្ចប់ទាំងអស់នៅក្នុងការកំណត់រចនាសម្ព័ន្ធមួយដែលអ្នកដទៃអាចយោងបាន។ ចំពោះគោលបំណងនេះ ការគាំទ្រសម្រាប់កន្លែងដាក់ត្រូវបានណែនាំទៅក្នុងក្របខ័ណ្ឌ។ នេះជារបៀបដែលឯកសារកំណត់រចនាសម្ព័ន្ធនឹងផ្លាស់ប្តូរ អ៊ូរី:

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

ឥឡូវនេះសូមមើលពីរបៀបដែលកន្លែងដាក់នេះដំណើរការ។ ប្រព័ន្ធស្វែងរកសមាសធាតុដែលមានឈ្មោះ ចំណុចបញ្ចប់ ហើយស្វែងរកអត្ថន័យនៅក្នុងវា។ អឺរ៉ូកៃបហើយបន្ទាប់មកជំនួសវាទៅក្នុងការកំណត់រចនាសម្ព័ន្ធរបស់យើង។ ប៉ុន្តែចុះយ៉ាងណាចំពោះបរិស្ថានផ្សេងៗគ្នា? ដើម្បីធ្វើដូចនេះបង្កើតឯកសារការកំណត់នៅក្នុង ចំណុចបញ្ចប់ ប្រភេទខាងក្រោម application.dev.yaml. ក្របខ័ណ្ឌដោយឯករាជ្យ ដោយផ្អែកលើផ្នែកបន្ថែមឯកសារ សម្រេចថាតើបរិយាកាសណាមួយដែលការកំណត់រចនាសម្ព័ន្ធនេះជាកម្មសិទ្ធិ និងផ្ទុកវា៖

ខ្លឹមសារឯកសារ Dev៖

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}

សូមអរគុណដល់ការនេះ វាមិនចាំបាច់បញ្ជាក់បន្ថែមអំពីឈ្មោះកម្មវិធីនៅក្នុងការកំណត់រចនាសម្ព័ន្ធនោះទេ ហើយវាក៏អាចត្រូវបានដាក់នៅក្នុងម៉ូឌុលទូទៅផងដែរ ឧទាហរណ៍នៅក្នុង eureka ដូចគ្នា៖

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

ឯកសារកំណត់រចនាសម្ព័ន្ធ ការបញ្ជាទិញ នឹងត្រូវបានកាត់បន្ថយទៅមួយជួរ៖

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

ប្រសិនបើយើងមិនត្រូវការការកំណត់ណាមួយពីការកំណត់រចនាសម្ព័ន្ធមេទេ យើងអាចបញ្ជាក់វានៅក្នុងការកំណត់រចនាសម្ព័ន្ធរបស់យើង ហើយវានឹងត្រូវបានអនុវត្តក្នុងអំឡុងពេលជំនាន់។ នោះគឺប្រសិនបើសម្រាប់ហេតុផលមួយចំនួនយើងត្រូវការឈ្មោះតែមួយគត់សម្រាប់សេវាកម្មបញ្ជាទិញ យើងនឹងចាកចេញពីប៉ារ៉ាម៉ែត្រ spring.application.name.

ឧបមាថាអ្នកត្រូវបន្ថែមការកំណត់កំណត់ហេតុផ្ទាល់ខ្លួនទៅសេវាកម្មដែលត្រូវបានរក្សាទុកក្នុងឯកសារដាច់ដោយឡែកឧទាហរណ៍។ logback.xml. តោះបង្កើតក្រុមដាច់ដោយឡែកនៃការកំណត់សម្រាប់វា៖

នៅក្នុងការកំណត់រចនាសម្ព័ន្ធមូលដ្ឋាន យើងនឹងប្រាប់ក្របខ័ណ្ឌកន្លែងដែលត្រូវដាក់ឯកសារកំណត់កំណត់ហេតុដែលយើងត្រូវការដោយប្រើកន្លែងដាក់ @ConfigDir:

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

នៅក្នុងឯកសារ logback.xml យើងកំណត់រចនាសម្ព័ន្ធឧបសម្ព័ន្ធស្តង់ដារ ដែលនៅក្នុងវេនក៏អាចមានកន្លែងដាក់ផងដែរ ដែលក្របខ័ណ្ឌនឹងផ្លាស់ប្តូរកំឡុងពេលបង្កើតការកំណត់ ឧទាហរណ៍៖

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

ដោយបន្ថែមការនាំចូលទៅការកំណត់រចនាសម្ព័ន្ធសេវាកម្ម ត្រលប់មកវិញយើងទទួលបានការកត់ត្រាដែលបានកំណត់រចនាសម្ព័ន្ធដោយស្វ័យប្រវត្តិសម្រាប់សេវាកម្មនីមួយៗ៖

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

វាដល់ពេលដែលត្រូវស្គាល់ឱ្យកាន់តែលម្អិតជាមួយនឹងកន្លែងដាក់ដែលមានទាំងអស់នៃក្របខ័ណ្ឌ៖

${this@env} - ត្រឡប់ឈ្មោះនៃបរិស្ថានបច្ចុប្បន្ន។
${…@name} - ត្រឡប់ឈ្មោះនៃសមាសភាគ។
${...@configDir} — ត្រឡប់ផ្លូវពេញលេញទៅកាន់ថតកំណត់រចនាសម្ព័ន្ធរបស់សមាសភាគ។
${…@resultDir} — ត្រឡប់ផ្លូវពេញលេញទៅកាន់ថតទិសដៅរបស់សមាសភាគ (ឯកសារលទ្ធផលនឹងត្រូវបានដាក់ក្នុងថតនេះ)។
${this@configRoot} - ត្រឡប់ផ្លូវពេញលេញទៅកាន់ថត root នៃហាងកំណត់រចនាសម្ព័ន្ធ។

ប្រព័ន្ធនេះក៏អនុញ្ញាតឱ្យអ្នកទទួលបានអថេរបរិស្ថាន ឧទាហរណ៍ផ្លូវទៅកាន់ java៖
${env@JAVA_HOME}
ទាំងពីក្របខណ្ឌត្រូវបានសរសេរនៅក្នុង JAVAយើងអាចទទួលបានអថេរប្រព័ន្ធស្រដៀងនឹងការហៅ ប្រព័ន្ធ::getProperty ដោយប្រើរចនាសម្ព័ន្ធដូចនេះ៖
${[អ៊ីមែលការពារ]}
វាគឺមានតំលៃនិយាយអំពីការគាំទ្រសម្រាប់ភាសាបន្ថែម និទាឃរដូវ EL. កន្សោមខាងក្រោមអាចអនុវត្តបានក្នុងការកំណត់រចនាសម្ព័ន្ធ៖

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

ហើយអ្នកអាចប្រើអថេរមូលដ្ឋាននៅក្នុងឯកសារកំណត់រចនាសម្ព័ន្ធដោយប្រើកន្សោម #var:

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

ដូច្នេះ ក្របខណ្ឌគឺជាឧបករណ៍ដ៏មានអានុភាពមួយសម្រាប់ការកែសម្រួល និងការកំណត់រចនាសម្ព័ន្ធខ្នាតតូចដែលអាចបត់បែនបាន។ ក្របខ័ណ្ឌបំពេញភារកិច្ចចម្បងរបស់វាយ៉ាងល្អឥតខ្ចោះ - ការលុបបំបាត់ការចម្លងបិទភ្ជាប់នៅក្នុងការកំណត់ ការបង្រួបបង្រួមការកំណត់ ហើយជាលទ្ធផល កាត់បន្ថយកំហុសដែលអាចកើតមាន ខណៈពេលដែលអនុញ្ញាតឱ្យអ្នកងាយស្រួលបញ្ចូលគ្នានូវការកំណត់រចនាសម្ព័ន្ធ និងផ្លាស់ប្តូរពួកវាសម្រាប់បរិស្ថានផ្សេងៗគ្នា។

ប្រសិនបើអ្នកចាប់អារម្មណ៍លើក្របខណ្ឌនេះ ខ្ញុំសូមណែនាំឱ្យចូលមើលទំព័រផ្លូវការរបស់វា ហើយស្គាល់ពេញលេញ ឯកសារឬជីកចូលទៅក្នុងប្រភព នៅទីនេះ.

ប្រភព: www.habr.com