From cdf7c0975aee23cfe42696fc5f34e42e03673ee8 Mon Sep 17 00:00:00 2001 From: Don Domingo Date: Mon, 30 Sep 2019 00:45:26 +0000 Subject: [PATCH] Added reference on how to set Ansible overrides in AWS Quick Starts --- README.md | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index bfdf3dd..864b060 100644 --- a/README.md +++ b/README.md @@ -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