From ee6dbe9f16ec787751f0ce449781c3ab1a14c5e1 Mon Sep 17 00:00:00 2001 From: Joe DiPol Date: Wed, 21 Aug 2024 13:39:12 -0700 Subject: [PATCH] 3.x: Clarify description of config profiles (#9187) * Clarify description of config profiles --- docs/mp/config/introduction.adoc | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/mp/config/introduction.adoc b/docs/mp/config/introduction.adoc index 91b9d8434b2..99119a6e91d 100644 --- a/docs/mp/config/introduction.adoc +++ b/docs/mp/config/introduction.adoc @@ -1,7 +1,7 @@ /////////////////////////////////////////////////////////////////////////////// - Copyright (c) 2020, 2023 Oracle and/or its affiliates. + Copyright (c) 2020, 2024 Oracle and/or its affiliates. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. @@ -127,9 +127,14 @@ server.host=0.0.0.0 ==== {spec-name} Profiles [[Config-Profiles]] {spec-name} supports a concept of configuration profiles. You can define a profile using the configuration property `mp.config.profile` -(when using default configuration, this can be defined as a system property, environment variable or as a property in `microprofile-config.properties`). -When a profile is defined, additional config source is loaded (`microprofile-config-profile.properties`) and properties from profile have precedence over -default properties. Profile properties can be defined using `%profile` prefix, such as `%dev.server.port`. +This can be defined as a system property, environment variable or as a property in `microprofile-config.properties` (when default configuration is used). +When a profile is defined, an additional config source is loaded: `microprofile-config-.properties` and properties in the profile +specific config source will override properties set in the default config source. + +You can also use profiles on a per property level. Profile specific properties are defined using `%` prefix, such as `%dev.server.port`. +This will override the plain property `server.port`. + +For more details see link:{microprofile-config-spec-url}#_how_config_profile_works[How Config Profiles work] === Helidon {spec-name} Features