Jednoduché testovací parametry pro fáze replikace
Společné testovací hodnoty
V příkladech nahraďte tyto cesty vlastními testovacími daty:
$exe = "C:\flexideo\develop-sources\Flexideo-replicator\product\ReplicatorHeadless\bin\Debug\ReplicatorHeadless.exe"
$instanceConfig = "C:\flexideo\test-instance\test-app.xcf"
$replicatorRoot = "C:\flexideo\replicator"
$inputXds = "C:\flexideo\test-instance\input\test.xds"
$versionFolder = "C:\flexideo\test-instance\versions\test-version"
Společná neinteraktivní část:
--instance-config "<instanceConfig>"
--replicator-root "<replicatorRoot>"
--mode parameters
--interactive false
--no-appdata-fallback true
--pause-on-message false
Význam cest:
instanceConfigje existující konfigurace testovací aplikace;replicatorRootje úplná runtime složka replikátoru sesystem.xcf, jazyky, XSLT a dalšími podpůrnými soubory;inputXdsje vstupní XDS;versionFolderje pracovní složka jedné testovací verze, kterou postupně používají fáze kompletace, tvorby DAD, tvorby stránek a instalace.
Aktuální bootstrap sice parsuje také --version, ale bez --version-folder
jeho použití zatím není implementované. Testovací sady proto záměrně používají
jen --version-folder.
1. Kontrola syntaxe XDS
Nejméně rizikový samostatný test:
& $exe `
--run-step syntax-check `
--instance-config $instanceConfig `
--replicator-root $replicatorRoot `
--input-xds $inputXds `
--mode parameters `
--interactive false `
--no-appdata-fallback true `
--pause-on-message false
$LASTEXITCODE
Potřebuje vstupní XDS, ale nepotřebuje verzi ani potvrzení instalace.
2. Kompletace XDS
První produkční fáze vytvoření verze:
& $exe `
--run-step xds-completing `
--instance-config $instanceConfig `
--replicator-root $replicatorRoot `
--input-xds $inputXds `
--version-folder $versionFolder `
--mode parameters `
--interactive false `
--no-appdata-fallback true `
--pause-on-message false
$LASTEXITCODE
Potřebuje vstupní XDS i cílovou pracovní složku verze.
3. Tvorba DAD
Navazuje na úspěšnou kompletaci XDS:
& $exe `
--run-step dad-creating `
--instance-config $instanceConfig `
--replicator-root $replicatorRoot `
--version-folder $versionFolder `
--mode parameters `
--interactive false `
--no-appdata-fallback true `
--pause-on-message false
$LASTEXITCODE
--input-xds se už nepředává. Fáze čte artefakty připravené v versionFolder.
4. Tvorba stránek
Navazuje na předchozí fáze:
& $exe `
--run-step pages-creating `
--instance-config $instanceConfig `
--replicator-root $replicatorRoot `
--version-folder $versionFolder `
--mode parameters `
--interactive false `
--no-appdata-fallback true `
--pause-on-message false
$LASTEXITCODE
Používá stejnou složku verze jako kompletace a tvorba DAD.
5. Instalace
Instalační fáze má záměrně navíc explicitní potvrzení:
& $exe `
--run-step installation `
--instance-config $instanceConfig `
--replicator-root $replicatorRoot `
--version-folder $versionFolder `
--confirm-installation true `
--mode parameters `
--interactive false `
--no-appdata-fallback true `
--pause-on-message false
$LASTEXITCODE
Bez --confirm-installation true je sada neplatná. Tento příklad používejte
jen proti izolované testovací instanci, nikoli proti produkčnímu serveru.
Spuštění přes existující harness
Načtení připravených sad:
Import-Module .\tests\headless\ReplicatorHeadlessHarness.psm1 -Force
$sets = & .\tests\headless\PhaseParameterSets.example.ps1 `
-InstanceConfig $instanceConfig `
-ReplicatorRoot $replicatorRoot `
-InputXds $inputXds `
-VersionFolder $versionFolder
Ruční spuštění jedné bezpečné fáze:
$result = Invoke-ReplicatorHeadless `
-ExePath $exe `
-Arguments $sets.SyntaxCheck `
-TimeoutSeconds 30
$result | Format-List ExitCode, StdOut, StdErr
Pro celý proces spouštějte fáze jednotlivě a po každé kontrolujte ExitCode:
foreach ($phase in 'XdsCompleting', 'DadCreating', 'PagesCreating') {
$result = Invoke-ReplicatorHeadless `
-ExePath $exe `
-Arguments $sets[$phase] `
-TimeoutSeconds 120
if ($result.ExitCode -ne 0) {
throw "Fáze $phase selhala: $($result.StdErr)"
}
}
Instalaci do této smyčky záměrně nepřidávejte automaticky. Spouštějte ji samostatně až po kontrole výstupů předchozích fází.
Testovací scénáře pro celý průchod
| ID | Typ | Průchod | Hlavní ověření | Stav |
|---|---|---|---|---|
HR-SMOKE-01 | smoke | nápověda a chyby argumentů | správný exit code, žádný dialog | doplnit |
HR-SYNTAX-01 | regression | validní a chybné XDS | exit 0/10, agregovaná diagnostika | pokryto |
HR-PREP-01 | workflow | kompletace → DAD → stránky | exit 0 a očekávané artefakty každé fáze | částečně; spojit do jednoho běhu |
HR-PREP-02 | regression | opakování přípravy nad resetovanou fixture | deterministický výsledek, žádný dialog | doplnit |
HR-DIAG-01 | regression | známá chyba kompletace | shodná evidence v JSON, errors.xel a stop-reason | pokryto pro kompletaci |
HR-ISOLATION-01 | known-bug | jiný runtime kořen | osobní init XML zůstane bajtově shodný | očekávaně selže do opravy |
HR-INSTALL-01 | regression | instalace bez potvrzení | exit 40, žádný částečný zápis | doplnit |
HR-E2E-01 | mutating | celý průchod včetně instalace | uzavřená verze a shoda instalovaných artefaktů | doplnit, jen explicitní opt-in |
Automatická větev má končit po pages-creating. HR-E2E-01 smí navázat pouze
na resetovatelné testovací instanci, v izolovaném uživatelském profilu a po
kontrole výstupů předchozích fází.
Očekávané exit codes
| Kód | Význam |
|---|---|
0 | úspěch |
10 | replikační/doménová chyba |
20 | technická chyba |
30 | chyba argumentů |
40 | chybějící potvrzení instalace |
99 | neošetřená výjimka |
Lokální spouštěcí sady
Konkrétní klientské cesty nejsou součástí veřejného kontraktu. Vývojový repozitář může obsahovat místní dávku nad resetovatelnou instancí; musí používat stejné argumenty jako příklady výše a instalaci chránit samostatným explicitním potvrzením.
Bezpečnostní omezení současných testů
Otázky při chybějícím versions\updates-list.mxl jsou nyní vedené přes
rpInput.MsgBox; v neinteraktivním režimu se vypíší do konzole a neotevřou
WinForms dialog. Přesto používejte krátký timeout jako regresní ochranu.
Explicitní --replicator-root stále mění společný uživatelský init soubor.
--no-appdata-fallback true zápisu nezabrání; pro jiný runtime kořen používejte
izolovaný uživatelský profil včetně AppData.
- instalační fázi používejte jen na výslovně určené testovací instanci;
- před automatizací ověřte obsah
StdOut,StdErra skutečný exit code; syntax-checkje lokální preflight XML a známých vlastností. Neprovádí kompletaci ani kontrolu externích referencí.