Overview
Excerpt |
---|
This article provides answers to most frequently asked questions on the CLI app. |
FAQ
Expand | ||
---|---|---|
| ||
Jira/Confluence/Bamboo/Bitbucket/Atlassian Command Line Interface (CLI) has 2 components
CLI client can be downloaded from Downloads - CLI Clients to the local machine where actions can be run from. Please see the page What is the difference between CLI clients and Run CLI add-ons? |
Expand | ||
---|---|---|
| ||
The CLI client uses request/response protocol built on REST API calls provided by Atlassian to perform remote actions against your Confluence and Jira instance. |
Expand | ||
---|---|---|
| ||
Nothing specific to the app. The user's standard Atlassian application permissions determine what the user can or cannot do, just like any other instance access via REST APIs or the user interface. |
Expand | ||
---|---|---|
| ||
The authentication is different between cloud and server versions of Confluence. For server, authentication is based on the username and password provided when running the command from the CLI client or distribution. For cloud, an API token is required. For additional information on authentication, see this document. |
Expand | ||
---|---|---|
| ||
The risks in using this app are no different than performing the same operations via the Atlassian app's user interface. The CLI has only the capabilities that the Atlassian provided API offers. That said, as with any automation tool, we encourage our customers to carefully test their automation in test environments whenever possible. We also suggest using the simulate option to understand in detail what a given command does before using it live. |
Expand | ||
---|---|---|
| ||
No. The CLI can only perform operations that the user operating the CLI can do via the Atlassian app's user interface. So, while it cannot be misused, it is very powerful and so should be used with care and testing as discussed above. |
Expand | ||
---|---|---|
| ||
The recourse or rollback options are identical to those in the UI. Some options to consider are making backups on data about to be changed or making a plan to revert changes if needed via the CLI. For example, if using the CLI to create new users in bulk, one should have a CLI command ready to remove or disable those users if the results are unexpected. |
Expand | ||
---|---|---|
| ||
Our customers use the CLI to automate tedious and repetitive tasks so that they can spend their time on more valuable work. Many hours are saved daily by our customers. Some operations in the Atlassian user interface that require many clicks and many screens can be performed in single commands. |
Expand | ||
---|---|---|
| ||
The CLI is a very powerful tool with over 200 actions available for Confluence. This can sometimes be a challenging learning curve until one understands the consistent patterns to the commands. Once that is understood, then creating commands becomes steadily easier. |
Expand | ||
---|---|---|
| ||
Check our below How To section of the Atlassian application CLI documentation for numerous examples of complex and high-volume operations that you may use as test cases. How To articles for Confluence Command Line Interface How To articles for Jira Command Line Interface |