Robert Kaussow
4371cbb903
Author: Robert Kaussow <mail@geeklabor.de> Date: Sun Jan 26 16:21:00 2020 +0100 update var description
57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
---
|
|
title: smb
|
|
type: docs
|
|
---
|
|
|
|
[![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.smb) [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.smb?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.smb) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](LICENSE)
|
|
|
|
Mount a list of Samba shares.
|
|
|
|
* [Default Variables](#default-variables)
|
|
* [smb_packages](#smb-packages)
|
|
* [smb_shares](#smb-shares)
|
|
* [Dependencies](#dependencies)
|
|
|
|
---
|
|
|
|
## Default Variables
|
|
|
|
### smb_packages
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
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/` 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](https://docs.ansible.com/ansible/latest/modules/mount_module.html) module.
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
smb_shares: []
|
|
```
|
|
|
|
#### Example usage
|
|
|
|
```YAML
|
|
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.
|