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.ymlquand le profil correspondant est actif, et dont les valeurs complètent ou surchargent celles du fichier principal. Ex.application-dev.ymlpour le profildev.- @Profile
Annotation posée sur un
@Componentou 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 syntaxespring.profiles: devdepuis Spring Boot 2.4.- Profil par défaut
Le profil
defaultest 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 profilproductionactive aussi automatiquementproddbetproddmq. Pratique pour regrouper plusieurs profils techniques sous un seul nom.
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.