atlas-create-home-zip

This page describes the shell script atlas-create-home-zip, part of the Atlassian Plugin SDK.

Basic usage

 atlas-create-home-zip - Creates a test-resources zip of the current application's home directory. This zip file can then be pointed to in the AMPS productDataPath property to auto-populate application data during startup.

Examples

Let's assume you want to prepopulate JIRA with a few projects and issues for testing on every clean startup. First, run the application as you normally would using atlas-run. Next, use the JIRA web interface to create your projects and issues. Stop JIRA (CTRL+C). Finally, go to the root directory of your plugin and type:

1

atlas-create-home-zip

This will create a file called generated-test-resources.zip in the plugins target folder. Copy this file to a known location (such as, src/test/resources). Finally add:

1

<productDataPath>${basedir}/src/test/resources/generated-test-resources.zip</productDataPath>

to the <configuration/> of the maven-jira-plugin or maven-confluence-plugin in your pom.xml. The completed configuration should look something like this:

pom.xml

1
2
3
4
5
6
7
8
9
10
11
12

<plugin>
    <groupId>com.atlassian.maven.plugins</groupId>
    <artifactId>maven-confluence-plugin</artifactId>
    <version>${amps.version}</version>
    <extensions>true</extensions>
    <configuration>
        <productVersion>${confluence.version}</productVersion>
        <productDataVersion>${confluence.data.version}</productDataVersion>
        <!-- Add the productDataPath configuration here -->
        <productDataPath>${project.basedir}/src/test/resources/generated-test-resources.zip</productDataPath>
    </configuration>
</plugin>

Now every time you start Jira or Confluence using atlas-run or atlas-debug, the home directory will be prepopulated using the contents of the generated zip file.