[[bolt]]

https://puppet.com/docs/puppet/7/lang_resources.html

`puppet strings` for documentation?

== Relationships and ordering ==
https://puppet.com/docs/puppet/7/lang_relationships.html

=== Parameters ===

before    :: Applies a resource before the target resource.
require   :: Applies a resource after the target resource.
notify    :: Applies a resource before the target resource. The target resource refreshes if the notifying resource changes.
subscribe :: Applies a resource after the target resource. The subscribing resource refreshes if the target resource changes.

=== Multiple declaration in single resource block ===

{{{puppet
  ini_setting {
    default:
      ensure  => $ensure,
      path    => $::pacman::conf_path,
      section => $repo_name ,
      ;
    "Pacman repo [${repo_name}] server":
      setting => 'Server',
      value   => $server ,
      ;
    "Pacman repo [${repo_name}] SigLevel":
      setting => 'SigLevel',
      value   => $sig_level ,
      ;
  }
}}}

== operators ==
https://puppet.com/docs/puppet/7/lang_expressions.html


== Conditionals ==
https://puppet.com/docs/puppet/7/lang_conditional.html

=== Type Case ===
{{{puppet
$variable ? {
    Array  => 'one thing',
    String => 'Anothing thing',
    default => '',
}
}}}

==== On Undef ====
{{{puppet
$debug_api = $irc_bridge_debug_port ? {
  Undef  => { 'enabled' => false },
  String => {
        'enabled' => false,
        'port'    => $irc_bridge_debug_port,
  },
}
}}}


=== Regular Case ===
{{{puppet
case $variable {
    'A', 'B': {
    }
    /^(C|D)$/: {
    }
    default: {
    }
}


== Type conversion ==

{{{puppet
[['a', 1]].hash => { 'a' => 1 }
}}}

== Exported Resources ==
https://puppet.com/docs/puppet/7/lang_exported.html

{{{puppet
@@ssh { ... }
Ssh <<| |>>
}}}

== Server ==

{{{class="client"
$ puppet ssl clean
}}}

{{{class="server"
$ puppetserver ca revoke --certname gandalf.adrift.space
$ puppetserver ca clean --certname gandalf.adrift.space
}}}

--------------------------------------------------

{{{class="client"
$ rm -rf /etc/puppetlabs/puppet/ssl
$ puppet ssl bootstrap --server=busting.adrift.space --waitforcert=10
}}}

{{{class="server"
$ puppetserver ca list
$ puppetserver ca sign --certname gandalf.adrift.space
}}}



==== Generate new key ====

{{{
puppetserver ca setup --subject-alt-names busting.adrift.space,adrift.space,puppet
}}}




puppet apply --modulepath=/etc/puppetlabs/code/environments/<ENVIRONMENT>/modules -e 'include ::profiles::puppetserver'

== autonotify ==
lib/puppet/transaction/event_manager.rb
lib/puppet/graph/relationship_graph.rb:192


= Abstract Data Types =
https://www.puppet.com/docs/puppet/7/lang_data_abstract.html

- `Optional[_<type>_]`
- `NotUndef[_<type>_]` :: Any - undef
- `Variant[_<type>_, _<type>_ ...]` :: one of