summaryrefslogtreecommitdiff
path: root/README.SVN.markdown
blob: f374094c1dcc494143f9b385a85ca28b9630beed (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
51
52
53
54
55
56
57
58
59
60
61
62
Using vcsrepo with Subversion
=============================

To create a blank repository
----------------------------

To create a blank repository suitable for use as a central repository,
define a `vcsrepo` without a `source` or `revision`:

    vcsrepo { "/path/to/repo":
      ensure   => present,
      provider => svn
    }

To checkout from a repository
-----------------------------

Provide a `source` qualified to the branch/tag you want:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => svn,
        source   => "svn://svnrepo/hello/branches/foo"
    }

You can provide a specific `revision`:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => svn,
        source   => "svn://svnrepo/hello/branches/foo",
        revision => '1234'
    }


Using a specified Subversion configuration directory 
-----------------------------

Provide a `configuration` parameter which should be a directory path on the local system where your svn configuration
files are.  Typically, it is /path/to/.subversion:

    vcsrepo { "/path/to/repo":
        ensure        => present,
        provider      => svn,
        source        => "svn://svnrepo/hello/branches/foo",
        configuration => "/path/to/.subversion"
    }


For sources that use SSH (eg, `svn+ssh://...`)
----------------------------------------------

Manage your SSH keys with Puppet and use `require` in your `vcsrepo`
to ensure they are present.  For more information, see the `require`
metaparameter documentation[1].

More Examples
-------------

For examples you can run, see `examples/svn/`

[1]: http://docs.puppetlabs.com/references/stable/metaparameter.html#require