Přejít na obsah
Skip to main content

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:

  • instanceConfig je existující konfigurace testovací aplikace;
  • replicatorRoot je úplná runtime složka replikátoru se system.xcf, jazyky, XSLT a dalšími podpůrnými soubory;
  • inputXds je vstupní XDS;
  • versionFolder je 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​

IDTypPrůchodHlavní ověřeníStav
HR-SMOKE-01smokenápověda a chyby argumentůsprávný exit code, žádný dialogdoplnit
HR-SYNTAX-01regressionvalidní a chybné XDSexit 0/10, agregovaná diagnostikapokryto
HR-PREP-01workflowkompletace → DAD → stránkyexit 0 a očekávané artefakty každé fázečástečně; spojit do jednoho běhu
HR-PREP-02regressionopakování přípravy nad resetovanou fixturedeterministický výsledek, žádný dialogdoplnit
HR-DIAG-01regressionznámá chyba kompletaceshodná evidence v JSON, errors.xel a stop-reasonpokryto pro kompletaci
HR-ISOLATION-01known-bugjiný runtime kořenosobní init XML zůstane bajtově shodnýočekávaně selže do opravy
HR-INSTALL-01regressioninstalace bez potvrzeníexit 40, žádný částečný zápisdoplnit
HR-E2E-01mutatingcelý průchod včetně instalaceuzavř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ódVýznam
0úspěch
10replikační/doménová chyba
20technická chyba
30chyba argumentů
40chybějící potvrzení instalace
99neoš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, StdErr a skutečný exit code;
  • syntax-check je lokální preflight XML a známých vlastností. Neprovádí kompletaci ani kontrolu externích referencí.