ansible-stunnel's Introduction

stunnel

Role which helps to install and configure Stunnel.

The configuration of the role is done in such way that it should not be necessary to change the role for any kind of configuration. All can be done either by changing role parameters or by declaring completely new configuration as a variable. That makes this role absolutely universal. See the examples below for more details.

Please report any issues or send PR.

Example

---

- name: Example of how to configure Stunnel
  hosts: host1
  vars:
    # This is the configuration
    stunnel_config:
      smtps:
        accept: 5000
        client: "yes"
        connect: outbound.att.net:465
  roles:
    - stunnel

Role variables

List of variables used by the role:

# Package to be installed (explicit version can be specified here)
stunnel_pkg: stunnel

# Name of the Stunnel service
stunnel_service: stunnel

# Whether to install the service file
stunnel_service_install: yes

# Path of the init.d script
stunnel_service_upstart: /etc/init.d/{{ stunnel_service }}

# Path of the systemd script
stunnel_service_systemd: /usr/lib/systemd/system/{{ stunnel_service }}.service

# Data structure which helps to choose the right service script
stunnel_service_script:
  systemd:
    src: stunnel.systemd
    dest: "{{ stunnel_service_systemd }}"
  upstart:
    src: stunnel.upstart
    dest: "{{ stunnel_service_upstart }}"
    mode: "0755"

# Location of the Stunnel config file
stunnel_config_file: /etc/stunnel/stunnel.conf

# Stunnel configuration
stunnel_config: {}

Dependencies

config_encoder_filters

License

MIT

Author

Jiri Tyr

ansible-stunnel's People

Stargazers

Watchers

ansible-stunnel's Issues

Typo in metadata leads to dependency not being installed

https://github.com/jtyr/ansible-stunnel/blob/master/meta/main.yml#L16 should read 'jtyr.config_encoder_filters'. Without the author-name prefix, ansible-galaxy fails to pull down and install that role. According to the docs at https://galaxy.ansible.com/intro#meta it should actually be:

dependencies:
  - { role: jtyr.config_encoder_filters }

But ansible-galaxy seems happy enough with the current format.

Error while running playbook

Following error is thrown when running playbook

FAILED! => {"failed": true, "msg": "The task includes an option with an undefined variable. The error was: 'dict object' has no attribute u'service'\n\nThe error appears to have been in '/jtyr.stunnel/tasks/main.yaml': line 30, column 3, but may\nbe elsewhere in the file depending on the exact syntax problem.\n\nThe offending line appears to be:\n\n  with_dict: \"{{ stunnel_service_script }}\"\n- name: Install Stunnel service script\n  ^ here\n\nexception type: <class 'ansible.errors.AnsibleUndefinedVariable'>\nexception: 'dict object' has no attribute u'service'"}

Fix is to replace the code with following code

- name: Install Stunnel service script
  copy:
    src: "{{ item.value.src}}"
    dest: "{{ item.value.dest}}"
    mode: "{{ item.value.mode | default('0644') }}"
  when: >
    stunnel_service_install
  with_dict: "{{ stunnel_service_script }}"
  tags:
    - stunnel_service

Recommend Projects