cohorte/cifs_client repository overview

⁠Description

repository that allow to build docker image a cifs client. This image allow to mount a cifs volume inside a container and provide the data in a volume data.

⁠Usage

To use this client, you need to pull the image docker pull cohorte/cifs_client:latest

create the container with specify volume data to access to synchronized cifs file in the host and all environment properties that allow to mount the volume

docker run -d \
--name=cifs_client \
--cap-add SYS_ADMIN \
--cap-add DAC_READ_SEARCH \
--privileged \
--log-opt mode=non-blocking \
--log-opt max-buffer-size=4m \
--log-opt max-size=10m \
--log-opt max-file=40 \
-e USER=user \
-e PASS=pass \
-e SERVER=domain.name \
-e SHARE_PATH=smb_share \
-e VOLUME_TARGET=volume_inside_container \
-v /var/volumes/subdomain/cifs_client/mount:volume_inside_container \
cifs_client:1.0.0

1. Here the description of environment properties:
   • USER : user used for connect to cifs volume
   • PASS : password used for connect to cifs volume
   • SERVER : ip or domain of the host that provide the cifs volume
   • VOLUME_TARGET : path of the directory in the container use to synchronized files with cifs volumes files
   • SHARE_PATH : path of cifs volume shared
   • SMB_VERSION : smb version default value "2.0". see https://en.wikipedia.org/wiki/Server_Message_Block⁠
   • DOMAIN : samba domain network default value "WORKGROUP"
   • PORT : default value "445"

⁠Way to Work :

In docker we can't share a volume data that bind directly the cifs mount volume. To allow to see and manipulate file in volume data, a synchronization mechanism using inotify-tools is implement in order to synchronized deletion, copy, create and modify files and directories.