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

This commit is contained in:
Don Domingo
2019-09-30 00:45:26 +00:00
parent 9324bdc11c
commit cdf7c0975a

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 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 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, override the default and calculated settings with special values. To do this, provide
provide command-line overrides to command-line overrides to
[ansible-playbook](https://docs.ansible.com/ansible/latest/cli/ansible-playbook.html). [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 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 for testing (for example, a pre-release version of Jira). If you are running `ansible-playbook`
ansible-playbook directly, the command for this would look like the following: directly, the command for this would look like the following:
ansible-playbook \ ansible-playbook \
-e atl_product_download_url=http://s3.amazon.com/atlassian/jira-9.0.0-PRE-TEST.tar.gz \ -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 -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 You can also do this on a CloudFormation template where the stack details are in `/etc/atl`.
/etc/atl. On such templates, the variable `ATL_ANSIBLE_EXTRA_PARAMS` is added On such templates, the variable `ATL_ANSIBLE_EXTRA_PARAMS` is added to the
to the `ansible-playbook` parameters in `bin/ansible-with-alt-env`. In this case `ansible-playbook` parameters in `bin/ansible-with-alt-env`. In this case you
you need to set it to: 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" 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
### Development philosophy ### Development philosophy