summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruce Williams <bruce@codefluency.com>2010-03-14 03:00:37 -0700
committerBruce Williams <bruce@codefluency.com>2010-03-14 03:00:37 -0700
commit6904cd9a7103d5cf53cddaa8f8476ffc68073bfa (patch)
treea03c4c88e9518f15e65bd07253d1d82ee9ac45a4
parent67aa190396e686658aa72b7c3d91c6bed2d010af (diff)
downloadpuppet-vcsrepo-6904cd9a7103d5cf53cddaa8f8476ffc68073bfa.tar.gz
puppet-vcsrepo-6904cd9a7103d5cf53cddaa8f8476ffc68073bfa.tar.bz2
Add pointer for Puppet SSH approach
-rw-r--r--README.BZR.markdown9
-rw-r--r--README.CVS.markdown14
-rw-r--r--README.GIT.markdown14
-rw-r--r--README.HG.markdown14
-rw-r--r--README.SVN.markdown45
5 files changed, 96 insertions, 0 deletions
diff --git a/README.BZR.markdown b/README.BZR.markdown
index a7494db..6672e79 100644
--- a/README.BZR.markdown
+++ b/README.BZR.markdown
@@ -32,7 +32,16 @@ For a specific revision, use `revision` with a valid revisionspec
revision => 'menesis@pov.lt-20100309191856-4wmfqzc803fj300x'
}
+For sources that use SSH (eg, `bzr+ssh://...`, `sftp://...`)
+------------------------------------------------------------
+
+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/bzr/`
+
+[1]: http://docs.reductivelabs.com/references/stable/metaparameter.html#require
diff --git a/README.CVS.markdown b/README.CVS.markdown
index 7f9647e..321c865 100644
--- a/README.CVS.markdown
+++ b/README.CVS.markdown
@@ -40,3 +40,17 @@ For a specific tag, use `revision`:
source => ":pserver:anonymous@example.com:/sources/myproj",
revision => "SOMETAG"
}
+
+For sources that use 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/cvs/`
+
+[1]: http://docs.reductivelabs.com/references/stable/metaparameter.html#require
diff --git a/README.GIT.markdown b/README.GIT.markdown
index 4e3c095..04ac05b 100644
--- a/README.GIT.markdown
+++ b/README.GIT.markdown
@@ -47,3 +47,17 @@ For a specific revision (can be a commit SHA or tag):
revision => '1.1.2rc1'
}
+For sources that use SSH (eg, `username@server:...`)
+----------------------------------------------------
+
+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/git/`
+
+[1]: http://docs.reductivelabs.com/references/stable/metaparameter.html#require
+
diff --git a/README.HG.markdown b/README.HG.markdown
index e96db89..670d062 100644
--- a/README.HG.markdown
+++ b/README.HG.markdown
@@ -39,3 +39,17 @@ You can also set `revision` to a tag:
source => "http://hg.example.com/myrepo"
revision => '1.1.2'
}
+
+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.reductivelabs.com/references/stable/metaparameter.html#require
diff --git a/README.SVN.markdown b/README.SVN.markdown
index 30aaf54..3dc852f 100644
--- a/README.SVN.markdown
+++ b/README.SVN.markdown
@@ -1,2 +1,47 @@
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'
+ }
+
+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.reductivelabs.com/references/stable/metaparameter.html#require