mirror of
https://github.com/pgbackrest/pgbackrest.git
synced 2024-12-14 10:13:05 +02:00
c9b49b0d7e
Bug Fixes: * Fixed and issue that suppressed exceptions in PDF builds. Features: * Allow a source to be included as a section so large documents can be broken up. * Added section link support to Markdown output. * Added list support to PDF output. * Added include option to explicitly build sources (complements the exclude option though both cannot be used in the same invocation). * Added keyword-add option to add keywords without overriding the default keyword. * Added debug option to doc.pl to easily add the debug keyword to documentation builds. * Added pre option to doc.pl to easily add the pre keyword to documentation builds. Refactoring: * Improvements to markdown rendering. * Remove code dependency on project variable, instead use title param.
66 lines
2.8 KiB
XML
66 lines
2.8 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE doc SYSTEM "doc.dtd">
|
|
<doc title="{[project]}" subtitle="Regression, Unit, & Integration Testing" toc="y">
|
|
<description>{[project]} testing configuration requirements, setup, and options.</description>
|
|
|
|
<section id="introduction">
|
|
<title>Introduction</title>
|
|
|
|
<p><backrest/> uses Docker to run tests and generate documentation. Docker's light-weight virualization provides the a good balance between proper OS emulation and performance (especially startup)</p>
|
|
|
|
<p>A `Vagrantfile` is provided that contains the complete configuration required to run <backrest/> tests and build documentation. If Vagrant is not suitable then the `Vagrantfile` still contains the configuration steps required to build a test system.</p>
|
|
|
|
<p>Note that this is not required for normal operation of <backrest/>.</p>
|
|
</section>
|
|
|
|
<section id="testing">
|
|
<title>Testing</title>
|
|
|
|
<p>The easiest way to start testing <backrest/> is with the included `Vagrantfile`.</p>
|
|
|
|
<code-block title="Build Vagrant and Logon">
|
|
cd test
|
|
vagrant up
|
|
vagrant ssh
|
|
</code-block>
|
|
|
|
<p>The <code>vagrant up</code> command may take some time as a number of Docker containers must also be built. The <code>vagrant ssh</code> command automatically logs onto the VM.</p>
|
|
|
|
<code-block title="Run All Tests">
|
|
/backrest/test/test.pl
|
|
</code-block>
|
|
|
|
<code-block title="Run Tests for a Specific OS">
|
|
/backrest/test/test.pl --vm=co6
|
|
</code-block>
|
|
|
|
<code-block title="Run Tests for a Specific OS and Module">
|
|
/backrest/test/test.pl --vm=co6 --module=backup
|
|
</code-block>
|
|
|
|
<code-block title="Run Tests for a Specific OS, Module, and Test">
|
|
/backrest/test/test.pl --vm=co6 --module=backup --test=full
|
|
</code-block>
|
|
|
|
<code-block title="Run Tests for a Specific OS, Module, Test, and Run">
|
|
/backrest/test/test.pl --vm=co6 --module=backup --test=full --run=1
|
|
</code-block>
|
|
|
|
<code-block title="Run Tests for a Specific OS, Module, Test, and Process Max">
|
|
/backrest/test/test.pl --vm=co6 --module=backup --test=full --process-max=4
|
|
</code-block>
|
|
|
|
<p>Note that process-max is only applicable to the <id>synthetic</id> and <id>full</id> tests in the <id>backup</id> module.</p>
|
|
|
|
<code-block title="Run Tests for a Specific OS, Module, Test, Process Max, and Database Version">
|
|
/backrest/test/test.pl --vm=co6 --module=backup --test=full --process-max=4 --db-version=9.4
|
|
</code-block>
|
|
|
|
<p>Note that db-version is only applicable to the <id>full</id> test in the <id>backup</id> module.</p>
|
|
|
|
<code-block title="Iterate All Possible Test Combinations">
|
|
/backrest/test/test.pl --dry-run
|
|
</code-block>
|
|
</section>
|
|
</doc>
|