Difference between revisions of "Puppet setup"

From Software Heritage Wiki
Jump to navigation Jump to search
m (1 revision: import public pages from the intranet wiki)
(Install redirection to the puppet page in main docs site)
Tag: New redirect
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
−
== Multiple repository setup ==
+
#REDIRECT [[swhdocs:sysadm/puppet/reference-setup.html]]
−
 
 
−
Our puppet environment is split into multiple repos (one repo per module), plus one "root" repository for multi-repository management.
 
−
 
 
−
First, clone the base repository, containing the configuration file for myrepos and a README file.
 
−
 
 
−
<pre>
 
−
$ git clone ssh://git@forge.softwareheritage.org/diffusion/SENV/puppet-environment.git
 
−
</pre>
 
−
 
 
−
Then, use that configuration to clone all the repositories :
 
−
 
 
−
<pre>
 
−
$ cd puppet-environment
 
−
$ readlink -f .mrconfig >> ~/.mrtrust
 
−
$ mr up
 
−
</pre>
 
−
 
 
−
(the mr command is in the myrepos Debian package).
 
−
 
 
−
All the swh-specific repositories are in ''swh-''-prefixed repositories. The other repositories come from other sources and have an ''upstream'' remote allowing updates (the ''origin'' remote is always on the swh git server).
 
−
 
 
−
Our puppet workflow is documented in the README.md file in the puppet-environment repository.
 
−
 
 
−
== Deploy work-flow ==
 
−
 
 
−
=== Semi-automated ===
 
−
 
 
−
# you@localhost$ # ''hack on puppet Git repo''
 
−
# you@localhost$ <tt>rake validate</tt>
 
−
# you@localhost$ <tt>git commit</tt>
 
−
# you@localhost$ <tt>git push</tt>
 
−
# you@localhost$ <tt>cd [https://forge.softwareheritage.org/diffusion/SENV/ puppet-environment]</tt>
 
−
# you@localhost$ <tt>bin/deploy-on machine1 machine2...</tt>
 
−
 
 
−
Remember to pass <tt>--apt</tt> to <tt>bin/deploy-on</tt> if freshly uploaded Software Heritage packages are to be deployed.
 
−
Also, <tt>bin/deploy-on --help</tt> is your friend.
 
−
 
 
−
=== Manual ===
 
−
 
 
−
# you@localhost$ # ''hack on puppet Git repo''
 
−
# you@localhost$ <tt>rake validate</tt>
 
−
# you@localhost$ <tt>git commit</tt>
 
−
# you@localhost$ <tt>git push</tt>
 
−
# you@pergamon$ <tt>sudo swh-puppet-master-deploy</tt>
 
−
# you@machine$ <tt>sudo apt-get update</tt>  # ''if a new or updated version of a [[Debian packaging|Debian package]] needs deploying''
 
−
# you@machine$ <tt>sudo swh-puppet-test</tt>  # ''to test/review changes''
 
−
# you@machine$ <tt>sudo swh-puppet-apply</tt>  # ''to apply
 
−
 
 
−
 
 
−
[[Category:System administration]]
 

Latest revision as of 10:41, 27 October 2021

Redirect to:

Retrieved from "https://wiki.softwareheritage.org/index.php?title=Puppet_setup&oldid=1624"