website: Move the "what is" to the docs homepage
This commit is contained in:
Mitchell Hashimoto
parent
19eff04d2f
commit
d34b0461c5
|
|
@ -2,9 +2,62 @@
|
||||||
layout: "docs"
|
layout: "docs"
|
||||||
---
|
---
|
||||||
|
|
||||||
# Documentation
|
# Packer Documentation
|
||||||
|
|
||||||
Welcome to the Packer documentation! This documentation will guide you from
|
Welcome to the Packer documentation! This documentation will guide you from
|
||||||
complete beginner to being a Packer expert. It introduces all the concepts
|
complete beginner to being a Packer expert. It introduces all the concepts
|
||||||
of Packer as well as contains references material for every configuration
|
of Packer as well as contains references material for every configuration
|
||||||
parameter and command-line flags available to control Packer.
|
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>
|
||||||
|
|
|
||||||
|
|
@ -1,54 +0,0 @@
|
||||||
---
|
|
||||||
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>
|
<h2>Docs</h2>
|
||||||
|
|
||||||
<ul>
|
<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/installation.html">Installation</a></li>
|
||||||
<li><a href="/docs/basics/terminology.html">Terminology</a></li>
|
<li><a href="/docs/basics/terminology.html">Terminology</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
|
||||||
|
|
@ -4,13 +4,6 @@
|
||||||
<title>Packer</title>
|
<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." />
|
<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 -->
|
<!-- HTML5 shiv -->
|
||||||
<!--[if lt IE 9]>
|
<!--[if lt IE 9]>
|
||||||
<script src="dist/html5shiv.js"></script>
|
<script src="dist/html5shiv.js"></script>
|
||||||
|
|
|
||||||
|
|
@ -137,6 +137,22 @@
|
||||||
padding: $docs-top-margin 80px;
|
padding: $docs-top-margin 80px;
|
||||||
display: block;
|
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 {
|
pre {
|
||||||
border: 0;
|
border: 0;
|
||||||
font-size: 14px;
|
font-size: 14px;
|
||||||
|
|
|
||||||
|
|
@ -126,33 +126,9 @@ ul,
|
||||||
ol {
|
ol {
|
||||||
margin: 0;
|
margin: 0;
|
||||||
padding: 0;
|
padding: 0;
|
||||||
}
|
|
||||||
|
|
||||||
ul {
|
|
||||||
list-style-type: none;
|
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 {
|
em {
|
||||||
font-style: italic;
|
font-style: italic;
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue