Atlassian sdk Frequently used commands

In this section, we will look at some typical tasks and give examples
of the SDK scripts you can use. The following topics are covered:

Creating a New Plugin from Scratch Say you want to create a new
Confluence plugin skeleton. Simply open a command window, go to the
directory where you want to create the plugin and type:

Copy atlas-create-confluence-plugin Similarly, you would enter one of
the following to create a plugin for JIRA, Bamboo or the RefApp:

Copy atlas-create-jira-plugin atlas-create-bamboo-plugin
atlas-create-refapp-plugin Running a Plugin in an Application Say you
want to install and run your plugin in your host Atlassian
application. Go to the plugin’s project directory (where you created
the plugin) and type:

Copy atlas-run Note that the above shell script will work for any host
application, including Confluence, JIRA, etc. The script will
determine the application, based on your plugin’s specifications.

Specifying a Version of the Application Say you want to run your
plugin with Confluence 2.10.3. Go to the plugin’s project directory
(where you created the plugin) and type:

Copy atlas-clean atlas-run --version 2.10.3 Say you want to run your
plugin with JIRA 4.0 snapshot. Go to the plugin’s project directory
(where you created the plugin) and type:

Copy atlas-clean atlas-run --version 4.0-SNAPSHOT Note: Running
atlas-clean will clear the previous version of the host application
from your build output directory. You only need to do this if the
previous application version was different from the one you need now.

Specifying an Application Server (Container)

Say you want to run your plugin with Confluence 2.10.3 and JBoss
4.2.x. Go to the plugin’s project directory (where you created the plugin) and type:

Copy atlas-run --version 2.10.3 --container jboss42x Specifying a
Version of SAL Say you want to run that plugin but with Confluence
2.10.3 and SAL 2.0.5:

Copy atlas-run --version 2.10.3 --sal-version 2.0.5 Running
Integration Tests against a Different Application Say you have a
RefApp plugin but want to run your integration tests against
Confluence:

Copy atlas-integration-test --product confluence Running your Plugin
in Multiple Applications Say you want to run that RefApp plugin in
multiple applications simultaneously. In three separate tabs in your
terminal (command window):

Type the following to run the plugin in the RefApp:

Copy atlas-run Type the following to run the plugin in Confluence:

Copy atlas-run --product confluence --version 3.0-m9 Type the
following to run the plugin in JIRA:

Copy atlas-run --product jira --version 4.0-SNAPSHOT Using the Maven
Command Line Interface The SDK bundles the Maven CLI plugin and
pre-configures it properly with the pi and pu commands. To use it with
your plugin’s host application, go to the plugin’s project directory
(where you created the plugin) and type:

Copy atlas-cli Generating Test Data for Re-Use Use the
atlas-create-home-zip command to create a zip file of your
application’s home directory, and then load the contents of the home
directory into the application every time you start it up.

For example, let’s assume you want to prepopulate JIRA with a few
projects and issues for testing on every clean startup. First, run
JIRA using atlas-run and add your projects and issues. Stop JIRA, go
to the project directory (where you created the plugin) and type:

Copy atlas-create-home-zip Copy the generated-test-resources.zip file
to the test /src/test/resources/ directory. Then add the following
element to the configuration of the maven-jira-plugin in your POM:

Copy
${basedir}/src/test/resources/generated-test-resources.zip
See atlas-create-home-zip.