|
|
Line 18: |
Line 18: |
|
| |
|
| ==Variables == | | ==Variables == |
| These are the currently-defined configuration variables:
| | The available configuration variables are all listed in <tt>modules/config/manifests/base.pp</tt>; refer to that file for the most up-to-date information. |
| | |
| ;'''puppet_notif_email'''
| |
| :The e-mail address or list to send errors of the puppet daemon to. ''(Defaults to <tt>dustin@mozilla.com</tt>)''
| |
| ;'''puppet_server'''
| |
| :The hostname of the puppet master we should connect to. Qualified or unqualified hostnames are acceptable. ''(Defaults to <tt>puppet</tt>)''
| |
| ;'''puppet_servers'''
| |
| :A list of all puppet servers, so clients can try other servers if <tt>puppet_server</tt> is down ''(Defaults to a one-element list containing the value of <tt>puppet_server</tt>)''
| |
| ;'''data_server'''
| |
| :The hostname of the [[ReleaseEngineering/PuppetAgain/Data|data]] server ''(Defaults to the <tt>repos</tt>)''
| |
| ;'''data_servers'''
| |
| :A list of all [[ReleaseEngineering/PuppetAgain/Data|data]] servers ''(Defaults to a one-element list containing <tt>data_server</tt>)''
| |
| ;'''builder_username'''
| |
| :The username for the build and test slaves ''(Defaults to <tt>cltbld</tt>)''
| |
| ;'''signer_username'''
| |
| :The username for the signing servers ''(Defaults to <tt>cltsign</tt>)''
| |
| ;'''nrpe_allowed_hosts'''
| |
| :A comma-separated list of IPs from which NRPE should accept check requests (added in {{bug|733545}})
| |
| ;'''relay_domains'''
| |
| :The fqdn where your smarthost will send mail (added in {{bug|733536}})
| |
| ;'''puppet_again_repo'''
| |
| :The repository from which the PuppetAgain source should be fetched by puppet masters
| |
| ;'''global_authorized_keys'''
| |
| :Names for SSH keys (see [[ReleaseEngineering/PuppetAgain/Modules/ssh|the ssh module]]) that will be accepted for root and (where applicable) builder on all hosts. All names listed here must have corresponding keys in ''modules/ssh/manifests/keys.pp''.
| |
| ;'''puppet_server_reports'''
| |
| :The 'reports' parameter that should be configured on puppet masters
| |
| ;'''puppet_server_reporturl'''
| |
| :The 'reporturl' parameter that should be configured on puppet masters
| |
| ;buildbot_configs_hg_repo
| |
| : mercurial repository for buildbot-configs it should point to: http://hg.mozilla.org/build/buildbot-configs (used in buildmaster)
| |
| ;buildbot_configs_branch
| |
| : buildbot-configs branch to be checked out (used in buildmaster)
| |
| ; buildbot_mail_to
| |
| : email address for buildbotmaster notifications (used in buildmaster)
| |
| ;buildbot_tools_hg_repo
| |
| : mercurial repository for buildbot-configs http://hg.mozilla.org/build/tools (used in buildmaster)
| |
| ;master_json
| |
| :URL for masters.json (note confusion about plurality) (used in buildmaster)
| |
| ;distinguished_master
| |
| :This specifies the "distinguished" puppetmaster, which is the one that all of the others synchronize from. It should be one of the masters in $puppet_masters.
| |
| ;puppetmaster_upstream_rsync_source
| |
| :rsync "URL" from which puppetmasters will synchronize their /data directory. Non-moco installations probably want to use <tt>rsync://puppetagain.pub.build.mozilla.org/data/</tt> here. If this is blank, no upstream rsync is done.
| |
| ;puppetmaster_upstream_rsync_args | |
| :rsync arguments for the upstream rsync. You may want to add <tt>--delete</tt> here or some <tt>--exclude=..</tt> options.
| |
| ;vmwaretools_version
| |
| :numeric version of VMware Tools that should be installed on VMware hosts. Note that you must supply the tarball for this in the 'repos/private/vmware' data directory - see https://github.com/craigwatson/puppet-vmwaretools
| |
| ;vmwaretools_md5
| |
| :hash of the VMware Tools tarball, used to validate the download
| |
| ;'''collectd_graphite_cluster_fqdn'''
| |
| :fqdn to the carbon database of a graphite cluster to send collectd metrics
| |
| ;'''config::collectd_graphite_port (optional)'''
| |
| :port number of carbon database of the associated graphite cluster
| |
| ;'''collectd_graphite_prefix (optional)'''
| |
| :prefix to be attached when sending metrics to the carbon database. Graphite will use "." as folder separators. e.g. "test.hosts." will result in a folder hierarchy of /test/hosts/fqdn_of_host/module/metric-#/
| |
| ;'''manage_ifcfg''' <small>(<tt>Boolean</tt>)</small>
| |
| :Whether puppet should manage /etc/sysconfig/network-scripts/ifcfg-eth0, currently forcing DHCP settings. ''(Defaults to <tt>true</tt>)''
| |
| ;'''signing_tools_repo'''
| |
| :The mercurial repository from which to pull the signing tools code
| |
| ;'''signing_redis_host'''
| |
| :The redis host used as backend storage for signing
| |
| ;'''signing_mac_id'''
| |
| :the MAC ID for signing
| |
| ;'''signing_allowed_ips'''
| |
| :The list IP ranges (in CIDR notation) allowed to request that an object be signed
| |
| ;'''signing_new_token_allowed_ips'''
| |
| :The list of IPs allowed to generate new signing tokens
| |
| ;'''install_avds'''
| |
| :This variable gets set to "yes" if you want your puppet instance to install the private .img files for android emulators used for Firefox for Android testing.
| |
| ;'''selfserve_agent_root'''
| |
| :This variable defines [http://hg.mozilla.org/build/buildapi/file/default/buildapi/scripts/selfserve-agent.py selfserve-agent] home directory. This directory is used a vurtualenv directory for this module
| |
| ;'''selfserve_agent_branches_json'''
| |
| :Buildapi uses this URL to keep branch information up to date
| |
| ;'''selfserve_agent_masters_json'''
| |
| :Buildapi uses this URL to keep master information up to date
| |
| ;'''selfserve_agent_sendchange_master'''
| |
| :This short master name from <tt>selfserve_agent_masters_json</tt> used for sendchanges to schedule buildbot jobs
| |
| ;'''selfserve_agent_clobberer_url'''
| |
| :[https://wiki.mozilla.org/ReleaseEngineering/Applications/Clobberer Clobberer] URL
| |
| ;'''selfserve_agent_carrot_hostname'''
| |
| : RabbitMQ hostname used by selfserve agent
| |
| ;'''selfserve_agent_carrot_vhost'''
| |
| : RabbitMQ vhost used by selfserve agent
| |
| ;'''selfserve_agent_carrot_userid'''
| |
| : RabbitMQ username used by selfserve agent
| |
| ;'''selfserve_agent_carrot_exchange'''
| |
| : RabbitMQ exchange name used by selfserve agent
| |
| ;'''selfserve_agent_carrot_queue'''
| |
| : RabbitMQ queue name used by selfserve agent
| |
|
| |
|
| ==Functions== | | ==Functions== |
| This module also defines the <tt>secret</tt> function; see [[ReleaseEngineering/PuppetAgain/Secrets]]. | | This module also defines the <tt>secret</tt> function; see [[ReleaseEngineering/PuppetAgain/Secrets]]. |