docs: add lxc/d to sidebar, cleanup
This commit is contained in:
Matthew Hooker
parent
ec3831323f
commit
fc1ce68bff
|
|
@ -4,7 +4,8 @@ description: |
|
|||
container, runs provisioners within this container, then exports the container
|
||||
as a tar.gz of the root file system.
|
||||
layout: docs
|
||||
page_title: LXC Builder
|
||||
page_title: 'LXC - Builders'
|
||||
sidebar_current: 'docs-builders-lxc`'
|
||||
...
|
||||
|
||||
# LXC Builder
|
||||
|
|
@ -18,14 +19,16 @@ as a tar.gz of the root file system.
|
|||
The LXC builder requires a modern linux kernel and the `lxc` or `lxc1` package.
|
||||
This builder does not work with LXD.
|
||||
|
||||
Note to build Centos images on a Debian family host, you will need the `yum` package installed.
|
||||
|
||||
Some provisioners such as `ansible-local` get confused when running in a container of a different family.
|
||||
E.G. it will attempt to use `apt-get` to install packages, when running in a Centos container if the parent OS is Debian based.
|
||||
~> Note: to build Centos images on a Debian family host, you will need the `yum`
|
||||
package installed.
|
||||
<br>Some provisioners such as `ansible-local` get confused when running in
|
||||
a container of a different family. E.G. it will attempt to use `apt-get` to
|
||||
install packages, when running in a Centos container if the parent OS is Debian
|
||||
based.
|
||||
|
||||
## Basic Example
|
||||
|
||||
Below is a fully functioning example.
|
||||
Below is a fully functioning example.
|
||||
|
||||
``` {.javascript}
|
||||
{
|
||||
|
|
@ -79,19 +82,31 @@ Below is a fully functioning example.
|
|||
|
||||
- `template_name` (string) - The LXC template name to use.
|
||||
|
||||
- `template_environment_vars` (array of strings) - Environmental variables to use to build the template with.
|
||||
- `template_environment_vars` (array of strings) - Environmental variables to
|
||||
use to build the template with.
|
||||
|
||||
### Optional:
|
||||
|
||||
- `target_runlevel` (int) - The minimum run level to wait for the container to reach. Note some distributions (Ubuntu) simulate run levels and may report 5 rather than 3.
|
||||
- `target_runlevel` (int) - The minimum run level to wait for the container to
|
||||
reach. Note some distributions (Ubuntu) simulate run levels and may report
|
||||
5 rather than 3.
|
||||
|
||||
- `output_directory` (string) - The directory in which to save the exported tar.gz. Defaults to `output-<BuildName>` in the current directory.
|
||||
- `output_directory` (string) - The directory in which to save the exported
|
||||
tar.gz. Defaults to `output-<BuildName>` in the current directory.
|
||||
|
||||
- `container_name` (string) - The name of the LXC container. Usually stored in `/var/lib/lxc/containers/<container_name>`. Defaults to `packer-<BuildName>`.
|
||||
- `container_name` (string) - The name of the LXC container. Usually stored in
|
||||
`/var/lib/lxc/containers/<container_name>`. Defaults to
|
||||
`packer-<BuildName>`.
|
||||
|
||||
- `command_wrapper` (string) - Allows you to specify a wrapper command, such as `ssh` so you can execute packer builds on a remote host. Defaults to Empty.
|
||||
- `command_wrapper` (string) - Allows you to specify a wrapper command, such
|
||||
as `ssh` so you can execute packer builds on a remote host. Defaults to
|
||||
Empty.
|
||||
|
||||
- `init_timeout` (string) - The timeout in seconds to wait for the the container to start. Defaults to 20 seconds.
|
||||
|
||||
- `template_parameters` (array of strings) - Options to pass to the given `lxc-template` command, usually located in `/usr/share/lxc/templates/lxc-<template_name>``. Note: This gets passed as ARGV to the template command. Ensure you have an array of strings, as a single string with spaces probably won't work. Defaults to `[]`.
|
||||
- `init_timeout` (string) - The timeout in seconds to wait for the the
|
||||
container to start. Defaults to 20 seconds.
|
||||
|
||||
- `template_parameters` (array of strings) - Options to pass to the given
|
||||
`lxc-template` command, usually located in
|
||||
`/usr/share/lxc/templates/lxc-<template_name>`. Note: This gets passed as
|
||||
ARGV to the template command. Ensure you have an array of strings, as
|
||||
a single string with spaces probably won't work. Defaults to `[]`.
|
||||
|
|
|
|||
|
|
@ -4,7 +4,8 @@ description: |
|
|||
container, runs provisioners within this container, then saves the container
|
||||
as an LXD image.
|
||||
layout: docs
|
||||
page_title: LXD Builder
|
||||
page_title: 'LXD - Builders'
|
||||
sidebar_current: 'docs-builders-lxd'
|
||||
...
|
||||
|
||||
# LXD Builder
|
||||
|
|
@ -20,7 +21,7 @@ This builder does not work with LXC.
|
|||
|
||||
## Basic Example
|
||||
|
||||
Below is a fully functioning example.
|
||||
Below is a fully functioning example.
|
||||
|
||||
``` {.javascript}
|
||||
{
|
||||
|
|
@ -39,14 +40,21 @@ Below is a fully functioning example.
|
|||
|
||||
### Required:
|
||||
|
||||
- `image` (string) - The source image to use when creating the build container. This can be a (local or remote) image (name or fingerprint). E.G. my-base-image, ubuntu-daily:x, 08fababf6f27...
|
||||
Note: The builder may appear to pause if required to download a remote image, as they are usually 100-200MB. `/var/log/lxd/lxd.log` will mention starting such downloads.
|
||||
- `image` (string) - The source image to use when creating the build
|
||||
container. This can be a (local or remote) image (name or fingerprint). E.G.
|
||||
`my-base-image,` `ubuntu-daily:x,` `08fababf6f27`, ...
|
||||
|
||||
~> Note: The builder may appear to pause if required to download
|
||||
a remote image, as they are usually 100-200MB. `/var/log/lxd/lxd.log` will
|
||||
mention starting such downloads.
|
||||
|
||||
### Optional:
|
||||
|
||||
- `name` (string) - The name of the started container. Defaults to `packer-$PACKER_BUILD_NAME`.
|
||||
- `name` (string) - The name of the started container. Defaults to
|
||||
`packer-$PACKER_BUILD_NAME`.
|
||||
|
||||
- `output_image` (string) - The name of the output artifact. Defaults to `name`.
|
||||
|
||||
- `command_wrapper` (string) - lets you prefix all builder commands, such as with `ssh` for a remote build host. Defaults to `""`.
|
||||
- `output_image` (string) - The name of the output artifact. Defaults to
|
||||
`name`.
|
||||
|
||||
- `command_wrapper` (string) - lets you prefix all builder commands, such as
|
||||
with `ssh` for a remote build host. Defaults to `""`.
|
||||
|
|
|
|||
|
|
@ -113,6 +113,12 @@
|
|||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li<%= sidebar_current("docs-builders-lxc") %>>
|
||||
<a href="/docs/builders/lxc.html">LXC</a>
|
||||
</li>
|
||||
<li<%= sidebar_current("docs-builders-lxd") %>>
|
||||
<a href="/docs/builders/lxd.html">LXD</a>
|
||||
</li>
|
||||
<li<%= sidebar_current("docs-builders-null") %>>
|
||||
<a href="/docs/builders/null.html">Null</a>
|
||||
</li>
|
||||
|
|
|
|||
Loading…
Reference in New Issue