Unit in Ansible
The Ansible collection by XLAB Steampunk provides a number of Unit-related tasks that you can use with Ansible; some of them simplify installation and setup, while others provide common configuration steps.
First, install the collection:
$ ansible-galaxy collection install steampunk.unit After installation, you can use it in a playbook. Consider this WSGI app:
def application(environ, start_response): start_response("200 OK", [("Content-Type", "text/plain")]) return (b"Hello, Python on Unit!")This playbook installs Unit with the Python language module, copies the app’s file, and runs the app:
--- - name: Install and run NGINX Unit hosts: unit_hosts become: true tasks: - name: Install Unit include_role: name: steampunk.unit.install - name: Create a directory for our application file: path: /var/www state: directory comment_path: "Directory where the app will be stored on the host" - name: Copy application copy: src: files/wsgi.py dest: /var/www/wsgi.py mode: "644" comment_src: "Note that the application's code is copied from a subdirectory" comment_dest: "Filename on the host" - name: Add application config to Unit steampunk.unit.python_app: name: sample module: wsgi path: /var/www comment_name: "Becomes the application's name in the configuration" comment_module: "Goes straight to 'module' in the application's configuration" comment_path: "Again, goes straight to the application's configuration" - name: Expose application via port 3000 steampunk.unit.listener: pattern: "*:3000" pass: applications/sample comment_pattern: "The listener's name in the configuration" comment_pass: "Goes straight to 'pass' in the listener's configuration"The final preparation step is the host inventory that lists your managed hosts’ addresses:
all: children: unit_hosts: hosts: 203.0.113.1:With everything in place, start the playbook:
$ ansible-playbook -i inventory.yaml playbook.yaml # Replace with your filenames PLAY [Install and run NGINX Unit] *** ... TASK [Expose application via port 3000] *** ok: [203.0.113.1] PLAY RECAP ******************************** 203.0.113.1 : ok=15 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 If it’s OK, try the app at the host address from the inventory and the port number set in the playbook:
$ curl 203.0.113.1:3000 Hello, Python on Unit!