Formations — 1 037 leçons en français

Accueil › Spring Boot › Les profils (dev, test, prod)

Les profils (dev, test, prod)

Configurer l'applicationdebutant

Un profil active une configuration différente selon l'environnement : dev, test, prod. On l'active avec spring.profiles.active, par exemple en ligne de commande :

java -jar boutique-api.jar --spring.profiles.active=dev
# ou en variable d'environnement, souvent utilisé en conteneur
SPRING_PROFILES_ACTIVE=prod java -jar boutique-api.jar

Un fichier application-dev.yml est alors chargé en plus d'application.yml, et ses valeurs surchargent celles du fichier principal :

# application.yml (commun à tous les environnements)
spring:
  application:
    name: boutique-api

# application-dev.yml (uniquement en profil dev)
spring:
  datasource:
    url: jdbc:h2:mem:boutique
logging:
  level:
    root: DEBUG

Un bean peut aussi n'exister que pour certains profils avec @Profile :

@Service
@Profile("dev")
public class FausseDonneesService { ... } // jeu de données de test, jamais en prod

Sans profil actif, c'est le profil implicite default qui s'applique.

Les termes à connaître

Profil Spring

Un label (ex. dev, test, prod) qui active une configuration ou des beans différents selon l'environnement d'exécution, sans changer le code.

spring.profiles.active

Propriété qui active un ou plusieurs profils, ex. spring.profiles.active=dev. Se règle en ligne de commande, en variable d'environnement (SPRING_PROFILES_ACTIVE) ou dans un fichier de configuration.

application-{profil}.yml

Fichier de configuration chargé en plus d'application.yml quand le profil correspondant est actif, et dont les valeurs complètent ou surchargent celles du fichier principal. Ex. application-dev.yml pour le profil dev.

@Profile

Annotation posée sur un @Component ou une méthode @Bean : le bean n'est créé que si le profil indiqué est actif. Accepte une négation, ex. @Profile("!prod").

spring.config.activate.on-profile

Dans un fichier YAML multi-documents (séparés par ---), indique qu'un document ne s'applique que si le profil donné est actif. Remplace l'ancienne syntaxe spring.profiles: dev depuis Spring Boot 2.4.

Profil par défaut

Le profil default est actif quand aucun profil n'est explicitement défini. application-default.yml (rarement utilisé) se comporte comme les autres fichiers de profil.

Groupe de profils

spring.profiles.group.production=proddb,proddmq : activer le profil production active aussi automatiquement proddb et proddmq. Pratique pour regrouper plusieurs profils techniques sous un seul nom.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.