Need to know how CLI works with CLI client v9.0 and above in Windows

This article is to give the step by step instructions on how to install the Jira CLI and execute CLI commands in Windows with CLI client version 9.0 and above.

Instructions

CLI is a command-line interface to access Jira remotely. CLI has 2 components:

• CLI Client - Installed on any Windows system that has Java wither version 8 or higher.
• CLI Connector - Installed on the server using UPM.

JIRA CLI Client Installation:

1. You need to download the latest client version from this page. For example, you can click on the atlassian-cli-9.1.0-distribution.zip to download the latest client version v9.1.0. (which is the latest at the time of writing this document).
2. Once the file is downloaded, extract the files. For example, you can right-click on the downloaded file and click on Extract Files... as shown in the below screenshot. Here, we have used the 7-Zip software.
   
3. Go to the ACLI folder (Ex: atlassian-cli-9.1.0)
4. Rename the acli-server file to acli as shown in the below screenshot.
   

5.  Update the acli.properties file as per the below instructions:

   1. Credentials with respect to your instance details where you want to execute the CLI actions.
      

      credentials       = --user automation --password automation

      
      

   2. If you want to execute the CLI action for confluence, then commentmyjiraoption and give the Confluence URL detail of your instance.
      

      myjira            = jira -s https://jira.examplegear.com ${credentials}
      #myconfluence      = confluence -s https://confluence.examplegear.com ${credentials}

   3. This defines the default client for actions, choose either Jira / Confluence based on where you want to execute CLI actions.
      

      default           = ${myjira}

   4.  Save file.

JIRA CLI Connector Installation:

1. Log into Jira as an Administrator and click  >  Add-ons →  Find new apps and search for "Jira Command Line Interface". Upon receiving the results, click Free trial under the JIRA Command Line Interface (CLI)
   
2. Ensure the license is updated in the License section.
3. The CLI connector will be installed and you can view the app in the Manage apps page.

Executing the CLI Commands:

1. CLI commands are executed from the Windows command prompt. Open the command prompt and go to the path where the CLI client is installed. 

2. Here are the sample CLI commands:

   1. To create a project, use createProject action along with the required parameters. The below CLI command creates a project with a lead assigned:

      acli myjira --action createProject --project "DEVPROJECT" --lead "user1" --continue
      
      project 'DEVPROJECT' created with key DEVPROJECT and id 10200

   2.  To create an issue, use createIssue action along with the required/optional parameters. Below CLI command creates an issue, with issue type and summary in a specific project (CLIPROJ in the given example):

      acli myjira --action createIssue  --project "DEVPROJECT" --type "bug"  --summary "this is my new dev page"
      Issue DEVPROJECT-1 created with id 10104

   3. To add a comment to an issue, use addComment action along with the required/optional parameters. Below CLI command adds a comment to a particular issue (DEVPROJECT-1 is the issue key in the given example).

      acli myjira --action addComment --issue "DEVPROJECT-1" --comment "my new comment"
      Comment with id 10100 added to DEVPROJECT-1