How to automate installing add-ons for Atlassian applications

On this page

Description

Never has it been easier to automate the setup of new Atlassian applications for testing or production. This shows how a single command installs and licenses all the add-ons you require for your standard Atlassian application setup. We use this type of automation for setting up test instances on a regular basis. 

To optimize this solution, we recommend you create a licenses directory with all your add-on licenses as discussed in How to install and license many apps. Do this once and keep it updated as necessary.

The following requires a CLI 8.3 or higher client.

Jira

atlassian jira -a run --file install-jira-addons.txt


install-jira-addons.txt
# Install standard add-ons with licenses for Jira
#
# atlassian jira -a run --file install-jira-addons.txt

upm -a runFromList --continue \
               --common "-a installApp --wait --app @entry@" \
               --list " \
                   org.swift.jira.cli, \
                   org.swift.jira.acli, \
                   org.swift.jira.cot, \
                   org.swift.jira.cw, \
                   org.swift.jira.clone-plus, \
                   \
                   is.origo.jira.tempo-plugin, \
                   com.almworks.jira.structure, \
                   \
                   com.googlecode.jira-suite-utilities, \
               "

upm -a addLicenses --file licenses

Confluence

atlassian confluence -a run --file install-confluence-addons.txt
install-confluence-addons.txt
# Install standard add-ons with licenses for Confluence
#
# atlassian confluence -a run --file install-confluence-addons.txt

upm -a runFromList --continue \
               --common "-a installApp --wait --app @entry@" \
               --list " \
                   org.swift.confluence.cli, \
                   org.swift.confluence.acli, \
                   org.swift.confluence.cache, \
                   org.swift.confluence.excel, \
                   org.swift.confluence.flash, \
                   org.swift.confluence.html, \
                   org.swift.confluence.macrosecurity, \
                   org.swift.confluence.markdown, \
                   org.swift.confluence.run, \
                   org.swift.confluence.sql, \
                   org.swift.confluence.script, \
                   org.swift.confluence.table, \
                   org.swift.confluence.visio, \
                   org.swift.confluence.wiki, \
                   com.appfire.confluence.codepro, \
                   com.atlassian.confluence.extra.graphviz, \
                   \
                   com.adaptavist.confluence.contentFormattingMacros, \
                   net.customware.confluence.plugin.linking, \
                   net.customware.confluence.plugin.reporting, \
                   net.customware.confluence.plugin.composition, \
                   net.customware.confluence.plugin.visibility, \
                   net.customware.confluence.plugin.scaffolding, \
                   com.atlassian.confluence.plugins.editor.confluence-source-editor, \
               "

upm -a addLicenses --file licenses

Bitbucket

atlassian bitbucket -a run --file install-bitbucket-addons.txt
install-bitbucket-addons.txt
# Install standard add-ons with licenses for Bitbucket
#
# atlassian bitbucket -a run --file install-bitbucket-addons.txt

upm -a runFromList --continue \
               --common "-a installApp --wait --app @entry@" \
               --list " \
                   org.swift.stash.cli, \
                   org.swift.stash.acli, \
               "

upm -a addLicenses --file licenses

Bamboo

atlassian bamboo -a run --file install-bamboo-addons.txt
install-bamboo-addons.txt
# Install standard add-ons with licenses for Bamboo
#
# atlassian bamboo -a run --file install-bamboo-addons.txt

upm -a runFromList --continue \
               --common "-a installApp --wait --app @entry@" \
               --list " \
                   org.swift.bamboo.cli, \
                   org.swift.bamboo.acli, \
                   org.swift.bamboo.groovy, \
                   com.appfire.bamboo.sql, \
                   com.davidehringer.atlassian.bamboo.maven.maven-pom-parser-plugin, \
                   org.gaptap.bamboo.maven.maven-artifact-download-plugin, \
               "

upm -a addLicenses --file licenses

Example Output

This is an example run of the Bamboo setup script from above.

Example
atlassian bamboo -a run --file install-bamboo-addons.txt 

# Install standard add-ons with licenses for Bamboo
#
# atlassian bamboo --action run --file install-bamboo-addons.txt


Run: upm -a runFromList --common "-a installApp --wait --app @entry@" --list " org.swift.bamboo.cli, org.swift.bamboo.acli, org.swift.bamboo.groovy, com.appfire.bamboo.sql, com.davidehringer.atlassian.bamboo.maven.maven-pom-parser-plugin, org.gaptap.bamboo.maven.maven-artifact-download-plugin, "

Run: -a installApp --wait --app org.swift.bamboo.cli
Waiting for install to complete ..
App 'Bob Swift Atlassian Add-ons - Bamboo CLI Connector' installed with version 7.7.0. Version number was 770. App key is org.swift.bamboo.cli.

Run: -a installApp --wait --app org.swift.bamboo.acli
Waiting for install to complete ..
App 'Bob Swift Atlassian Add-ons - Run CLI Actions in Bamboo' installed with version 7.7.0. Version number was 770. App key is org.swift.bamboo.acli.

Run: -a installApp --wait --app org.swift.bamboo.groovy
Waiting for install to complete .
App 'Bob Swift Atlassian Add-ons - Groovy Tasks' installed with version 2.8.0. Version number was 280. App key is org.swift.bamboo.groovy.

Run: -a installApp --wait --app com.appfire.bamboo.sql
Waiting for install to complete .
App 'Bob Swift Atlassian Add-ons - SQL Tasks' installed with version 1.2.0. Version number was 120. App key is com.appfire.bamboo.sql.

Run: -a installApp --wait --app com.davidehringer.atlassian.bamboo.maven.maven-pom-parser-plugin
Waiting for install to complete .
App 'Maven POM Value Extractor' installed with version 1.7.0. Version number was 72. App key is com.davidehringer.atlassian.bamboo.maven.maven-pom-parser-plugin.

Run: -a installApp --wait --app org.gaptap.bamboo.maven.maven-artifact-download-plugin
Waiting for install to complete .
App 'Maven Artifact Download Plugin' installed with version 1.1. Version number was 15. App key is org.gaptap.bamboo.maven.maven-artifact-download-plugin.

Run completed successfully. 6 actions were successful 


Run: upm -a addLicenses --file licenses
License is the same as existing license for add-on org.swift.bamboo.groovy. Ignore request.
License added to app org.swift.bamboo.acli.
License added to app com.appfire.bamboo.sql.
4 apps found that use licensing. 3 licenses added or matched existing license. 

Run completed successfully. 2 actions were successful from file '.../install-bamboo-addons.txt'.