Loading...

Watch: Mount a Windows share in Linux SMB/CIFS - Ansible module mount

How to Mount a Windows share in Linux SMB/CIFS. The Ansible Playbook code is going to check the required packages, create the mount-point and setup the Windows network shared folder via SMB/CIFS protocol on the Linux target machine. Demo and live coding included.

How to mount a Windows share in Linux SMB/CIFS with Ansible?

I'm going to show you a live Playbook with some simple Ansible code.

I'm Luca Berton and welcome to today's episode of Ansible Pilot

Ansible mount an SMB/CIFS filesystem

  • ansible.posix.mount
  • Control active and configured mount points

Today we're talking about the Ansible module mount.

The full name is ansible.posix.mount, which means that is part of the collection of modules "ansible.posix" to interact with POSIX platforms.

The purpose of the module is to Control active and configured mount points.

For Windows, use the community.windows.win_mapped_drive module instead.

Parameters

  • path string - mount point (e.g. /mnt)
  • state string - mounted / unmounted / present / absent / remounted
  • src string - device or network volume
  • fstype string - ext4, xfs, iso9660, nfs, cifs, etc.
  • opts string - mount options

This module has many parameters to perform any task.

The only required are "path" and "state".

The parameter "path" specifies the path to the mount point (e.g. /mnt/).

The parameter "state" allows us to verify a specific state of the mount point. The options "mounted", "unmounted" and "remounted" change the device status. The "present" and "absent" options only change the /etc/fstab file.

The src parameter specifies the device or network volume for NFS or SMB/CIFS.

The fstype parameter specifies the filesystem type. For example: ext4, xfs, iso9660, nfs, cifs, etc.

The opts parameter allows us to specify some mount options, that vary for each filesystem type.

## Playbook

Let's jump in a real-life Ansible Playbook to mount an SMB/CIFS filesystem.

code

  • mount_cifs.yml

``yaml

---

  • name: mount module Playbook

hosts: all

become: true

vars:

uri: "//windows-pc/share"

username: "example@domain"

password: "password"

mountpoint: "/share"

tasks:

- name: utility present

ansible.builtin.package:

name: cifs-utils

state: present

  • name: check mountpoint exist

ansible.builtin.file:

path: "{{ mountpoint }}"

state: directory

mode: '0755'

owner: root

group: root

  • name: Mount network share

ansible.posix.mount:

src: "{{ uri }}"

path: "{{ mountpoint }}"

fstype: cifs

opts: 'username={{ username }},password={{ password }}'

state: mounted

`

execution

``bash

$ ansible-playbook -i Playbook/inventory mount\ drive/cifs.yml

PLAY [mou

Read the full tutorial: Mount a Windows share in Linux SMB/CIFS - Ansible module mount