A DTK plugin is created and committed by following these steps:

1. For agent plugins, create a Configuration Contract, see Configuration Contract for further information about the contents of the configuration contract. For other types of plugins, skip this step.
    

2. For agent plugins, generate a Java file from your configuration contract:

   > java -classpath $CLASSPATH com.digitalroute.devkit.tools.ContractGen \
   -d . -f MyAgentConfigContract.xml

   For other types of plugins, skip this step.
    

3. Create the different Java files required for the type of plugin you want to create. See the chapters describing each plugin for further information.
    

4. Compile all the Java files for your plugin into classes:

   > javac -classpath $CLASSPATH com/mycompany/myagent/*.java

   Note!

   It is strongly recommended that the Java code does not use the default package context. All classes in must have unique names.

5. Create a user defined *.jar file containing the classes, see the section below, Creating a User Defined Jar File.
    
6. Create a user defined *.mzp package containing the *.jar file, see the section below, Creating a User Defined Package.
    
7. Commit your user defined package, see the section below, Committing a User Defined Package.
    
8. If you want to have user documentation for your agent plugin, create the documentation, wrap it into a user defined package and commit the package. See Documentation for Agent Plugins for information about how to create and implement the help content.

Creating a User Defined Jar

For more information, refer to the same section in Creating a DTK Plugin.

Creating a User Defined Package

For more information, refer to the same section in Creating a DTK Plugin.

Committing a User Defined Package

For On-Premise, Non-Containerized environment:

New or updated code is inserted into the system using the mzsh Command Line Tool:

> mzsh username/password pcommit my_agent.mzp

For Containerized Environment (AWS or private container):

Before committing any user defined packages, your containerized environment needs to have been configured so that the /opt/mz/codeserver-dtk folder is mounted to a persistent storage.

An example configuration for this is provided. Look for the lines "# uncomment in order to load development toolkits from persistent storage" in the following config files:

• mzhome-pvc.yaml
• platform-statefulset.yaml

Example of configs can be download from Release Notes 8.1.

This is a one time configuration. Once done, any user defined package can be committed as per the instructions below.

Transfer the file to the kubernetes container and restart the pod.

> kubectl cp my_agent.mzp delivery/platform-0:/opt/mz/codeserver-dtk/packages/active
> kubectl delete pod platform-0