PDS Registry
The PDS Registry provides functionality for tracking, searching, auditing, locating, and maintaining artifacts within the system. These artifacts can range from data files and label files, schemas, dictionary definitions for objects and elements, services, etc. The core functionality for this component is satisfied by Apache Solr.
A sub-component of the PDS Registry App (https://github.com/NASA-PDS-Incubator/pds-app-registry).
Documentation
The documentation for the latest release of the PDS Registry, including release notes, installation and operation of the software are online at https://nasa-pds-incubator.github.io/registry/.
If you would like to get the latest documentation, including any updates since the last release, you can execute the "mvn site:run" command and view the documentation locally at http://localhost:8080.
Build
The software can be compiled and built with the "mvn compile" command but in order to create the JAR file, you must execute the "mvn compile jar:jar" command.
In order to create a complete distribution package, execute the following commands:
% mvn site
% mvn package
Release
Here is the procedure for releasing the software both in Github and pushing the JARs to the public Maven Central repo.
Pre-Requisites
- Make sure you have your GPG Key created and sent to server.
- Make sure you have your .settings configured correctly for GPG:
<profiles>
<profile>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<gpg.executable>gpg</gpg.executable>
<gpg.keyname>KEY_NAME</gpg.keyname>
<gpg.passphrase>KEY_PASSPHRASE</gpg.passphrase>
</properties>
</profile>
</profiles>
Operational Release
-
Checkout the dev branch.
-
Version the software:
mvn versions:set -DnewVersion=1.2.0
- Deploy software to Sonatype Maven repo:
# Operational release
mvn clean site deploy -P release
-
Create pull request from dev -> master and merge.
-
Tag release in Github
-
Update version to next snapshot:
mvn versions:set -DnewVersion=1.3.0-SNAPSHOT
SNAPSHOT Release
-
Checkout the dev branch.
-
Deploy software to Sonatype Maven repo:
# Operational release
mvn clean site deploy
Maven JAR Dependency Reference
Official Releases
https://search.maven.org/search?q=g:gov.nasa.pds%20AND%20a:registry&core=gav
Snapshots
https://oss.sonatype.org/content/repositories/snapshots/gov/nasa/pds/registry/
If you want to access snapshots, add the following to your ~/.m2/settings.xml
:
<profiles>
<profile>
<id>allow-snapshots</id>
<activation><activeByDefault>true</activeByDefault></activation>
<repositories>
<repository>
<id>snapshots-repo</id>
<url>https://oss.sonatype.org/content/repositories/snapshots</url>
<releases><enabled>false</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</repository>
</repositories>
</profile>
</profiles>