summaryrefslogtreecommitdiffstats
path: root/documentation/introduction.page
diff options
context:
space:
mode:
authorluke <luke@980ebf18-57e1-0310-9a29-db15c13687c0>2006-07-16 20:56:36 +0000
committerluke <luke@980ebf18-57e1-0310-9a29-db15c13687c0>2006-07-16 20:56:36 +0000
commit08650c10ae0ef84840c739f048f5c747f5df0832 (patch)
treebe0bd16623d40b391068d79defaced3ae23bd3bb /documentation/introduction.page
parente74b8affe2aefcea3294ac4567c76e8a15624b73 (diff)
downloadpuppet-08650c10ae0ef84840c739f048f5c747f5df0832.tar.gz
puppet-08650c10ae0ef84840c739f048f5c747f5df0832.tar.xz
puppet-08650c10ae0ef84840c739f048f5c747f5df0832.zip
fixing html markup
git-svn-id: https://reductivelabs.com/svn/puppet/trunk@1399 980ebf18-57e1-0310-9a29-db15c13687c0
Diffstat (limited to 'documentation/introduction.page')
-rw-r--r--documentation/introduction.page62
1 files changed, 31 insertions, 31 deletions
diff --git a/documentation/introduction.page b/documentation/introduction.page
index 5604d5133..837bbb305 100644
--- a/documentation/introduction.page
+++ b/documentation/introduction.page
@@ -23,16 +23,16 @@ contains the configuration for all of your nodes, needs to be on the central
server, most likely at `/etc/puppet/manifests/site.pp`.
Start the `puppetmasterd` daemon, and then tell your clients to contact that
-server by specifying `-s &lt;servername&gt;` as arguments to `puppetd`,
-replacing "&lt;servername&gt;" with the name of the server. Alternatively,
-`puppetd` defaults to looking for a server named "puppet", so you can just
-create a CNAME for your server, so that it answers to "puppet".
+server by specifying `-s <servername>` as arguments to `puppetd`,
+replacing ``<servername>`` with the name of the server. Alternatively,
+`puppetd` defaults to looking for a server named ``puppet``, so you can just
+create a CNAME for your server, so that it answers to ``puppet``.
It is a good idea to run both the server and client in verbose mode, enabled
with the `-v` flag, until you are sure everything is working. As each new
client connects, you will need to run `puppetca --list` to list the
-certificates waiting to be signed, and then `puppetca --sign &lt;name&gt;`,
-replacing "&lt;name&gt;" with the name of the client whose certificate you want to
+certificates waiting to be signed, and then ``puppetca --sign <name>``,
+replacing ``<name>`` with the name of the client whose certificate you want to
sign. You can turn on autosigning by creating `/etc/puppet/autosign.conf` and
put the hosts, domains, or IP addresses or ranges that you want to sign in
there.
@@ -44,9 +44,9 @@ of actions, action instances, and instance parameters. Here is how a file
element would look in puppet:
file { "/etc/passwd":
- owner =&gt; root,
- group =&gt; root,
- mode =&gt; 644
+ owner => root,
+ group => root,
+ mode => 644
}
Each instance of a low-level element like ``file`` must have a name parameter
@@ -69,16 +69,16 @@ fundamental unit of association is a 'definition':
# this might change
define sudo(source,group) {
package { sudo:
- version =&gt; "1.6.7"
+ version => "1.6.7"
}
file { "/etc/sudoers":
- source =&gt; $source, # parameterization; copy the file from where?
- mode =&gt; 440 # the 'file' type converts this appropriately to
+ source => $source, # parameterization; copy the file from where?
+ mode => 440 # the 'file' type converts this appropriately to
# octal
}
file { "/usr/sbin/sudo":
- owner =&gt; root,
- group =&gt; $group
+ owner => root,
+ group => $group
}
}
@@ -88,8 +88,8 @@ available within the definition itself.
This definition can now be treated as a type:
sudo {
- group =&gt; root,
- source =&gt; "http://fileserver/files/sudoers?v=production"
+ group => root,
+ source => "http://fileserver/files/sudoers?v=production"
}
One significant difference between definitions and types is that types
@@ -142,7 +142,7 @@ strings don't have be quoted or otherwise marked, but variables must have the
$group = "root"
file { "/etc/sudoers":
- group =&gt; $group
+ group => $group
}
Strings and booleans (``true`` and ``false``) are the only data types; even
@@ -153,8 +153,8 @@ arrays is for implicit iteration:
$files = ["/etc/passwd","/etc/group","/etc/fstab"]
file { $files:
- owner =&gt; root,
- group =&gt; root
+ owner => root,
+ group => root
}
This implicitly iterates across the file list and performs all of the
@@ -203,9 +203,9 @@ mechanism for this is currently called a 'selector'; it is similar to the
trinary operator ``:?``:
$value = $variable ? {
- value1 =&gt; setvalue1,
- value2 =&gt; setvalue2,
- default =&gt; other
+ value1 => setvalue1,
+ value2 => setvalue2,
+ default => other
}
This sets the variable ``$value`` depending on the value of ``$variable``. If
@@ -214,18 +214,18 @@ gets set to ``other``.
The brackets can be in either part of the expression, or not at all:
- $value = $variable ? "value1" =&gt; "setvalue1"
+ $value = $variable ? "value1" => "setvalue1"
A selector that doesn't match a value is a compile error.
These structures are useful for simplistic abstraction across platforms:
file { "/etc/sudoers":
- owner =&gt; root,
- group =&gt; $operatingsystem ? {
- SunOS =&gt; root,
- Linux =&gt; root,
- FreeBSD =&gt; wheel
+ owner => root,
+ group => $operatingsystem ? {
+ SunOS => root,
+ Linux => root,
+ FreeBSD => wheel
}
}
@@ -265,8 +265,8 @@ types can also have non-state parameters which modify how that type instance
behaves:
file { "/bin":
- owner =&gt; bin,
- recurse =&gt; true
+ owner => bin,
+ recurse => true
}
The ``recurse`` parameter to ``file`` does not modify the system itself, it
@@ -307,7 +307,7 @@ considered the name:
isnamevar
end
-With this declaration, ``file { "/tmp/file": }`` is basically equivalent to ``file { path =&gt; "/tmp/file" }``.
+With this declaration, ``file { "/tmp/file": }`` is basically equivalent to ``file { path => "/tmp/file" }``.
See [Creating a Puppet Type](creating-a-puppet-type.html) for more
information.