...
- Navigate to the CLI installation directory.
- Rename the example properties file (acli-cloud or acli-server) to acli.properties as per your environment.
To work with multiple Cloud sites and/or Server sites, you must update the acli.properties file where different environments like Prod,Stage, or, QA are targeted, as follows:
Code Block language bash title Example: acli.properties linenumbers true # Example Cloud configuration - customize and rename this file to acli.properties # Cloud requires an email address and a corresponding API token from Atlassian. # Use an existing token or create one at https://id.atlassian.com/manage/api-tokens (requires an Atlassian account login). cloudcredentials = --user automation@example.com --token xxxxxxxxxxxxxxxxxxxxxxxx myjira = jiracloud -s https://issues.example.com ${cloudcredentials} myconfluence = confluencecloud -s https://mydocs.example.com ${cloudcredentials} # Example Server configuration: prodservercredentials = --user admin --password admin jiraserver = jira -s https://prodjira.examplegear.com ${prodservercredentials} confluenceserver = confluence -s https://prodconfluence.examplegear.com ${prodservercredentials} qacredentials = --user qauser --password qapass qajira = jira -s https://qajira.example.com ${qacredentials} qaconfluence = confluence -s https://qaconfluence.example.com ${qacredentials} # This defines the default client for actions, choose the most likely used client default = ${myjira}
Info - Each instance can be given a unique name that points to the respective Atlassian instance. Use this name to execute the CLI commands against the respective instance.
- In the above properties file, myjira is a name pointing to your Jira Cloud instance and myconfluence is the name pointing to your Confluence Cloud instance. Similarly, the other names are pointing to their respective instances.
- A credential specifies the username and password/token for the respective instance. Please provide your user ID in user parameter and API token data in token parameter as shown:
credentials = --user automation@example.com --token xxxxxxxxxxxxxxxxxxxxxxxx
Save the file and run the following commands as per your requirement:
Code Block language bash acli qajira --action getServerInfo acli myconfluence --action addPage --space "demo" --title "This is title" --parent "@home" acli myjira --action cloneIssue --issue "JIRACLI-4" --summary "clone summary" --comment "comment for cloned issue"
...