Gld Extension Development

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

Internal

Overview

cd projects/gld/extensions/<extension-name>
release snapshot

The above will build the extension and install it in ${RUNTIME_DIR}/gld/extensions. The location of the installation directory can be configured in <extension-name>/.nort/project.yaml, as "install/installation.directory".

Extension Name

The extension name, as described by the "gld Concepts - Extension Name" section, must be specified as the "extension.name" property in the extension project POM:

<project ...>
    ...
    <properties>

        <extension.name>jboss-datagrid-7</extension.name>

        ...
    </properties>
   ...
</project>

The POM "extension.name" property is the authoritative source of information for extension name, and it will be inferred from it everywhere extension name is necessary.

For simplicity, it is recommended that the extension top-level directory of the extension project has the same name as "extension.name".

Extension Version

Use a variant of the procedure described here Nova Ordis Utilities Version Metadata Handling, with the difference that the resource file has an extension-specific name (example: "jboss-datagrid-7-extension-version") and call VersionUtilities.getVersion(<extension-specific-resource-file-name>) instead.