Release Notes 9.3

Created by Bob Swift (Bob Swift Atlassian Apps)
Last updated: Dec 03, 2020 by Former user (Deleted)Version comment

Overview

This page provides information about an individual release of the Atlassian Command Line Interface (CLI) family of add-ons.
More release notes for additional versions of this product are available on the Release Notes page.

Slide Shows

NEW! We have released a number of educational slide shows covering different topics for the Atlassian CLI.
Atlassian CLI Slide Shows

Release Highlights

Release Date2020-06-26
Version

9.3

Purpose
  • All Clients
    • New replacement variables for file information on get and get list actions
    • Find replace - removed deprecated support - see ACLI-917
    • Retry support for failed actions in a run script
  • Jira, Agile, Service Desk, Tempo
    • New custom field options actions for add, remove, and list
    • New runFromFieldList action
    • More information on getIssue included expanded custom field information
    • exportData support for exporting custom field options
    • exportData support for exporting permissions for a permission scheme
    • Many improvements to permission and permission scheme actions and new runFromPermissionList action
    • Additional parameter support on cloneIssues
    • Copy remote links support on cloneIssue, cloneIssues, cloneProject, and copyIssue actions 
    • More detailed information on getIssue especially for fields
    • getProjectTemplateList improvements
    • Allow targetServer parameter to reference configuration entries
    • updateUser now allows setting password (server only)
    • Add project name column to getIssueList action for all output formats
    • Support Jira 8.10
  • Confluence
    • getSource improvements including find replace support
    • Show login information on getUser (server only)
    • updateUser now allows setting password (server only)
    • Performance improvement for getSpacePermissionList
    • getSource action improvements
    • Allow targetServer parameter to reference configuration entries
    • Support Confluence 7.6 
  • Bitbucket
    • Additional fields on getPullRequest action
    • Expand user fields on various get permission actions
    • Performance improvements for addUserToGroup
  • Bitbucket Cloud
    • New project actions
    • New team actions
    • New branch actions
    • Some refactored list output changes for consistency
    • Allow targetServer parameter to reference configuration entries
  •  Bamboo
    • Expiry management actions including setExpiryOptions and runBuildExpiry
    • More replacement variables for queueBuild, getBuild, and runFromBuildList
    • exportDeploymentProject now supports java spec export type in addition to CLI
    • Support Bamboo 7.1 including project level variables
  • Fixes

Also available as a Docker image

Compatibility


Special Compatibility Notice for Version 9.x

If you are upgrading from 8.x, note that there were some significant changes in 9.0 that will impact your configuration and usage.

See Special Compatibility Notice for CLI Version 9.x.

Compatibility

The Atlassian Command Line Interface (CLI) supports a large range of product releases. The matrix below provides compatibility guidelines based on testing, API compatibility information provided by Atlassian, and community feedback. User's are encourage to help improve compatibility information through discussions and issues. The CLI also works with releases not officially listed here since in many cases it uses remote APIs provided by Atlassian that have been stable for many years. Check previous versions of the CLI for coverage of earlier releases. Users should verify their usage scenarios on new releases. Support normally is limited to minimum releases indicated. Client requires at least Java 8 (1.8) and we test with both Java 8 and 11. In some cases, new actions are only available on later versions of the server - these are often noted in the documentation or in error messages.

To simplify the matrix, we no longer list much older releases even though there is some level of compatibility for these as well. Refer to earlier compatibility notes for information on older releases.

See also Compatibility for overall information on supported Atlassian releases.

CLI Clients and Connectors

  • (tick) Jira Service Desk releases compatible with corresponding Jira releases.
  • (tick) 3rd-party apps - like Tempo for instance: We don't explicitly list application versions, but normally test against a recent release of the app that is compatible with the platform it runs on.
  • (tick) Data Center is normally tested on the supported enterprise release designated by Atlassian.

Script Compatibility Warnings

  • JSON output changes - ACLI-1438 and ACLI-1453
  • getIssue action - new project name field added to all output formats - see ACLI-1215
  • findReplace parameter - no longer supports comma separated values - see ACLI-917
  • Bitbucket Cloud list action output changes for consistency

Run CLI Apps

Apps install and run on an Atlassian application server.

Atlassian App Compatibility

The Atlassian CLI supports a number of different Atlassian apps like Jira Software, Service Desk, and Confluence Questions. We only test and support the most current maintenance release of the apps available for the respective Atlassian application.

Atlassian Incompatibilities

The CLI clients always try to maintain upward compatibility between releases. However, in some cases this is not possible. Occasionally server differences may cause some compatibility issues.

Issues

Key Summary Component/s T P Status Created
Refresh