[17.0.0.3 and later]

Enabling the MicroProfile Config API

To configure the Liberty server to run an application that is enabled for the MicroProfile Config API, you must set the feature for the server.

Procédure

  1. Using the MicroProfile Config API information, decide what configuration parameters are required by your code. Consider how these configuration values can be stored and how they might vary across services and over the lifetime of the service from:
    • Development
    • Test
    • Assembly and installation
    • Runtime service scaling and failover
  2. Configure the feature. Update the server.xml file to add the feature. For example:
    <featureManager>
        <feature>mpConfig-1.1</feature>
    </featureManager>

    Liberty peut être configuré pour prendre en charge les fonctions MicroProfile 1.1 en définissant microProfile-1.1 dans le fichier server.xml. Cependant, l'API MicroProfile Config a été produit après la publication de MicroProfile 1.1 et n'est pas accessible à l'aide de cette fonction.

    [18.0.0.1 and later]Vous pouvez configurer le fichier server.xml pour l'utilisation de la fonction mpConfig-1.2 à la place de la fonction mpConfig-1.1. Pour activer la fonction mpConfig-1.2, ajoutez la définition de fonction suivante à votre fichier server.xml :
    <featureManager>
        <feature>mpConfig-1.2</feature>
    </featureManager>
    Pour plus d'informations sur mpConfig-1.2, voir la spécification MicroProfile Config 1.2.1 à l'adresse https://github.com/eclipse/microprofile-config/releases/tag/1.2.1.
  3. Créez des sources de valeurs de configuration appropriées. Par exemple, les fichiers de propriétés peuvent être packagés avec une application et les sources de valeurs peuvent être redéfinies par la suite. Ceci peut se produire lors de la composition de l'application à l'aide des fichiers de propriété dans un assemblage EAR, dans des bibliothèques partagées Liberty ou dans des variables d'environnement du processeur serveur.
  4. Utilisez l'API pour accéder aux valeurs de configuration.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_microprofile_appconfig_setup.html