BMAD-METHOD/docs/fr/how-to/non-interactive-installation.md

title	description	sidebar
Installation non-interactive	Installer BMad en utilisant des options de ligne de commande pour les pipelines CI/CD et les déploiements automatisés	order 2

Utilisez les options de ligne de commande pour installer BMad de manière non-interactive. Cela est utile pour :

Quand utiliser cette méthode

• Déploiements automatisés et pipelines CI/CD
• Installations scriptées
• Installations par lots sur plusieurs projets
• Installations rapides avec des configurations connues

:::note[Prérequis] Nécessite Node.js v20+ et npx (inclus avec npm). :::

Options disponibles

Options d'installation

Option	Description	Exemple
--directory <chemin>	Répertoire d'installation	--directory ~/projects/myapp
--modules <modules>	IDs de modules séparés par des virgules	--modules bmm,bmb
--tools <outils>	IDs d'outils/IDE séparés par des virgules (utilisez none pour ignorer)	--tools claude-code,cursor ou --tools none
--custom-content <chemins>	Chemins vers des modules personnalisés séparés par des virgules	--custom-content ~/my-module,~/another-module
--action <type>	Action pour les installations existantes : install (par défaut), update, quick-update, ou compile-agents	--action quick-update

Configuration principale

Option	Description	Par défaut
--user-name <nom>	Nom à utiliser par les agents	Nom d'utilisateur système
--communication-language <langue>	Langue de communication des agents	Anglais
--document-output-language <langue>	Langue de sortie des documents	Anglais
--output-folder <chemin>	Chemin du dossier de sortie	_bmad-output

Autres options

Option	Description
-y, --yes	Accepter tous les paramètres par défaut et ignorer les invites
-d, --debug	Activer la sortie de débogage pour la génération du manifeste

IDs de modules

IDs de modules disponibles pour l’option --modules :

• bmm — méthode BMad Master
• bmb — BMad Builder

Consultez le registre BMad pour les modules externes disponibles.

IDs d'outils/IDE

IDs d'outils disponibles pour l’option --tools :

Recommandés : claude-code, cursor

Exécutez npx bmad-method install de manière interactive une fois pour voir la liste complète actuelle des outils pris en charge, ou consultez la configuration des codes de la plateforme.

Modes d'installation

Mode	Description	Exemple
Entièrement non-interactif	Fournir toutes les options pour ignorer toutes les invites	npx bmad-method install --directory . --modules bmm --tools claude-code --yes
Semi-interactif	Fournir certains options ; BMad demande les autres	npx bmad-method install --directory . --modules bmm
Paramètres par défaut uniquement	Accepter tous les paramètres par défaut avec -y	npx bmad-method install --yes
Sans outils	Ignorer la configuration des outils/IDE	npx bmad-method install --modules bmm --tools none

Exemples

Installation dans un pipeline CI/CD

#!/bin/bash
# install-bmad.sh

npx bmad-method install \
  --directory "${GITHUB_WORKSPACE}" \
  --modules bmm \
  --tools claude-code \
  --user-name "CI Bot" \
  --communication-language Français \
  --document-output-language Français \
  --output-folder _bmad-output \
  --yes

Mettre à jour une installation existante

npx bmad-method install \
  --directory ~/projects/myapp \
  --action update \
  --modules bmm,bmb,custom-module

Mise à jour rapide (conserver les paramètres)

npx bmad-method install \
  --directory ~/projects/myapp \
  --action quick-update

Installation avec du contenu personnalisé

npx bmad-method install \
  --directory ~/projects/myapp \
  --modules bmm \
  --custom-content ~/my-custom-module,~/another-module \
  --tools claude-code

Ce que vous obtenez

• Un répertoire _bmad/ entièrement configuré dans votre projet
• Des agents et des flux de travail compilés pour vos modules et outils sélectionnés
• Un dossier _bmad-output/ pour les artefacts générés

Validation et gestion des erreurs

BMad valide toutes les options fournis :

• Directory — Doit être un chemin valide avec des permissions d'écriture
• Modules — Avertit des IDs de modules invalides (mais n'échoue pas)
• Tools — Avertit des IDs d'outils invalides (mais n'échoue pas)
• Custom Content — Chaque chemin doit contenir un fichier module.yaml valide
• Action — Doit être l'une des suivantes : install, update, quick-update, compile-agents

Les valeurs invalides entraîneront soit :

1. L’affichage d’un message d'erreur suivi d’un exit (pour les options critiques comme le répertoire)
2. Un avertissement puis la continuation de l’installation (pour les éléments optionnels comme le contenu personnalisé)
3. Un retour aux invites interactives (pour les valeurs requises manquantes)

:::tip[Bonnes pratiques]

• Utilisez des chemins absolus pour --directory pour éviter toute ambiguïté
• Testez les options localement avant de les utiliser dans des pipelines CI/CD
• Combinez avec -y pour des installations vraiment sans surveillance
• Utilisez --debug si vous rencontrez des problèmes lors de l'installation :::

Résolution des problèmes

L'installation échoue avec "Invalid directory"

• Le chemin du répertoire doit exister (ou son parent doit exister)
• Vous avez besoin des permissions d'écriture
• Le chemin doit être absolu ou correctement relatif au répertoire actuel

Module non trouvé

• Vérifiez que l'ID du module est correct
• Les modules externes doivent être disponibles dans le registre

Chemin de contenu personnalisé invalide

Assurez-vous que chaque chemin de contenu personnalisé :

• Pointe vers un répertoire
• Contient un fichier module.yaml à la racine
• Possède un champ code dans module.yaml

:::note[Toujours bloqué ?] Exécutez avec --debug pour une sortie détaillée, essayez le mode interactif pour isoler le problème, ou signalez-le à https://github.com/bmad-code-org/BMAD-METHOD/issues. :::