A CLI for Atlassian Plugins 3
A simple CLI for Atlassian Plugins 3 Add-ons
You can install me with:
npm i -g ap3-cli
ap3 doesn't attempt to do too much. Mainly, it's a helper tool for creating a add-on project scaffold.
Usage: ap3 [-h|--help] <command> [<args>] The most commonly used ap3 commands are: keygen Generate public and private RSA keys new Generate a new Plugins 3 Add-on scaffold Options: -h, --help Show usage -v, --version Show version
ap3-cli simplifies the process of building an Atlassian Add-on using the Express framework through:
On top of that, the generated scaffold bundles the node-ap3 package which greatly simplifies the process of creating remote add-ons.
Let's start by creating an add-on project:
ap3 new <project_name>
This will create the following code:
. ├── README.md ├── app.js ├── atlassian-plugin.xml ├── config.json ├── package.json ├── private-key.pem ├── public │ ├── css │ │ └── main.css │ └── js │ └── main.js ├── public-key.pem ├── routes │ └── index.js └── views ├── example.jade └── layout.jade
Go into your new project directory, then install the dependencies:
At this point, you're all set to run your add-on, but you'll need to have a host for your add-on. You have a few options:
If you've chosen the first option and have a running instance of the Vagrant box, you're all set. Now all you need to do to run your add-on inside your local JIRA or Confluence instance is:
This will boot up your Express server on the default port of 3000 and do the following:
atlassian-plugin.xml(at http://:3000$hostname/atlassian-plugin.xml) with the host
atlassian-plugin.xml. If the file is modified,
node-ap3will re-register your add-on with the host.
As you've noticed,
node-ap3 automatically registers your add-on with the host when it's started. Another nice feature is that it automatically de-registers it at shutdown
The configuration for your add-on is done in two files:
./config.json-- This file contains the configuration for each runtime environment your plugin runs in. The file has comments to help you understand the settings available.
./atlassian-plugin.xml-- This file is a manifest of all the "plugin points" your add-on uses. To see all of the available plugin point options check out the interactive guides for JIRA or Confluence.
Even though this is just an exploratory project at this point, it's also open source Apache 2.0. So, please feel free to fork and send us pull requests.