diff options
author | Christof Rabensteiner <christof.rabensteiner@iaik.tugraz.at> | 2019-08-19 16:15:42 +0200 |
---|---|---|
committer | Christof Rabensteiner <christof.rabensteiner@iaik.tugraz.at> | 2019-08-19 16:29:06 +0200 |
commit | d53d195b013b31445361a1ec53318a044b5fae5b (patch) | |
tree | e76cbb18a3272be5032bd5724c3b38410af314f3 | |
parent | 631af9a4ab6b75e11ab369c3a7d9ab22e60341e8 (diff) | |
download | moa-zs-d53d195b013b31445361a1ec53318a044b5fae5b.tar.gz moa-zs-d53d195b013b31445361a1ec53318a044b5fae5b.tar.bz2 moa-zs-d53d195b013b31445361a1ec53318a044b5fae5b.zip |
Update Version of EAAF Components Dependency
- Also: Replace local repository with apps.egiz.gv.at/maven
- Update Readme and remove cumbersome "build via local repo" guide.
-rw-r--r-- | pom.xml | 8 | ||||
-rw-r--r-- | readme.md | 61 |
2 files changed, 17 insertions, 52 deletions
@@ -19,14 +19,14 @@ <repositories> <repository> - <id>MOA</id> - <name>MOA Dependencies</name> + <id>EGIZ</id> + <name>EGIZ MVN Repository</name> <releases> <enabled>true</enabled> <checksumPolicy>ignore</checksumPolicy> </releases> <layout>default</layout> - <url>file://${basedir}/repository</url> + <url>https://apps.egiz.gv.at/maven/</url> </repository> </repositories> @@ -42,7 +42,7 @@ <immutable-xjc-plugin.version>1.5</immutable-xjc-plugin.version> <jacoco.version>0.8.3</jacoco.version> <egovutils.version>2.0.7-snapshot</egovutils.version> - <eaaf-components.version>1.0.7</eaaf-components.version> + <eaaf-components.version>1.0.9</eaaf-components.version> <maven-surefire-plugin.version>2.22.1</maven-surefire-plugin.version> <mzs.ns>http://reference.e-government.gv.at/namespace/zustellung/mzs/app2mzs#</mzs.ns> @@ -1,51 +1,12 @@ # MOA ZS -## Prepare for Compilation +## Compile, Test and Package -For compiling MOAZS, do the following: - -1. Checkout MoaZS repository (directory name `moazs.git`) -1. Install `at.gv.egiz.eaaf.{eaaf_module_moa-sig, core}` to local repository. -1. Make `eaaf_module_moa-sig`'s transitive dependencies available by copying or symlinking `eaaf_module_moa-sig`'s repository into MOAZS repository. - -Certain artifacts are not in the mvn central repo. You need to -install those articats to your local maven repository. - -### How to Install `at.gv.egiz.eaaf` Artifacts - -Requirements: JDK 1.8 - -``` -export EAAF_COMPONENTS_VERSION=1.0.7 -cd /path/to/working/dir -git clone https://gitlab.iaik.tugraz.at/egiz/eaaf_components/ -cd eaaf_components -git checkout $EAAF_COMPONENTS_VERSION -mvn clean package source:jar install -``` - -### Workaround: Make eaaf_module_moa-sig's Transitive Dependencies Available - -`eaaf_module_moa-sig` depends on artifacts that are also not in mvn's -central repo. You can make them available by copying or symlinking to -the repository directory in -https://gitlab.iaik.tugraz.at/egiz/eaaf_components/tree/master/eaaf_modules/eaaf_module_moa-sig/repository - -``` -cd moazs.git -# symlink to moa sig's artifacts -ln -s <path-to-local-eaaf-components-git-repo>/eaaf_modules/eaaf_module_moa-sig/repository -# copy repository -cp <path-to-local-eaaf-components-git-repo>/eaaf_modules/eaaf_module_moa-sig/repository . -``` - -## Compile & Test +Compilation and Runtime Requirements: +- openJDK 12 (OpenJDK 11 has an unfixed bug [1] that prevents the completion of TLS handshakes.) ### Run Unit Tests -Requirements: -- openJDK 12 (OpenJDK 11 has an unfixed bug [1] that prevents the completion of TLS handshakes.) - Command: ``` mvn test @@ -53,18 +14,14 @@ mvn test ### Run Integration Tests -Integration tests start with the prefix `IT`. - -Requirements: -- OpenJDK 12 -- Some integration tests have additional requirements (e.g. ITMsgClientTest also tests the TLS connection and Client Authentication). Ensure that these requirements are met as well. +Integration tests start with the prefix `IT`. Note that some integration tests have additional requirements (e.g. ITMsgClientTest also tests the TLS connection and Client Authentication). Ensure that these requirements are met as well. Command: ``` mvn test -P integration-test ``` -### Quick Guide: Set Up SSL in Apache 2. +#### Quick Guide: Set Up SSL (inc. Client Authentication) in Apache 2. Some tests in ITMsgClientTest require SSL protection of the service endpoint with SSL Client Authentication. Here's a quick guide how to set up an Apache 2 service on localhost as a SSL terminating reverse proxy to the zusemsg endpoint that runs on http://localhost:8081/ : @@ -91,6 +48,14 @@ SSLCertificateChainFile <path/to/repo/ssl/server>/ca-chain.cert.pem SSLCACertificateFile <path/to/repo/ssl>/trusted-cas-bundle.pem ``` +## Package to .war + +``` +mvn clean package +``` + +Find the war file in the `target/` folder. + # Footnotes [1] https://bugs.openjdk.java.net/browse/JDK-8214098 |