Merged in DCD-653-docs-added-quickstart-reference (pull request #30)

Added reference on how to set Ansible overrides in AWS Quick Starts

Approved-by: Steve Smith <ssmith@atlassian.com>
Approved-by: Don Domingo <ddomingo@atlassian.com>
This commit is contained in:
Don Domingo
2019-09-30 04:45:50 +00:00
committed by Steve Smith

View File

@@ -31,13 +31,13 @@ helper-script `bin/ansible-with-atl-env` and the corresponding
If you want to customise the playbook behaviour the simplest method is to fork
this repository and add your own. However, for some one-off tasks you can also
override the default and calculated settings with special values. To do this,
provide command-line overrides to
override the default and calculated settings with special values. To do this, provide
command-line overrides to
[ansible-playbook](https://docs.ansible.com/ansible/latest/cli/ansible-playbook.html).
The most likely use-case for this is to download a custom product distribution
for testing (for example, a pre-release version of Jira). If you are running
ansible-playbook directly, the command for this would look like the following:
for testing (for example, a pre-release version of Jira). If you are running `ansible-playbook`
directly, the command for this would look like the following:
ansible-playbook \
-e atl_product_download_url=http://s3.amazon.com/atlassian/jira-9.0.0-PRE-TEST.tar.gz \
@@ -46,13 +46,22 @@ ansible-playbook directly, the command for this would look like the following:
\
-i inv/aws_node_local aws_jira_dc_node.yml
You can also do this on a CloudFormation template where the stack details are in
/etc/atl. On such templates, the variable `ATL_ANSIBLE_EXTRA_PARAMS` is added
to the `ansible-playbook` parameters in `bin/ansible-with-alt-env`. In this case
you need to set it to:
You can also do this on a CloudFormation template where the stack details are in `/etc/atl`.
On such templates, the variable `ATL_ANSIBLE_EXTRA_PARAMS` is added to the
`ansible-playbook` parameters in `bin/ansible-with-alt-env`. In this case you
need to set it to:
ATL_ANSIBLE_EXTRA_PARAMS="-e atl_product_download_url=http://s3.amazon.com/atlassian/jira-9.0.0-PRE-TEST.tar.gz -e atl_use_system_jdk=true -e atl_download_format=tarball"
To set the same parameters in the AWS Quick Starts for
[Jira Data Center](https://aws.amazon.com/quickstart/architecture/jira/),
[Confluence Data Center](https://aws.amazon.com/quickstart/architecture/confluence/), and
[Bitbucket Data Center](https://aws.amazon.com/quickstart/architecture/bitbucket/), enter
them in the `Custom command-line parameters for Ansible` field:
-e atl_product_download_url=http://s3.amazon.com/atlassian/jira-9.0.0-PRE-TEST.tar.gz -e atl_use_system_jdk=true -e atl_download_format=tarball
## Development
### Development philosophy