From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sun, 7 Apr 2024 13:41:34 -0500
Subject: new repository

---
 devdocs/vagrant/triggers%2Fconfiguration.html | 36 +++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 devdocs/vagrant/triggers%2Fconfiguration.html

(limited to 'devdocs/vagrant/triggers%2Fconfiguration.html')

diff --git a/devdocs/vagrant/triggers%2Fconfiguration.html b/devdocs/vagrant/triggers%2Fconfiguration.html
new file mode 100644
index 00000000..2406f7ea
--- /dev/null
+++ b/devdocs/vagrant/triggers%2Fconfiguration.html
@@ -0,0 +1,36 @@
+<h1 id="configuration">  Configuration </h1> <p>Vagrant Triggers has a few options to define trigger behavior.</p> <h2 id="options">  Options </h2> <p>The trigger class takes various options.</p> <ul> <li>
+<p><a href="#action"><code>action</code></a> (symbol, array) - Expected to be a single symbol value, an array of symbols, or a <em>splat</em> of symbols. The first argument that comes after either <strong>before</strong> or <strong>after</strong> when defining a new trigger. Can be any valid Vagrant command. It also accepts a special value <code>:all</code> which will make the trigger fire for every action. An action can be ignored with the <code>ignore</code> setting if desired. These are the valid action commands for triggers:</p> <ul> <li>
+<a href="#destroy"><code>destroy</code></a> </li> <li>
+<a href="#halt"><code>halt</code></a> </li> <li>
+<a href="#provision"><code>provision</code></a> </li> <li>
+<a href="#reload"><code>reload</code></a> </li> <li>
+<a href="#resume"><code>resume</code></a> </li> <li>
+<a href="#suspend"><code>suspend</code></a> </li> <li>
+<a href="#up"><code>up</code></a> </li> </ul> </li> <li>
+<p><a href="#ignore"><code>ignore</code></a> (symbol, array) - Symbol or array of symbols corresponding to the action that a trigger should not fire on.</p> </li> <li>
+<p><a href="#info"><code>info</code></a> (string) - A message that will be printed at the beginning of a trigger.</p> </li> <li>
+<p><a href="#name"><code>name</code></a> (string) - The name of the trigger. If set, the name will be displayed when firing the trigger.</p> </li> <li>
+<p><a href="#on_error"><code>on_error</code></a> (symbol) - Defines how the trigger should behave if it encounters an error. By default this will be <code>:halt</code>, but can be configured to ignore failures and continue on with <code>:continue</code>.</p> </li> <li>
+<p><a href="#only_on"><code>only_on</code></a> (string, regex, array) - Limit the trigger to these guests. Values can be a string or regex that matches a guest name.</p> </li> <li>
+<p><a href="#ruby"><code>ruby</code></a> (block) - A block of Ruby code to be executed on the host. The block accepts two arguments that can be used with your Ruby code: <code>env</code> and <code>machine</code>. These options correspond to the Vagrant environment used (note: these are not your shell's environment variables), and the Vagrant guest machine that the trigger is firing on. This option can only be a <code>Proc</code> type, which must be explicitly called out when using the hash syntax for a trigger.</p> <div class="highlight"><pre class="highlight ruby" data-language="ruby">ubuntu.trigger.after :up do |trigger|
+  trigger.info = "More information"
+  trigger.ruby do |env,machine|
+    greetings = "hello there #{machine.id}!"
+    puts greetings
+  end
+end
+</pre></div>
+</li> <li>
+<p><a href="#run_remote"><code>run_remote</code></a> (hash) - A collection of settings to run a inline or remote script with on the guest. These settings correspond to the <a href="../provisioning/shell">shell provisioner</a>.</p> </li> <li>
+<p><a href="#run"><code>run</code></a> (hash) - A collection of settings to run a inline or remote script on the host. These settings correspond to the <a href="../provisioning/shell">shell provisioner</a>. However, at the moment the only settings <code>run</code> takes advantage of are:</p> <ul> <li>
+<a href="#args"><code>args</code></a> </li> <li>
+<a href="#inline"><code>inline</code></a> </li> <li>
+<a href="#path"><code>path</code></a> </li> </ul> </li> <li>
+<p><a href="#warn"><code>warn</code></a> (string) - A warning message that will be printed at the beginning of a trigger.</p> </li> <li>
+<p><a href="#exit_codes"><code>exit_codes</code></a> (integer, array) - A set of acceptable exit codes to continue on. Defaults to <code>0</code> if option is absent. For now only valid with the <code>run</code> option.</p> </li> <li>
+<p><a href="#abort"><code>abort</code></a> (integer,boolean) - An option that will exit the running Vagrant process once the trigger fires. If set to <code>true</code>, Vagrant will use exit code 1. Otherwise, an integer can be provided and Vagrant will it as its exit code when aborting.</p> </li> </ul><div class="_attribution">
+  <p class="_attribution-p">
+    &copy; 2010&ndash;2018 Mitchell Hashimoto<br>Licensed under the MPL 2.0 License.<br>
+    <a href="https://www.vagrantup.com/docs/triggers/configuration.html" class="_attribution-link">https://www.vagrantup.com/docs/triggers/configuration.html</a>
+  </p>
+</div>
-- 
cgit v1.2.3