Update latest AMPS documentation for JIRA Service Desk

The current AMPS documentation is not updated for AMPS 8 (latest) for additional Jira applications such as Jira Service Desk:

The current doc says (based on AMPS 5.1.7 and above / notice that is maven-jira-plugin artifactId):

<plugin>
    <groupId>com.atlassian.maven.plugins</groupId>
    <artifactId>maven-jira-plugin</artifactId>
    <configuration>
        <applications>
            <application>
                <applicationKey>jira-software</applicationKey>
                <version>${jira.software.application.version}</version>
            </application>
            <application>
                <applicationKey>jira-servicedesk</applicationKey>
                <version>${jira.servicedesk.application.version}</version>
            </application>
        </applications>
    </configuration>
</plugin>

Using AMPS 8 it should use jira-maven-plugin artifactId as the following:

<plugin>
    <groupId>com.atlassian.maven.plugins</groupId>
    <artifactId>jira-maven-plugin</artifactId>
    <version>${amps.version}</version>
    <extensions>true</extensions>
    <configuration>
        <productVersion>${jira.version}</productVersion>
        <productDataVersion>${jira.version}</productDataVersion>
        <!-- Uncomment to install TestKit backdoor in JIRA. -->
        <!--
        <pluginArtifacts>
            <pluginArtifact>
                <groupId>com.atlassian.jira.tests</groupId>
                <artifactId>jira-testkit-plugin</artifactId>
                <version>${testkit.version}</version>
            </pluginArtifact>
        </pluginArtifacts>
        -->
        <enableQuickReload>true</enableQuickReload>
        <!-- See here for an explanation of default instructions: -->
        <!-- https://developer.atlassian.com/docs/advanced-topics/configuration-of-instructions-in-atlassian-plugins -->
        <instructions>
            <Atlassian-Plugin-Key>${atlassian.plugin.key}</Atlassian-Plugin-Key>
            <!-- Add package to export here -->
            <Export-Package>com.xyz.jira.plugins,</Export-Package>
            <!-- Add package import here -->
            <Import-Package>org.springframework.osgi.*;resolution:="optional", org.eclipse.gemini.blueprint.*;resolution:="optional", *</Import-Package>
            <!-- Ensure plugin is spring powered -->
            <Spring-Context>*</Spring-Context>
        </instructions>
        <applications>
            <application>
                <applicationKey>jira-software</applicationKey>
                <version>${jira.version}</version>
            </application>
            <application>
                <applicationKey>jira-servicedesk</applicationKey>
                <version>${jira.servicedesk.version}</version>
            </application>
        </applications>
    </configuration>
</plugin>

Where the jira.servicedesk.version property is based on jira.version, the following page helped me to set it properly:

https://marketplace.atlassian.com/apps/1213632/jira-service-desk/version-history

It would be nice to update this documentation and find out a way to easily leverage JIRA service desk in AMPS configuration. :slight_smile:

4 Likes