Commit d34b0461 authored by Mitchell Hashimoto's avatar Mitchell Hashimoto

website: Move the "what is" to the docs homepage

parent 19eff04d
......@@ -2,9 +2,62 @@
layout: "docs"
---
# Documentation
# Packer Documentation
Welcome to the Packer documentation! This documentation will guide you from
complete beginner to being a Packer expert. It introduces all the concepts
of Packer as well as contains references material for every configuration
parameter and command-line flags available to control Packer.
## What is Packer?
Packer is a tool for creating identical machine images for multiple platforms
from a single source configuration. Packer is lightweight, runs on every major
operating system, and is highly performant, creating machine images for
multiple platforms in parallel. Packer does not replace configuration management
like Chef or Puppet. In fact, when building images, Packer is able to use tools
like Chef or Puppet to install software onto the image.
A _machine image_ is a single static unit that contains a pre-configured operating
system and installed software which is used to quickly create new running machines.
Machine image formats change for each platform. Some examples include
[AMIs](http://en.wikipedia.org/wiki/Amazon_Machine_Image) for EC2,
VMDK/VMX files for VMware, OVF exports for VirtualBox, etc.
## Why Use Packer?
Historically, creating
these images has been a predominantly manual process. Any existing automated tools were able to
create only one type of image. Packer, on the other hand, is able to automatically
create any type of image, all from a single source configuration. This unlocks
untapped potential in developing, testing, and deploying applications.
Pre-baked machine images have a lot of advantages, but we've been unable to
benefit from them because they have been too tedious to create and manage.
Packer tears down this barrier, allowing the benefits of pre-baked machine
images to become available to everyone. Some benefits include:
* ***Super fast infrastructure deployment***. Packer images allow you to launch
completely provisioned and configured machines in seconds, rather than
several minutes or hours. This benefits not only production, but development as well,
since development virtual machines can also be launched in seconds, without waiting
for a typically much longer provisioning time.
* ***Multi-provider portability***. Because Packer creates identical images for
multiple platforms, you can run production in AWS, staging/QA in a private
cloud like OpenStack, and development in desktop virtualization solutions
such as VMware or VirtualBox. Each environment is running an identical
machine image, giving ultimate portability.
* ***Improved stability***. Packer installs and configures all the software for
a machine at the time the image is built. If there are bugs in these scripts,
they'll be caught early, rather than several minutes after a machine is launched.
* ***Greater testability***. After a machine image is built, that machine image
can be quickly launched and smoke tested to verify that things appear to be
working. If they are, you can be confident that any other machines launched
from that image will function properly.
Packer makes it extremely easy to take advantage of all these benefits.
What are you waiting for? Let's get started!<D-j>
---
layout: "docs"
---
# What is Packer?
Packer is a tool for creating identical machine images for multiple platforms
from a single source configuration. Packer is lightweight, runs on every major
operating system, and is highly performant, creating machine images for
multiple platforms in parallel. Packer does not replace configuration management
like Chef or Puppet. In fact, when building images, Packer is able to use tools
like Chef or Puppet to install software onto the image.
A _machine image_ is a single static unit that contains a pre-configured operating
system and installed software which is used to quickly create new running machines.
Machine image formats change for each platform. Some examples include
[AMIs](http://en.wikipedia.org/wiki/Amazon_Machine_Image) for EC2,
VMDK/VMX files for VMware, OVF exports for VirtualBox, etc.
Historically, creating
these images has been a predominantly manual process. Any existing automated tools were able to
create only one type of image. Packer, on the other hand, is able to automatically
create any type of image, all from a single source configuration. This unlocks
untapped potential in developing, testing, and deploying applications.
Pre-baked machine images have a lot of advantages, but we've been unable to
benefit from them because they have been too tedious to create and manage.
Packer tears down this barrier, allowing the benefits of pre-baked machine
images to become available to everyone. Some benefits include:
* Super fast infrastructure deployment. Packer images allow you to launch
completely provisioned and configured machines in seconds, rather than
several minutes or hours. This benefits not only production, but development as well,
since development virtual machines can also be launched in seconds, without waiting
for a typically much longer provisioning time.
* Multi-provider portability. Because Packer creates identical images for
multiple platforms, you can run production in AWS, staging/QA in a private
cloud like OpenStack, and development in desktop virtualization solutions
such as VMware or VirtualBox. Each environment is running an identical
machine image, giving ultimate portability.
* Improved stability. Packer installs and configures all the software for
a machine at the time the image is built. If there are bugs in these scripts,
they'll be caught early, rather than several minutes after a machine is launched.
* Improved testability. After a machine image is built, that machine image
can be quickly launched and smoke tested to verify that things appear to be
working. If they are, you can be confident that any other machines launched
from that image will function properly.
Packer makes it extremely easy to take advantage of all these benefits.
What are you waiting for? Let's get started!
......@@ -4,7 +4,7 @@
<h2>Docs</h2>
<ul>
<li><a href="/docs/what-is-packer.html">What is Packer?</a></li>
<li><a href="/docs/index.html">What is Packer?</a></li>
<li><a href="/docs/installation.html">Installation</a></li>
<li><a href="/docs/basics/terminology.html">Terminology</a></li>
</ul>
......
......@@ -4,13 +4,6 @@
<title>Packer</title>
<meta name="description" content="Packer is a free and open source tool for creating golden images for multiple platforms from a single source configuration." />
<!-- rewrite URLs for @2x retina images -->
<script>
if((window.devicePixelRatio===undefined?1:window.devicePixelRatio)>1) {
document.cookie='HTTP_IS_RETINA=1;path=/';
}
</script>
<!-- HTML5 shiv -->
<!--[if lt IE 9]>
<script src="dist/html5shiv.js"></script>
......
......@@ -137,6 +137,22 @@
padding: $docs-top-margin 80px;
display: block;
ul,
ol {
list-style-type: circle;
list-style-position: inside;
margin-top: $baseline;
margin-left: 20px;
margin-right: 20px;
li {
font-family: $serif;
font-size: 17px;
line-height: (30/17) !important;
margin-bottom: $baseline;
}
}
pre {
border: 0;
font-size: 14px;
......
......@@ -126,33 +126,9 @@ ul,
ol {
margin: 0;
padding: 0;
}
ul {
list-style-type: none;
}
ol {
list-style-type: circle;
list-style-position: inside;
margin-top: $baseline * 2;
li {
font-family: $serif;
font-size: 17px;
line-height: (30/17) !important;
margin-bottom: $baseline;
}
}
li {
}
blockquote {
}
em {
font-style: italic;
}
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment