diff options
Diffstat (limited to 'distro/common/html/ctl_chef_shell.html')
-rw-r--r-- | distro/common/html/ctl_chef_shell.html | 46 |
1 files changed, 45 insertions, 1 deletions
diff --git a/distro/common/html/ctl_chef_shell.html b/distro/common/html/ctl_chef_shell.html index b3ae1742f8..e655ec9146 100644 --- a/distro/common/html/ctl_chef_shell.html +++ b/distro/common/html/ctl_chef_shell.html @@ -88,7 +88,51 @@ <dt><tt class="docutils literal"><span class="pre">-h</span></tt>, <tt class="docutils literal"><span class="pre">--help</span></tt></dt> <dd>Shows help for the command.</dd> <dt><tt class="docutils literal"><span class="pre">-j</span> <span class="pre">PATH</span></tt>, <tt class="docutils literal"><span class="pre">--json-attributes</span> <span class="pre">PATH</span></tt></dt> -<dd>The path to a file that contains JSON data.</dd> +<dd><p class="first">The path to a file that contains JSON data.</p> +<p>Use this option to define a <tt class="docutils literal"><span class="pre">run_list</span></tt> object. For example, a JSON file similar to:</p> +<div class="highlight-javascript"><div class="highlight"><pre><span class="s2">"run_list"</span><span class="o">:</span> <span class="p">[</span> + <span class="s2">"recipe[base]"</span><span class="p">,</span> + <span class="s2">"recipe[foo]"</span><span class="p">,</span> + <span class="s2">"recipe[bar]"</span><span class="p">,</span> + <span class="s2">"role[webserver]"</span> +<span class="p">],</span> +</pre></div> +</div> +<p>may be used by running <tt class="docutils literal"><span class="pre">chef-client</span> <span class="pre">-j</span> <span class="pre">path/to/file.json</span></tt>.</p> +<p>In certain situations this option may be used to update <tt class="docutils literal"><span class="pre">normal</span></tt> attributes.</p> +<div class="last admonition warning"> +<p class="first admonition-title">Warning</p> +<p>Any other attribute type that is contained in this JSON file will be treated as a <tt class="docutils literal"><span class="pre">normal</span></tt> attribute. For example, attempting to update <tt class="docutils literal"><span class="pre">override</span></tt> attributes using the <tt class="docutils literal"><span class="pre">-j</span></tt> option:</p> +<div class="highlight-javascript"><div class="highlight"><pre><span class="p">{</span> + <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"dev-99"</span><span class="p">,</span> + <span class="s2">"description"</span><span class="o">:</span> <span class="s2">"Install some stuff"</span><span class="p">,</span> + <span class="s2">"override_attributes"</span><span class="o">:</span> <span class="p">{</span> + <span class="s2">"apptastic"</span><span class="o">:</span> <span class="p">{</span> + <span class="s2">"enable_apptastic"</span><span class="o">:</span> <span class="s2">"false"</span><span class="p">,</span> + <span class="s2">"apptastic_tier_name"</span><span class="o">:</span> <span class="s2">"dev-99.bomb.com"</span> + <span class="p">}</span> + <span class="p">}</span> +<span class="p">}</span> +</pre></div> +</div> +<p>will result in a node object similar to:</p> +<div class="last highlight-javascript"><div class="highlight"><pre><span class="p">{</span> + <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"maybe-dev-99"</span><span class="p">,</span> + <span class="s2">"normal"</span><span class="o">:</span> <span class="p">{</span> + <span class="s2">"name"</span><span class="o">:</span> <span class="s2">"dev-99"</span><span class="p">,</span> + <span class="s2">"description"</span><span class="o">:</span> <span class="s2">"Install some stuff"</span><span class="p">,</span> + <span class="s2">"override_attributes"</span><span class="o">:</span> <span class="p">{</span> + <span class="s2">"apptastic"</span><span class="o">:</span> <span class="p">{</span> + <span class="s2">"enable_apptastic"</span><span class="o">:</span> <span class="s2">"false"</span><span class="p">,</span> + <span class="s2">"apptastic_tier_name"</span><span class="o">:</span> <span class="s2">"dev-99.bomb.com"</span> + <span class="p">}</span> + <span class="p">}</span> + <span class="p">}</span> +<span class="p">}</span> +</pre></div> +</div> +</div> +</dd> <dt><tt class="docutils literal"><span class="pre">-l</span> <span class="pre">LEVEL</span></tt>, <tt class="docutils literal"><span class="pre">--log-level</span> <span class="pre">LEVEL</span></tt></dt> <dd>The level of logging that will be stored in a log file.</dd> <dt><tt class="docutils literal"><span class="pre">-s</span></tt>, <tt class="docutils literal"><span class="pre">--solo</span></tt></dt> |