ansible-role-samba

This is an Ansible role that installs the dependencies necessary for Samba.

Requirements

None.

Role Variables

Variable	Description	Default	Required
samba_create_guest_user	Whether or not to create a Samba guest user. Only applies if server is true.	false	No
samba_guest_user	The name of the Samba guest user.	smbguest	No
samba_guest_user_groups	A list of additional groups to which the Samba guest user should belong.	Omitted	No
samba_guest_user_uid	The UID to use for the Samba guest user.	Omitted	No
samba_server	Whether or not to install Samba server dependencies.	false	No

Dependencies

None.

Installation

This role can be installed via the command:

ansible-galaxy install --role-file path/to/requirements.yml

where requirements.yml looks like:

---
- name: samba
  src: https://github.com/cisagov/ansible-role-samba

and may contain other roles as well.

For more information about installing Ansible roles via a YAML file, please see the ansible-galaxy documentation.

Example Playbook

Here's how to use it in a playbook:

- hosts: all
  become: true
  become_method: sudo
  tasks:
    - name: Install dependencies necessary for Samba
      ansible.builtin.include_role:
        name: samba

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

License

This project is in the worldwide public domain.

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

Author Information

Shane Frasier - jeremy.frasier@gwe.cisa.dhs.gov