Repository: polygene-java Updated Branches: refs/heads/develop 431695a19 -> 7cedbf2e6
build: fix build system documentation with recent changes Project: http://git-wip-us.apache.org/repos/asf/polygene-java/repo Commit: http://git-wip-us.apache.org/repos/asf/polygene-java/commit/7cedbf2e Tree: http://git-wip-us.apache.org/repos/asf/polygene-java/tree/7cedbf2e Diff: http://git-wip-us.apache.org/repos/asf/polygene-java/diff/7cedbf2e Branch: refs/heads/develop Commit: 7cedbf2e6a4d77c9b4b7e924d5727e4446d3dfd7 Parents: 431695a Author: Paul Merlin <[email protected]> Authored: Sat Feb 25 15:31:25 2017 +0100 Committer: Paul Merlin <[email protected]> Committed: Sat Feb 25 15:31:25 2017 +0100 ---------------------------------------------------------------------- manual/src/docs/tutorials/howto-build-system.txt | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/polygene-java/blob/7cedbf2e/manual/src/docs/tutorials/howto-build-system.txt ---------------------------------------------------------------------- diff --git a/manual/src/docs/tutorials/howto-build-system.txt b/manual/src/docs/tutorials/howto-build-system.txt index 1a5fe9d..0daa44f 100644 --- a/manual/src/docs/tutorials/howto-build-system.txt +++ b/manual/src/docs/tutorials/howto-build-system.txt @@ -167,12 +167,14 @@ For example, the Redis EntityStore extension requires an actual Redis server to NOTE: The HTML test reports generated by Gradle shows skipped tests. -Testing against external services is automated using Docker and is enabled if you have the -`DOCKER_HOST` environment variable set. +Testing against external services is automated using Docker and is enabled automatically if a running Docker service +is reachable. The build creates the necessary Docker images and start/stop containers around the tests. -The simplest way to get this running is to use `docker-machine` to create a development Docker virtual machine -where all images will be built and containers started: +On Linux it should work out of the box. + +The simplest way to get this running on other systems (macOS and Windows) is to use `docker-machine` to create a +development Docker virtual machine where all images will be built and containers started: [source,bash] ---- @@ -183,9 +185,12 @@ eval $(docker-machine env dev) The last stanza set environment variables for Docker to use the newly created Docker virtual machine. +If you want to run the Docker containers in a remote machine, simply set the `DOCKER_HOST` and `DOCKER_CERT_PATH` +environment variables to something sensible for your setup. + === Performance tests === -Performance tests provide performance mesurements for typical Polygene⢠use cases. +Performance tests provide performance measurements for typical Polygene⢠use cases. They are not part of the default build and are located in the `tests/performance` directory of the SDK. They can be run with the following Gradle command:
