* 每个资源（Resource ）的描述包括： **resource type**, one** title**, a number of **attributes**, each attribute has a **value** <code>
+
user { 'dave':
+
ensure => present,
+
uid => '507',
+
gid => 'admin',
+
shell => '/bin/ksh',
+
home => '/home/dave',
+
managehome => true,
+
}
+
</code>This syntax is called a **resource declaration**
+
* Resource Types : [[https://docs.puppetlabs.com/puppet_core_types_cheatsheet.pdf | puppet_core_types_cheatsheet.pdf]], [[https://docs.puppetlabs.com/references/latest/type.html|the type references]]
+
* ''puppet describe'' : The ''puppet describe'' subcommand can list info about// the currently installed resource types// on a given machine.
+
* ''puppet resource'': Puppet includes a command called ''puppet resource'', which can interactively inspect and modify resources on a single system. Usage:<code>
* All types have a special attribute called the **namevar**, 该属性缺失就默认以** title** 替代
+
* Before being applied, manifests get compiled into a document called a **catalog**
+
* ''puppet apply <.pp file >''
+
* **Puppet agent/master**
+
=== Resource Ordering ===
+
* You can embed relationship information in a resource with the ''before'', ''require'', ''notify'', and ''subscribe'' metaparameters.
+
* You can also declare relationships outside a resource with the ''->'' and ''~>'' chaining arrows.
+
* Relationships can be either ordering (this before that) or ordering-with-notification (this before that, and tell that whether this was changed).
+
* Puppet’s relationship behaviors and syntaxes are documented in[[https://docs.puppetlabs.com/puppet/latest/reference/lang_relationships.html| the Puppet reference manual page on relationships]].
+
* The ''ordering'' setting in ''puppet.conf'' determines the order in which unrelated resources are applied.
* Puppet has a bunch of built-in, pre-assigned variables that you can use.
+
* Facts: [[https://docs.puppetlabs.com/puppet/latest/reference/lang_variables.html#facts-and-built-in-variables|facts]] ,Puppet uses a tool called Facter, which discovers some system information, normalizes it into a set of variables, and passes them off to Puppet. Puppet’s compiler then has access to those facts when it’s reading a manifest.
+
* [[https://docs.puppetlabs.com/facter/latest/core_facts.html|List of core facts]]
* Classes are named blocks of Puppet code, which can be created in one place and invoked elsewhere.
+
* Puppet 的 class 更像是宏， 但拥有变量域。
+
* ''include <class name>'' 来起作用。
+
* Modules:
+
* Modules are just directories with files, arranged in a specific, predictable structure. The manifest files within a module have to obey certain naming restrictions.
+
* Puppet looks for modules in a specific place (or list of places). This set of directories is known as the ''modulepath'', which is a [[https://docs.puppetlabs.com/references/stable/configuration.html#modulepath|configurable setting]]
+
* If a class is defined in a module, you can declare that class by name in //any manifest//. Puppet will automatically find and load the manifest that contains the class definition.
+
* 一个 module 就是一个路径， 模块名就是路径名
+
* module layout: 模块包含子文件夹''manifests'',''files'',''templates''等等, 详看[[https://docs.puppetlabs.com/puppet/latest/reference/modules_fundamentals.html| a page of info about module layout]] 以及 [[https://docs.puppetlabs.com/module_cheat_sheet.pdf| module cheat sheet]].
* Templates are saved as files with the ''.erb'' extension. and be stored in the ''templates/'' directory of any module. There can be any number of subdirectories inside ''templates/''.
+
* Use a template by the function ''template'': <code> file {'/etc/foo.conf':
oakfire