Package a custom blade

Before you can deploy a newly developed custom blade to a Deployment Framework on a production system, it has to be packaged into a kit. Here's how to do this.

These instructions apply to all blades except Java-based adapters created using Caplin's Gradle project templates hosted on GitHub. For more information on packaging Java adapters, see Caplin Integration Suite.

Prepare the blade files

The files for the blade must be located in the Deployment Framework directory structure under <Framework-root>/kits/<blade_name> /<blade-name>

Make sure that all the files required for the blade are present and are in the correct directory structure. For more information about the directory structure and files required for the type of blade you're creating, refer to the relevant page via one of the links in How can I... Create a custom blade.

Delete any files that are in the blade's DataSource/var directory (<Framework-root>/kits/<blade_name>/<blade-name>/DataSource/var)

Naming the blade kit

Give your blade kit a name of this form:
<blade_name>-<version_number>

For example, if your blade is called MyAdapterBlade, and the version of the blade that you want to package is 000017, the full kit name would be MyAdapterBlade-000017

Creating the blade kit on Windows

To create a new blade kit on Windows:

  1. In Cygwin, navigate to the directory <Framework-root>/kits/<blade-name>
  2. Run this zip command:
    zip –qyr <kit-name>.zip <blade_name>

    For example:
    zip –qyr MyAdapterBlade-000017.zip MyAdapterBlade
  3. Move the newly created .zip file out of the kits directory, so it doesn't inadvertently get deployed when you next run .dfw /deploy or deleted when you run ./dfw delete

Creating the blade kit on Linux

To create a new blade kit on Linux:

  1. Navigate to the directory <Framework-root>/kits/<blade-name>
  2. Run these tar commands in order:
    tar cf <kit-name>.tar <blade_name>
    gzip <kit-name>.tar

    For example:
    tar cf MyAdapterBlade-000017.tar MyAdapterBlade
    gzip MyAdapterBlade-000017.tar
  3. Move the newly created .tar.gz file out of the kits directory, so it doesn't inadvertently get deployed when you next run .dfw /deploy or deleted when you run ./dfw delete

Deploying the new blade

Once you've packaged the new blade, you'll want to deploy it on your production, pre-production, or test system - see How can I... Deploy a custom blade.