Chapter 1. Configuring your Red Hat build of Quarkus applications by using a YAML file

Procedure

1. Open the src/main/resources/application.yaml configuration file.

2. Add the nested class configuration properties to your application.yaml file, as shown in the following example:

   Example application.yaml file

   # Properties that configure the JDBC data source driver of your PostgreSQL data source
   quarkus:
     datasource:
       db-kind: postgresql
       jdbc:
         url: jdbc:postgresql://localhost:5432/quarkus_test
       username: quarkus_test
       password: quarkus_test
   
   # Property that configures the URL of the endpoint to which the REST client sends requests
   quarkus:
     rest-client:
       org.acme.rest.client.ExtensionsService:
         url: https://stage.code.quarkus.io/api
   
   # Property that configures the log message level for your application
   # For configuration property names that use quotes, do not split the string inside the quotes
   quarkus:
     log:
       category:
         "io.quarkus.category":
           level: INFO

   Copy to Clipboard Toggle word wrap

   Warning

   For production, do not set the username and password in the configuration file, as shown in the preceding example. This was for illustration purposes only. Instead, set the username and password in your environmental variables. For more information, see the Setting configuration properties section of the "Configuring your Red Hat build of Quarkus applications by using a properties file" guide.

   Similar to the application.properties file, you can use comments to describe your configuration properties in YAML format.

   Note

   Always use spaces to indent the properties in your YAML configuration file. YAML does not support using tabs for indentation.

Procedure

1. Open your project’s configuration file, src/main/resources/application.yaml.

2. To set a profile-dependent configuration, add the profile name before defining the key-value pairs by using the "%<profile_name>" syntax. Ensure that you place the profile name inside quotation marks.

   Tip

   In YAML, you must place all strings that begin with a special character inside quotation marks.

   In the following example, the PostgreSQL database is configured to be available at the jdbc:postgresql://localhost:5432/quarkus_test URL when you start your Quarkus application in development mode:

   src/main/resources/application.yaml

   "%dev":
     quarkus:
       datasource:
         db-kind: postgresql
           jdbc:
             url: jdbc:postgresql://localhost:5432/quarkus_test
           username: quarkus_test
           password: quarkus_test

   Copy to Clipboard Toggle word wrap

   Warning

   For production, do not set the username and password in the configuration file, as shown in the preceding example. This was for illustration purposes only. Instead, set the username and password in your environmental variables. For more information, see the Setting configuration properties section of the "Configuring your Red Hat build of Quarkus applications by using a properties file" guide.