BMAD-METHOD/non-interactive-installation.md at 537ff0cbf0b0072fdb224a57fb193a1bb84d1080

5.3 KiB

Raw Blame History

title

description

sidebar

Neinteraktivní instalace

Instalace BMad pomocí příznaků příkazové řádky pro CI/CD pipelines a automatizované nasazení

order
2

Použijte příznaky příkazové řádky k neinteraktivní instalaci BMad. To je užitečné pro:

Kdy to použít

Automatizovaná nasazení a CI/CD pipelines
Skriptované instalace
Hromadné instalace napříč více projekty
Rychlé instalace se známými konfiguracemi

:::note[Předpoklady] Vyžaduje Node.js v20+ a npx (součástí npm). :::

Dostupné příznaky

Možnosti instalace

Příznak	Popis	Příklad
`--directory <cesta>`	Instalační adresář	`--directory ~/projects/myapp`
`--modules <moduly>`	Čárkou oddělená ID modulů	`--modules bmm,bmb`
`--tools <nástroje>`	Čárkou oddělená ID nástrojů/IDE (použijte `none` pro přeskočení)	`--tools claude-code,cursor` nebo `--tools none`
`--action <typ>`	Akce pro existující instalace: `install` (výchozí), `update` nebo `quick-update`	`--action quick-update`

Základní konfigurace

Příznak	Popis	Výchozí
`--user-name <jméno>`	Jméno, které agenti použijí	Systémové uživatelské jméno
`--communication-language <jazyk>`	Jazyk komunikace agentů	English
`--document-output-language <jazyk>`	Jazyk výstupních dokumentů	English
`--output-folder <cesta>`	Cesta k výstupní složce	_bmad-output

Další možnosti

Příznak	Popis
`-y, --yes`	Přijmout všechna výchozí nastavení a přeskočit výzvy
`-d, --debug`	Povolit ladící výstup pro generování manifestu

ID modulů

Dostupná ID modulů pro příznak --modules:

bmm — BMad Method Master
bmb — BMad Builder

Zkontrolujte registr BMad pro dostupné externí moduly.

ID nástrojů/IDE

Dostupná ID nástrojů pro příznak --tools:

Preferované: claude-code, cursor

Spusťte npx bmad-method install interaktivně jednou pro zobrazení aktuálního seznamu podporovaných nástrojů, nebo zkontrolujte konfiguraci kódů platforem.

Režimy instalace

Režim	Popis	Příklad
Plně neinteraktivní	Zadejte všechny příznaky pro přeskočení výzev	`npx bmad-method install --directory . --modules bmm --tools claude-code --yes`
Polo-interaktivní	Zadejte některé příznaky; BMad se zeptá na zbytek	`npx bmad-method install --directory . --modules bmm`
Pouze výchozí	Přijměte vše výchozí s `-y`	`npx bmad-method install --yes`
Bez nástrojů	Přeskočte konfiguraci nástrojů/IDE	`npx bmad-method install --modules bmm --tools none`

Příklady

Instalace v CI/CD pipeline

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

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

Aktualizace existující instalace

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

Rychlá aktualizace (zachování nastavení)

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

Co získáte

Plně nakonfigurovaný adresář _bmad/ ve vašem projektu
Agenty a workflow nakonfigurované pro vybrané moduly a nástroje
Složku _bmad-output/ pro generované artefakty

Validace a zpracování chyb

BMad validuje všechny zadané příznaky:

Adresář — Musí být platná cesta s oprávněním k zápisu
Moduly — Upozorní na neplatná ID modulů (ale nespadne)
Nástroje — Upozorní na neplatná ID nástrojů (ale nespadne)
Vlastní obsah — Každá cesta musí obsahovat platný soubor module.yaml
Akce — Musí být jedna z: install, update, quick-update

Neplatné hodnoty buď:

Zobrazí chybu a ukončí se (pro kritické možnosti jako adresář)
Zobrazí varování a přeskočí (pro volitelné položky jako vlastní obsah)
Přepnou na interaktivní výzvy (pro chybějící povinné hodnoty)

:::tip[Osvědčené postupy]

Používejte absolutní cesty pro --directory pro zamezení nejednoznačnosti
Otestujte příznaky lokálně před použitím v CI/CD pipelines
Kombinujte s -y pro skutečně bezobslužné instalace
Použijte --debug pokud narazíte na problémy během instalace :::

Řešení problémů

Instalace selže s „Invalid directory“

Cesta k adresáři musí existovat (nebo musí existovat jeho nadřazený adresář)
Potřebujete oprávnění k zápisu
Cesta musí být absolutní nebo správně relativní k aktuálnímu adresáři

Modul nenalezen

Ověřte, že ID modulu je správné
Externí moduly musí být dostupné v registru

::: note[Stále jste uvízli?] Spusťte s --debug pro detailní výstup, zkuste interaktivní režim pro izolaci problému, nebo nahlaste na https://github.com/bmad-code-org/BMAD-METHOD/issues. :::

5.3 KiB Raw Blame History