xoxys.smb/README.md

xoxys.smb

Mount a list of Samba shares.

Table of content

• Requirements
• Default Variables
  • smb_packages
  • smb_shares
• Dependencies
• License
• Author

---

Requirements

• Minimum Ansible version: 2.10

Default Variables

smb_packages

Default value

smb_packages:
  - cifs-utils

smb_shares

Mount defined samba shares. You can specify samba credentials with the username and password parameter. Given credentials will be used in a secrets file and saved to /root/.smbcredentials/<name> instead of the direct use in /etc/fstab. If secrets are defined for a list item, the secrest file will also be passed automatically to mountopts.

The state parameter is related to the possible state values of Ansibles mount module.

Default value

smb_shares: []

Example usage

smb_shares:
  - name: multimedia
    source: //share.example.com/media
    username: myuser
    password: secure
    mountpoint: /media/data
    mountopts:
      - acl
      - uid=1000
      - gid=1000
    state: mounted

Dependencies

None.

License

MIT

Author

Robert Kaussow