Group application.properties by build time / run time (#970)

Author: dimas-b

quarkus/admin/src/main/resources/application.properties

@@ -17,6 +17,11 @@
 # under the License.
 #
 
+# ---- Build-time configuration ----
+# Build-time properties take effect when Quarkus processes java classes
+# and creates Polaris jars. These properties cannot be overriden in runtime.
+# Cf. https://quarkus.io/guides/all-config
+
 quarkus.application.name=Apache Polaris Admin Tool (incubating)
 quarkus.banner.path=/org/apache/polaris/admintool/banner.txt
 
@@ -27,4 +32,7 @@ quarkus.container-image.group=apache
 quarkus.container-image.name=polaris-admin-tool
 quarkus.container-image.additional-tags=latest
 
+# ---- Runtime Configuration ----
+# Below are default values for properties that can be changed in runtime.
+
 polaris.persistence.type=eclipse-link

quarkus/defaults/src/main/resources/application.properties

@@ -17,18 +17,30 @@
 # under the License.
 #
 
+# ---- Build-time configuration ----
+# Build-time properties take effect when Quarkus processes java classes
+# and creates Polaris jars. These properties cannot be overriden in runtime.
+# Cf. https://quarkus.io/guides/all-config
+
 quarkus.banner.path=/org/apache/polaris/service/banner.txt
+quarkus.http.auth.basic=false
+quarkus.http.enable-compression=true
+quarkus.http.enable-decompression=true
+quarkus.http.compress-media-types=application/json,text/html,text/plain
+quarkus.management.enabled=true
+quarkus.micrometer.enabled=true
+quarkus.micrometer.export.prometheus.enabled=true
+quarkus.otel.enabled=true
+
+# ---- Runtime Configuration ----
+# Below are default values for properties that can be changed in runtime.
 
 quarkus.config.mapping.validate-unknown=true
 
-quarkus.http.auth.basic=false
 quarkus.http.access-log.enabled=true
 # quarkus.http.access-log.pattern=common
-quarkus.http.enable-compression=true
-quarkus.http.enable-decompression=true
 quarkus.http.body.handle-file-uploads=false
 quarkus.http.limits.max-body-size=10240K
-quarkus.http.compress-media-types=application/json,text/html,text/plain
 
 quarkus.http.cors.origins=http://localhost:8080
 quarkus.http.cors.methods=PATCH, POST, DELETE, GET, PUT
@@ -57,16 +69,9 @@ quarkus.log.category."org.apache.polaris".level=INFO
 quarkus.log.category."org.apache.iceberg.rest".level=INFO
 quarkus.log.category."io.smallrye.config".level=INFO
 
-quarkus.management.enabled=true
 quarkus.management.port=8182
 quarkus.management.test-port=0
 
-quarkus.micrometer.enabled=true
-quarkus.micrometer.export.prometheus.enabled=true
-
-# quarkus.otel.enabled is a build-time property. If it is disabled at build time, it will not be
-# possible to reset it at runtime, consequently all OTel functionality will be disabled.
-quarkus.otel.enabled=true
 # quarkus.otel.sdk.disabled is set to `true` by default to avoid spuriour errors about
 # trace collector connections being impossible to establish. This setting can be enabled
 # at runtime after configuring other OTel properties for proper trace data collection.

quarkus/server/src/main/resources/application.properties

@@ -17,6 +17,11 @@
 # under the License.
 #
 
+# ---- Build-time configuration ----
+# Build-time properties take effect when Quarkus processes java classes
+# and creates Polaris jars. These properties cannot be overriden in runtime.
+# Cf. https://quarkus.io/guides/all-config
+
 quarkus.application.name=Apache Polaris Server (incubating)
 
 quarkus.container-image.build=false