manual/site/machinery-build.1/index.html in machinery-tool-1.21.0 vs manual/site/machinery-build.1/index.html in machinery-tool-1.22.0
- old
+ new
@@ -21,35 +21,38 @@
</li>
- <li>Home
- <ul>
-
- <li class="">
- <a href="../machinery_main_general.1/">General</a>
- </li>
-
- <li class="">
- <a href="../machinery_main_scopes.1/">Scopes</a>
- </li>
-
- <li class="">
- <a href="../machinery_main_usecases.1/">Use cases</a>
- </li>
-
- <li class="">
- <a href="../machinery_security_implications.1/">Security Implications</a>
- </li>
-
- </ul>
+ <li class="">
+ <a href="../machinery_main_general.1/">General Overview</a>
</li>
+ <li class="">
+ <a href="../machinery_main_scopes.1/">Scopes</a>
+ </li>
+
+
+
+
+ <li class="">
+ <a href="../machinery_main_usecases.1/">Use cases</a>
+ </li>
+
+
+
+
+ <li class="">
+ <a href="../machinery_main_security_implications.1/">Security Implications</a>
+ </li>
+
+
+
+
<li>Commands
<ul>
<li class="">
<a href="../machinery-analyze.1/">Analyze</a>
@@ -82,15 +85,19 @@
<li class="">
<a href="../machinery-export-kiwi.1/">Export Kiwi</a>
</li>
<li class="">
+ <a href="../machinery-export-html.1/">Export HTML</a>
+ </li>
+
+ <li class="">
<a href="../machinery-inspect.1/">Inspect</a>
</li>
<li class="">
- <a href="../machinery-inspect-docker.1/">Inspect Docker</a>
+ <a href="../machinery-inspect-container.1/">Inspect Container</a>
</li>
<li class="">
<a href="../machinery-list.1/">List</a>
</li>
@@ -130,30 +137,30 @@
</ul>
</div>
<div class="content">
<h1 id="build-build-image-from-system-description">build — Build Image from System Description</h1>
-<h2 id="synopsis">SYNOPSIS</h2>
+<h2 id="synopsis">Synopsis</h2>
<p><code>machinery build</code> NAME -i IMAGE-DIR | --image-dir=IMAGE-DIR</p>
<p><code>machinery</code> help build</p>
-<h2 id="description">DESCRIPTION</h2>
+<h2 id="description">Description</h2>
<p>The <code>build</code> command builds an image from a system description. The image is a
system image in the qcow2 format, which can be used with the KVM hypervisor.
It can be run locally or deployed to a cloud environment.</p>
<p><code>machinery</code> uses the image building command line tool
-<a href="http://en.opensuse.org/Portal:KIWI">KIWI</a> to perform the actual build. KIWI
+<a href="http://opensuse.github.io/kiwi/">KIWI</a> to perform the actual build. KIWI
data is stored to a temporary directory and cleaned up after the build. The KIWI
log is shown as output of the <code>build</code> command format for showing progress and
diagnosing errors.</p>
<p>When building an image, Machinery filters out some files which would break the
built image. The list of filters is shown at the beginning of the build.</p>
-<h2 id="arguments">ARGUMENTS</h2>
+<h2 id="arguments">Arguments</h2>
<ul>
<li><code>NAME</code> (required):
Use specified system description.</li>
</ul>
-<h2 id="options">OPTIONS</h2>
+<h2 id="options">Options</h2>
<ul>
<li>
<p><code>-i IMAGE-DIR</code>, <code>--image-dir=IMAGE-DIR</code> (required):
Save image file under specified path.</p>
</li>
@@ -164,11 +171,11 @@
<li>
<p><code>-s</code>, <code>--enable-ssh</code> (optional):
Enable SSH service in built image</p>
</li>
</ul>
-<h2 id="prerequisites">PREREQUISITES</h2>
+<h2 id="prerequisites">Prerequisites</h2>
<ul>
<li>
<p>The <code>build</code> command requires the packages <code>kiwi</code> and <code>kiwi-desc-vmxboot</code>.</p>
</li>
<li>
@@ -182,10 +189,10 @@
</li>
<li>
<p>Machinery can only build x86_64 images on x86_64 systems at the moment.</p>
</li>
</ul>
-<h2 id="examples">EXAMPLES</h2>
+<h2 id="examples">Examples</h2>
<ul>
<li>
<p>To build an image from the system description named "tux" and to save the
image under the <code>/tmp/tux/</code> directory:</p>
<p>$ <code>machinery</code> build tux -i /tmp/tux/</p>
\ No newline at end of file