Skip to content

v2022.2- 21/06/2022

Compare
Choose a tag to compare
@dperezBM dperezBM released this 21 Jun 06:36
· 44 commits to master since this release
ed6b791

The version published at this time contains breaking and non-breaking changes.

🚀 New Features

  • #765 Validation against the latest INSPIRE official schemas - #748
  • #770 INSPIRE data sets and data set series metadata for IACS multilanguage- #749

🐛 Bugfixes

  • #569 tn-gml typo correction - #750
  • #618 #703 invalidLegendFormat message updated - #751
  • #710 am-as-a.2 missingElement and missingAttribute property fixed - #752
  • #714 su-vector-as.b.1 and su-vector-as.b.2 updated - #753
  • #729 Conformance class description typo fixed - #754
  • #742 5621, 9389 and 9390 EPSG codes added - #755
  • #747 pf-gml typo fixed - #756
  • #749 outputSchema and elementSetName default parameters added in UI
  • #780 #718 #771 Not required service metadata checks removed- #757

🚀 Validator UI

  • #24 New cookie consent on Validator UI - #25
  • #23 Quick links in the "Get support" menu need to be changed
  • #22 Wrong CC for some US application schemas - #21
  • #19 URL Metadata validation for non-ISO default responses - #20
  • #14 Staging/production parametrization - #18
  • #13 Typo for AD data theme - #15
  • #10 Missing CC name for BU3D
  • #9 Outdated instructions to be removed
  • #8 Date display issue bug - #12
  • #7 Link to be changed - #11

Deployment instructions

The section containing the deployment process using Docker image and troubleshooting section. You can also find these in the training material

docker login docker.pkg.github.com 
#Provide Github credentials
docker run --name inspire-validator -d -p 8090:8090 -v ~/etf:/etf docker.pkg.github.com/inspire-mif/helpdesk-validator/inspire-validator:2022.2
#Launches a container with the image, exposing the UI in port 8090 through the same port in the host machine, and uses a volume in the local file system, on the directory ~/etf
Modifying the Docker image

In the inspire-validator ZIP file, you can find all the resources needed to generate the Docker image from this release. If you would like to tweak anything from it, you can modify any of its contents (Dockerfile, entrypoint file, configuration files... ), then execute the command

docker build -t [IMAGE_NAME]:[VERSION]

You can run this again using the run command

docker run --name inspire-validator -d -p 8090:8090 -v ~/etf:/etf [IMAGE_NAME]:[VERSION]
Deployment on production host

The Docker image is set up to run at localhost to be deployed on any machine. However, users may need to access their validator on a dedicated host, usually with a domain name. For proper functioning of the validator, the UI and correct rendering of Test Reports, the validator needs to be configured to run on a domain.

If you want to run the webapp in another host, you can change the configuration file, inside the .war file inside the inspire-validator zip file accompanying this release, at WEB-INF/classes/etf-config.properties, and modify the etf.webapp.base.url property.
It is also necessary to configure the Validator UI properties in order to properly point to the ETF. Thus, it is necessary to modify the configuration values in the /validator/js/config.js file inside the ui.zip (to point to the corresponding host domain).
Then you can proceed to the build process described in the previous point.

Exposing the validator through a proxy

Usually, host machines are connected to a private network that accesses the Internet through a proxy. The Docker client needs to be configured to make use of this proxy, in order to be able to build the image and set up running the container.

For the build process, you need to add the following arguments to the command

--build-arg http_proxy=[HTTP_PROXY_URL:PORT]  --build-arg https_proxy=[HTTPS_PROXY_URL:PORT]  --build-arg no_proxy=127.0.0.1,localhost,*.<my-domain>

For the run command, you need to add the environment variables to it

--env http_proxy=[HTTP_PROXY_URL:PORT]  --env https_proxy=[HTTPS_PROXY_URL:PORT]  --env no_proxy=127.0.0.1,localhost,*.<mydomain>

These can also be set up in the Dockerfile, using the keyword ENV

For more information please check out https://docs.docker.com/network/proxy

For further configuration, please download the file inspire-validator-2022.2.zip and follow the instructions in the README.md file inside the .zip file.