summaryrefslogtreecommitdiff
path: root/README.HG.markdown
blob: 55ceef4acced916a6339eac03517e7bee5f8fe94 (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
63
64
65
66
67
68
69
70
71
72
73
Using vcsrepo with Mercurial
============================

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

Define a `vcsrepo` without a `source` or `revision`:

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

To clone/pull & update a repository
-----------------------------------

To get the default branch tip:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => hg,
        source   => "http://hg.example.com/myrepo"
    }

For a specific changeset, use `revision`:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => hg,
        source   => "http://hg.example.com/myrepo",
        revision => '21ea4598c962'
    }

You can also set `revision` to a tag:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => hg,
        source   => "http://hg.example.com/myrepo",
        revision => '1.1.2'
    }

Check out as a user:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => hg,
        source   => "http://hg.example.com/myrepo",
        user     => 'user'
    }

Specify an SSH identity key:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => hg,
        source   => "ssh://hg@hg.example.com/myrepo",
        identity => "/home/user/.ssh/id_dsa,
    }

For sources that use SSH (eg, `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/hg/`

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