[incubator-hop-docs] branch asf-site updated: HOP-2122: add integration test docs

[ha...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

hansva pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-hop-docs.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 1beb2a1  HOP-2122: add integration test docs
     new da14e32  Merge pull request #19 from hansva/asf-site
1beb2a1 is described below

commit 1beb2a14ee31bdc85eda0fdcad90f8590589c414
Author: Hans Van Akelyen <ha...@gmail.com>
AuthorDate: Mon Dec 7 15:42:08 2020 +0100

    HOP-2122: add integration test docs
---
 .../modules/ROOT/pages/integration-testing.adoc    | 25 ++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/hop-dev-manual/modules/ROOT/pages/integration-testing.adoc b/hop-dev-manual/modules/ROOT/pages/integration-testing.adoc
new file mode 100644
index 0000000..876d655
--- /dev/null
+++ b/hop-dev-manual/modules/ROOT/pages/integration-testing.adoc
@@ -0,0 +1,25 @@
+[[integration-testing]]
+= Integration Testing
+
+The Apache Hop team has created an integration testing framework that is being used to test key components of the software.
+The integration tests run as a daily build on Jenkins and can be found https://ci-builds.apache.org/job/Hop/job/Hop-integration-tests/[here].
+
+== Current Limitations
+
+* Only workflows are supported
+* No external sources to test against (no databases or other services available)
+* Only local engines will work (including the Apache Beam Direct Runners)
+* No extra parameters can be provided to hop-run see https://issues.apache.org/jira/browse/HOP-2271[HOP-2271]
+* No true negative test can be created see https://issues.apache.org/jira/browse/HOP-2272[HOP-2272]
+
+
+== Adding a test
+
+The tests are stored in the source code repository and can be found in the https://github.com/apache/incubator-hop/tree/master/integration-tests[integration-tests] folder.
+Each folder represents an integration test that will be executed daily using the master branch version of the software.
+
+Each folder contains a Hop project and all metadata needed for that project, they are dynamically loaded and the `main.hwf` is executed using the `local` workflow engine.
+
+Adding a test is as simple as creating a new project that contains a `main.hwf` in the root folder and all test files should be self contained in the project folder.
+Please give each folder a HOP issue number or a self explaining foldername as this name is used for the test report in Jenkins.
+