{"id":20,"date":"2019-01-07T07:56:00","date_gmt":"2019-01-07T07:56:00","guid":{"rendered":""},"modified":"2019-04-25T13:42:20","modified_gmt":"2019-04-25T13:42:20","slug":"ansible-passing-arrays-to-bash-scripts","status":"publish","type":"post","link":"https:\/\/ntlx.org\/de\/2019\/01\/ansible-passing-arrays-to-bash-scripts.html","title":{"rendered":"Ansible: Passing arrays to BASH scripts"},"content":{"rendered":"

When using Ansible<\/a>, it may become handy sooner or later to invoke a BASH script in one of you playbooks. Invoking a BASH script in Ansible can be done using a simple shell task<\/a>:<\/p>\n

\n\n\n\n
\n
1\n2\n3\n4\n5\n6<\/pre>\n<\/td>\n
\n
---<\/span>\n- hosts: 127.0.0.1\n  connection: local\n  tasks:\n      - name: ensure stuff is done\n        shell: .\/do_stuff.sh<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
This task will execute the bash script do_stuff.sh<\/i>. Sometimes, it is also necessary to configure the behaviour of the BASH script you are executing. The simplest way to do so is passing environment variables to the bash script as done in the following example.<\/p>\n
\n\n\n\n
\n
1\n2\n3\n4\n5\n6\n7\n8<\/pre>\n<\/td>\n
\n
---<\/span>\n- hosts: 127.0.0.1\n  connection: local\n  tasks:\n      - name: ensure custom stuff is done\n        shell: .\/do_stuff.sh\n        environment:\n            STUFF: some_stuff<\/span>\n<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
In the BASH script we can now work with the environment variable as usual:<\/p>\n
\n\n\n\n
\n
1\n2\n3<\/pre>\n<\/td>\n
\n
#!\/bin\/bash<\/span>\n\necho<\/span> $STUFF<\/span> > \/tmp\/stuff.txt\n<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
If we now want to pass multiple values in environment variable as array to the BASH script, we have two different options. Either we pass the array as string, or we parse the array output of Ansible in the bash script.<\/p>\n
Option 1: Pass array as string<\/h3>\n
The first option is to pass the multiple values as string instead of a YAML array. In the following example, we separate them by spaces, which results in a single environment variable ARRAY <\/i>being set when executing the BASH script.<\/p>\n
\n\n\n\n
\n
1\n2\n3\n4\n5\n6\n7\n8<\/pre>\n<\/td>\n
\n
---<\/span>\n- hosts: 127.0.0.1\n  connection: local\n  tasks:\n      - name: pass array as string\n        shell: .\/do_stuff_string.sh\n        environment:\n            ARRAY: one two three<\/span>\n<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
To handle those values as array in our BASH script, we simply surround the value of the environment variable with parentheses. Afterwards the ARRAY variable is a BASH array containing the values one<\/i>, two<\/i>, and three.<\/i><\/p>\n
\n\n\n\n
\n
1\n2\n3\n4\n5\n6\n7<\/pre>\n<\/td>\n
\n
#!\/bin\/bash<\/span>\n\nARRAY<\/span>=($ARRAY<\/span>)\n:> \/tmp\/stuff_string.txt\nfor <\/span>a in \"${ARRAY[@]}\"<\/span>; do<\/span>\n    <\/span>echo<\/span> $a<\/span> >> \/tmp\/stuff_string.txt\ndone<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Option 2: Parse array<\/h3>\n
The second option is much more readable in the Ansible playbook. We define the values as array in YAML:<\/div>\n
\n\n\n\n
\n
 1\n 2\n 3\n 4\n 5\n 6\n 7\n 8\n 9\n10\n11<\/pre>\n<\/td>\n
\n
---<\/span>\n- hosts: 127.0.0.1\n  connection: local\n  tasks:\n      - name: pass array as array\n        shell: .\/do_stuff_array.sh\n        environment:\n            ARRAY:\n            - one\n            - two\n            - three<\/span>\n<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Unfortunately, this environment variable is still set as string, now containing a python string representation of the array:<\/p>\n
\n\n\n\n
\n
1<\/pre>\n<\/td>\n
\n
[u'one'<\/span>, u'two'<\/span>, u'three'<\/span>]\n<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
To parse the array in the BASH script, the simplest way is to use python again, which is able to handle this value out of the box.<\/p>\n
\n\n\n\n
\n
1\n2\n3\n4\n5\n6\n7<\/pre>\n<\/td>\n
\n
#!\/bin\/bash<\/span>\n\nARRAY<\/span>=($(<\/span>python <<< \"print(' '.join($ARRAY))\"<\/span>)<\/span>)\n:> \/tmp\/stuff_array.txt\nfor <\/span>a in \"${ARRAY[@]}\"<\/span>; do<\/span>\n    <\/span>echo<\/span> $a<\/span> >> \/tmp\/stuff_array.txt\ndone<\/span>\n<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
With the python one-liner in line 3, ARRAY again is a BASH array with the values one<\/i>, two<\/i>, and three<\/i> and can be processed further.<\/i><\/p>\n
Please note that, to be able to get array elements with spaces passed by ansible, we need to change the array seperator as the following version of the script shows. Otherwise, bash would recognize every single word as separate element of the array:<\/p>\n
<\/p>\n
\n\n\n\n
\n
1\n2\n3\n4\n5\n6\n7<\/pre>\n<\/td>\n
\n
#!\/bin\/bash<\/span>\nIFS<\/span>=<\/span>\n<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
We have seen 2 different options to pass an array from Ansible to a BASH script. Option 1, passing it as a simple string variable has some implications, for example an array containing values with spaces might result in a less readable YAML line. Option 2, defining the array as YAML array and parsing it in your BASH script with python makes the definition better readable and more solid, but adds a dependency to python for your BASH script.<\/p>\n
If simple one-word arguments need to be set for your script, option 1 might still be a good option as it is easier to handle in the BASH script and doesn’t include a dependency to python.
\nNevertheless, for more complex playbooks or values in the array, I recommend option 2 as the cleaner solution.<\/p>\n
n’
\nARRAY<\/span>=(<\/span> $(<\/span>python <<<<\/span> “print(‘n’.join($ARRAY))”<\/span>)<\/span> )<\/span>
\necho<\/span> “${ARRAY[@]}”<\/span>
\nfor <\/span>a in “${ARRAY[@]}”<\/span>; do<\/span>
\n    <\/span>echo<\/span> “$a”<\/span>
\ndone<\/span>
\nWe have seen 2 different options to pass an array from Ansible to a BASH script. Option 1, passing it as a simple string variable has some implications, for example an array containing values with spaces might result in a less readable YAML line. Option 2, defining the array as YAML array and parsing it in your BASH script with python makes the definition better readable and more solid, but adds a dependency to python for your BASH script.<\/p>\n
If simple one-word arguments need to be set for your script, option 1 might still be a good option as it is easier to handle in the BASH script and doesn’t include a dependency to python.
\nNevertheless, for more complex playbooks or values in the array, I recommend option 2 as the cleaner solution.<\/p>\n","protected":false},"excerpt":{"rendered":"When using Ansible, it may become handy sooner or later to invoke a BASH script in one of you playbooks. Invoking a BASH script in Ansible can be done using a simple shell task: 1 2 3 4 5 6 — – hosts: 127.0.0.1 connection: local tasks: – name: ensure stuff is done shell: .\/do_stuff.sh This… Artikel ansehen<\/a>","protected":false},"author":1,"featured_media":141,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"_links":{"self":[{"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/posts\/20"}],"collection":[{"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/comments?post=20"}],"version-history":[{"count":3,"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/posts\/20\/revisions"}],"predecessor-version":[{"id":139,"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/posts\/20\/revisions\/139"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/media\/141"}],"wp:attachment":[{"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/media?parent=20"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/categories?post=20"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ntlx.org\/de\/wp-json\/wp\/v2\/tags?post=20"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}