aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: f70ccd35d937f6d75bf2ec8f4b9e550a1f17fb96 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# Puppet Samba Module

Module for provisioning Samba

Tested on Ubuntu 12.04, patches to support other operating systems are welcome.

## Installation

Clone this repo to your Puppet modules directory

  git clone git://github.com/ajjahn/puppet-samba.git samba

## Usage

Tweak and add the following to your site manifest:

  node 'server.example.com' {
    class {'samba::server':
      workgroup => 'example',
      server_string => "Example Samba Server",
      interfaces => "eth0 lo",
      security => 'share'
    }

    samba::server::share {'example-share':
      comment => 'Example Share',
      path => '/path/to/share',
      guest_only => true
      guest_ok => true,
      guest_account => "guest",
      browsable => false,
      create_mask => 0777,
      force_create_mask => 0777,
      directory_mask => 0777,
      force_directory_mask => 0777,
      force_group => 'group',
      force_user => 'user',
      copy => 'some-other-share',
    }
  }

Most configuration options are optional.

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request