{"id":39476,"date":"2019-10-31T22:33:41","date_gmt":"2019-10-31T19:33:41","guid":{"rendered":"https:\/\/prohoster.info\/blog\/legkoe-upravlenie-konfiguratsiyami-mikroservisov-s-pomoshhyu-microconfig-io\/"},"modified":"2019-10-31T22:33:41","modified_gmt":"2019-10-31T19:33:41","slug":"legkoe-upravlenie-konfiguratsiyami-mikroservisov-s-pomoshhyu-microconfig-io","status":"publish","type":"post","link":"https:\/\/prohoster.info\/en\/blog\/administrirovanie\/legkoe-upravlenie-konfiguratsiyami-mikroservisov-s-pomoshhyu-microconfig-io","title":{"rendered":"Easy management of microservices configurations with microconfig.io","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

One of the main challenges in developing and subsequently operating microservices is the proper and careful configuration of their instances. In my opinion, a new framework could help with this. microconfig.io<\/a><\/noindex>. It elegantly addresses some routine configuration tasks of applications.
\n<\/a><\/noindex>
\nIf you have many microservices, each accompanied by its own configuration file(s), there's a high probability of making a mistake in one of them, which can be very difficult to catch without sufficient skill and a logging system. The main goal of the framework is to minimize duplicative configuration parameters of instances, thereby reducing the likelihood of introducing an error.<\/p>\n

Let's consider an example. Suppose there's a simple application with a configuration file yaml<\/b>. This can be any microservice in any language. Let's see how the framework can be applied to this service. <\/p>\n

But first, for convenience, let's create an empty project in the Idea IDE, having previously installed the microconfig.io plugin: <\/p>\n

\"Easy
\n
\nConfigure the plugin's launch settings; you can use the default configuration, as shown in the screenshot above.<\/p>\n

Our service is called order, so in the new project, we will create a structure like this:<\/p>\n

\"Easy
\n
\nWe place the configuration file in a folder named after the service \u2014 application.yaml<\/b>. All microservices run in some environment, so besides creating the service's config, it is necessary to describe the environment itself: for this, we will create a folder envs<\/b> and add a file named after our working environment. Thus, the framework will create configuration files for services in the environment dev<\/b>, as this parameter is set in the plugin settings.<\/p>\n

File Structure dev.yaml<\/b> will be quite simple: <\/p>\n

mainorder:\n    components:\n         - order<\/code><\/pre>\n
\nThe framework works with configurations that are grouped together. For our service, we will choose a name for the group mainorder<\/b>. The framework finds each of these application groups in the environment file and creates configurations for all of them, which it finds in the corresponding folders. <\/p>\n
In the service's configuration file order<\/b> we will specify only one parameter for now: <\/p>\n
spring.application.name: order<\/code><\/pre>\n
\nNow let's run the plugin, and it will generate the desired configuration for our service according to the specified path in the properties:<\/p>\n
\"Easy
\n
\nYou can get by without<\/a><\/noindex> without installing a plugin, simply by downloading the framework distribution and running it from the command line.
\nThis solution is suitable for use on a build server.<\/p>\n
It is worth noting that the framework understands property<\/b> syntax, meaning regular property files that can be used together with yaml<\/b> configurations.<\/p>\n
Let's add another service payment<\/b> and simultaneously complicate the existing one.
\nIn order<\/b>:<\/p>\n
eureka:\n instance.preferIpAddress: true\n client:\n   serviceUrl:\n     defaultZone: http:\/\/192.89.89.111:6782\/eureka\/\nserver.port: 9999\nspring.application.name: order\ndb.url: 192.168.0.100<\/code><\/pre>\n
\nIn payment<\/b>:<\/p>\n
eureka:\n instance.preferIpAddress: true\n client:\n   serviceUrl:\n     defaultZone: http:\/\/192.89.89.111:6782\/eureka\/\nserver.port: 9998\nspring.application.name: payments\ndb.url: 192.168.0.100<\/code><\/pre>\n
\nThe main problem with these configurations is the presence of a large amount of copy-pasting in the service settings. Let's see how the framework can help eliminate this. Let's start with the most obvious one \u2014 the presence of the configuration eureka<\/b> in the description of each microservice. We'll create a new directory with a settings file and add a new configuration to it:<\/p>\n
\"Easy
\n
\nAnd in each of our projects, we will now add the line #include eureka<\/i>.<\/p>\n
The framework will automatically find the eureka configuration and copy it into the service configuration files, while a separate eureka configuration will not be created since we won't specify it in the environment file dev.yaml<\/b>. The service order<\/b>:<\/p>\n
#include eureka\nserver.port: 9999\nspring.application.name: order\ndb.url: 192.168.0.100<\/code><\/pre>\n
\nWe can also extract the database settings into a separate configuration by changing the import line to #include eureka, oracle<\/i>.<\/p>\n
It is worth noting that the framework tracks every change when regenerating configuration files and places it in a special file next to the main configuration file. The log entry looks like this: \u201cStored 1 property changes to order\/diff-application.yaml<\/b>\u201d. This allows for quick detection of changes in large configuration files.<\/p>\n
Extracting common configuration parts helps eliminate a lot of unnecessary copy-pasting, but does not allow for flexible creation of configurations for different environments \u2014 our service endpoints are unique and hardcoded, which is not ideal. Let's try to fix this.<\/p>\n
A good solution would be to keep all endpoints in a single configuration that the others can reference. For this, the framework has support for placeholders. Here\u2019s how the configuration file will change eureka<\/b>:<\/p>\n
 client:\n   serviceUrl:\n     defaultZone: http:\/\/${endpoints@eurekaip}:6782\/eureka\/<\/code><\/pre>\n
\nNow let's see how this placeholder works. The system finds the component named endpoints<\/b> and looks for the value in it eurekaip<\/b>, after which it is inserted into our configuration. But what about different environments? For this, we will create a settings file in endpoints<\/b> the following format application.dev.yaml<\/b>. The framework automatically determines which environment this configuration belongs to based on the file extension and loads it:<\/p>\n
\"Easy
\n
\nContents of the dev file:<\/p>\n
eurekaip: 192.89.89.111\ndbip: 192.168.0.100<\/code><\/pre>\n
\nWe can create a similar configuration for the ports of our services:<\/p>\n
server.port: ${ports@order}.<\/code><\/pre>\n
\nAll important settings are in one place, thereby reducing the likelihood of errors caused by scattered parameters across configuration files.<\/p>\n
The framework provides many ready-made placeholders, for example, you can get the name of the directory where the configuration file is located and assign it:<\/p>\n
#include eureka, oracle\nserver.port: ${ports@order}\nspring.application.name: ${this@name}<\/code><\/pre>\n
\nThanks to this, it is not necessary to specify the application name in the configuration, and it can also be moved to a common module, for example, to the same eureka:<\/p>\n
client:\n   serviceUrl:\n     defaultZone: http:\/\/${endpoints@eurekaip}:6782\/eureka\/\n spring.application.name: ${this@name}<\/code><\/pre>\n
\nThe configuration file order<\/b> will reduce to one line:<\/p>\n
#include eureka, oracle\nserver.port: ${ports@order}<\/code><\/pre>\n
\nIn case any setting from the parent configuration is not needed, we can specify it in our configuration, and it will be applied during generation. That is, if for some reason we need a unique name for the order service, we just leave the parameter spring.application.name<\/b>.<\/p>\n
For example, the service may need to add customized logging settings stored in a separate file, such as logback.xml<\/b>. We will create a separate group of settings for it:<\/p>\n
\"Easy
\n
\nIn the basic configuration, we will tell the framework where to place the desired logging settings file using the placeholder @ConfigDir<\/b>:<\/p>\n
microconfig.template.logback.fromFile: ${logback@configDir}\/logback.xml<\/code><\/pre>\n
\nIn the file logback.xml<\/b> we configure the standard appenders, which in turn may also contain placeholders that the framework will change during configuration generation, for example:<\/p>\n
logs\/${this@name}.log<\/code><\/pre>\n
\nBy adding import logback<\/b>, we automatically get configured logging for each service:<\/p>\n
#include eureka, oracle, logback\nserver.port: ${ports@order}<\/code><\/pre>\n
\nIt is time to take a closer look at all available placeholders of the framework:<\/p>\n
${this@env}<\/b> \u2014 returns the name of the current environment.
\n${…@name} <\/b> \u2014 returns the name of the component.
\n${…@configDir}<\/b> \u2014 returns the full path to the config component directory.
\n${…@resultDir}<\/b> returns the full path to the destination directory of the component (the received files will be placed in this directory).
\n${this@configRoot}<\/b> returns the full path to the root directory of the configuration storage.<\/p>\n
The system also allows obtaining environment variables, for example, the path to java:
\n${env@JAVA_HOME}<\/b>
\nAlternatively, since the framework is written in JAVA<\/b>, we can obtain system variables similar to the call System::getProperty<\/b> using a construction like this:
\n${system@os.name}<\/b>
\nIt is worth mentioning support for the expression language Spring EL<\/b>. Similar expressions apply in the configuration:<\/p>\n
connection.timeoutInMs: #{5 * 60 * 1000}\ndatasource.maximum-pool-size: #{${this@datasource.minimum-pool-size} + 10} <\/code><\/pre>\n
\nand you can use local variables in configuration files with the expression #var<\/b>:<\/p>\n
#var feedRoot: ${system@user.home}\/feed\nfolder:\n root: ${this@feedRoot}\n success: ${this@feedRoot}\/archive\n error: ${this@feedRoot}\/error<\/code><\/pre>\n
\nThus, the framework serves as quite a powerful tool for fine-tuning microservice configurations flexibly. The framework effectively accomplishes its primary task\u2014eliminating copy-pasting in settings, consolidating settings, and consequently minimizing potential errors, while allowing easy combination of configurations and modifications for different environments.<\/p>\n
If you are interested in this framework, I recommend visiting its official page and getting acquainted with the full documentation<\/a><\/noindex>, or digging into the source code. here<\/a><\/noindex>.
\n
Source: habr.com<\/a><\/p>","protected":false,"gt_translate_keys":[{"key":"rendered","format":"html"}]},"excerpt":{"rendered":"
\u041e\u0434\u043d\u043e\u0439 \u0438\u0437 \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u0445 \u043f\u0440\u043e\u0431\u043b\u0435\u043c \u043f\u0440\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435 \u0438 \u043f\u043e\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0435\u0439 \u044d\u043a\u0441\u043f\u043b\u0443\u0430\u0442\u0430\u0446\u0438\u0438 \u043c\u0438\u043a\u0440\u043e\u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0433\u0440\u0430\u043c\u043e\u0442\u043d\u0430\u044f \u0438 \u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u0430\u044f \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0438\u0445 \u0438\u043d\u0441\u0442\u0430\u043d\u0441\u043e\u0432. \u0412 \u044d\u0442\u043e\u043c, \u043d\u0430 \u043c\u043e\u0439 \u0432\u0437\u0433\u043b\u044f\u0434, \u043c\u043e\u0436\u0435\u0442 \u043f\u043e\u043c\u043e\u0447\u044c \u043d\u043e\u0432\u044b\u0439 \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a microconfig.io. \u041e\u043d \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0434\u043e\u0432\u043e\u043b\u044c\u043d\u043e \u044d\u043b\u0435\u0433\u0430\u043d\u0442\u043d\u043e \u0440\u0435\u0448\u0438\u0442\u044c \u043d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0440\u0443\u0442\u0438\u043d\u043d\u044b\u0435 \u0437\u0430\u0434\u0430\u0447\u0438 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0439. \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u043c\u043d\u043e\u0433\u043e \u043c\u0438\u043a\u0440\u043e\u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432, \u0438 \u043a\u0430\u0436\u0434\u044b\u0439 \u0438\u0437 \u043d\u0438\u0445 \u043f\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0432\u043c\u0435\u0441\u0442\u0435 \u0441\u043e \u0441\u0432\u043e\u0438\u043c \u0444\u0430\u0439\u043b\u043e\u043c\/\u0444\u0430\u0439\u043b\u0430\u043c\u0438 \u043d\u0430\u0441\u0442\u0440\u043e\u0435\u043a, \u0442\u043e \u0432\u0435\u043b\u0438\u043a\u0430 \u0432\u0435\u0440\u043e\u044f\u0442\u043d\u043e\u0441\u0442\u044c […]<\/p>\n","protected":false,"gt_translate_keys":[{"key":"rendered","format":"html"}]},"author":1,"featured_media":39477,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[688],"tags":[],"class_list":["post-39476","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-administrirovanie"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\n","aioseo_head_json":{"title":"\ud83e\udd47Easy management of microservice configurations using microconfig.io | ProHoster","description":"One of the main issues in developing and subsequently operating microservices is the proper and careful configuration of their instances.","canonical_url":"https:\/\/prohoster.info\/en\/blog\/administrirovanie\/legkoe-upravlenie-konfiguratsiyami-mikroservisov-s-pomoshhyu-microconfig-io","robots":"max-image-preview:large","keywords":"","webmasterTools":{"miscellaneous":""},"schema":null,"og:locale":"en_US","og:site_name":"ProHoster | \u041a\u0443\u043f\u0438\u0442\u044c \u043d\u0430\u0434\u0435\u0436\u043d\u044b\u0439 \u0445\u043e\u0441\u0442\u0438\u043d\u0433 \u0434\u043b\u044f \u0441\u0430\u0439\u0442\u043e\u0432 \u0441 \u0437\u0430\u0449\u0438\u0442\u043e\u0439 \u043e\u0442 DDoS, VPS VDS \u0441\u0435\u0440\u0432\u0435\u0440\u044b","og:type":"article","og:title":"\ud83e\udd47\u041b\u0435\u0433\u043a\u043e\u0435 \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f\u043c\u0438 \u043c\u0438\u043a\u0440\u043e\u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e microconfig.io | ProHoster","og:description":"\u041e\u0434\u043d\u043e\u0439 \u0438\u0437 \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u0445 \u043f\u0440\u043e\u0431\u043b\u0435\u043c \u043f\u0440\u0438 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435 \u0438 \u043f\u043e\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0435\u0439 \u044d\u043a\u0441\u043f\u043b\u0443\u0430\u0442\u0430\u0446\u0438\u0438 \u043c\u0438\u043a\u0440\u043e\u0441\u0435\u0440\u0432\u0438\u0441\u043e\u0432 \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0433\u0440\u0430\u043c\u043e\u0442\u043d\u0430\u044f \u0438 \u0430\u043a\u043a\u0443\u0440\u0430\u0442\u043d\u0430\u044f \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0438\u0445 \u0438\u043d\u0441\u0442\u0430\u043d\u0441\u043e\u0432.","og:url":"https:\/\/prohoster.info\/en\/blog\/administrirovanie\/legkoe-upravlenie-konfiguratsiyami-mikroservisov-s-pomoshhyu-microconfig-io","og:image":"https:\/\/prohoster.info\/wp-content\/uploads\/2021\/11\/logo-350.jpg","og:image:secure_url":"https:\/\/prohoster.info\/wp-content\/uploads\/2021\/11\/logo-350.jpg","og:image:width":350,"og:image:height":350,"article:published_time":"2019-10-31T19:33:41+00:00","article:modified_time":"2019-10-31T19:33:41+00:00","article:publisher":"https:\/\/www.facebook.com\/prohoster","article:author":"https:\/\/www.facebook.com\/prohoster"},"aioseo_meta_data":{"post_id":"39476","title":null,"description":null,"keywords":null,"keyphrases":null,"primary_term":null,"canonical_url":null,"og_title":null,"og_description":null,"og_object_type":"default","og_image_type":"default","og_image_url":null,"og_image_width":null,"og_image_height":null,"og_image_custom_url":null,"og_image_custom_fields":null,"og_video":null,"og_custom_url":null,"og_article_section":null,"og_article_tags":null,"twitter_use_og":false,"twitter_card":"default","twitter_image_type":"default","twitter_image_url":null,"twitter_image_custom_url":null,"twitter_image_custom_fields":null,"twitter_title":null,"twitter_description":null,"schema":{"blockGraphs":[],"customGraphs":[],"default":{"data":{"Article":[],"Course":[],"Dataset":[],"FAQPage":[],"Movie":[],"Person":[],"Product":[],"ProductReview":[],"Car":[],"Recipe":[],"Service":[],"SoftwareApplication":[],"WebPage":[]},"graphName":"","isEnabled":true},"graphs":[]},"schema_type":null,"schema_type_options":null,"pillar_content":false,"robots_default":true,"robots_noindex":false,"robots_noarchive":false,"robots_nosnippet":false,"robots_nofollow":false,"robots_noimageindex":false,"robots_noodp":false,"robots_notranslate":false,"robots_max_snippet":null,"robots_max_videopreview":null,"robots_max_imagepreview":"large","priority":null,"frequency":null,"local_seo":null,"seo_analyzer_scan_date":"2026-01-24 02:05:19","breadcrumb_settings":null,"limit_modified_date":false,"reviewed_by":null,"ai":null,"created":"2021-02-28 13:48:28","updated":"2026-01-24 02:05:19","focus_keyword":null,"additional_keywords":null,"truseo_locale":null},"gt_translate_keys":[{"key":"link","format":"url"}],"_links":{"self":[{"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/posts\/39476","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/comments?post=39476"}],"version-history":[{"count":0,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/posts\/39476\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/media\/39477"}],"wp:attachment":[{"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/media?parent=39476"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/categories?post=39476"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/prohoster.info\/en\/wp-json\/wp\/v2\/tags?post=39476"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}