doc updates after Dan's review

This commit is contained in:
Paul Meyer 2019-10-02 23:41:22 +00:00
parent b9c726417f
commit cf8688ec40
1 changed files with 11 additions and 9 deletions

View File

@ -29,8 +29,8 @@ which is much easier to use.
This builder works by creating a new MD from either an existing source or from
scratch and attaching it to the (already existing) Azure VM where Packer is
running. Once attached, a [chroot](https://en.wikipedia.org/wiki/Chroot) is set
up and made available to the provisioners. After provisioning, the MD is
detached, snapshotted and a MD image is created.
up and made available to the [provisioners](/docs/provisioners/index.html).
After provisioning, the MD is detached, snapshotted and a MD image is created.
Using this process, minutes can be shaved off the image creation process
because Packer does not need to launch a VM instance.
@ -38,24 +38,26 @@ because Packer does not need to launch a VM instance.
There are some restrictions however:
* The host system must be a similar system (generally the same OS version,
kernel versions, etc.) as the image being built.
* If the source is a user image or managed disk, it must be made available in
the same region as the host system. ([name=Paul Meyer]: we could work around
this restriction by doing a cross-region copy, but that takes away the main
speed advantage.)
* If the source is a managed disk, it must be made available in the same
region as the host system.
* The host system SKU has to allow for all of the specified disks to be
attached.
## Configuration Reference
There are many configuration options available for the builder. We'll start
withauthentication parameters, then go over the builder specific options.
with authentication parameters, then go over the Azure chroot builder specific
options.
### Authentication options
The Azure builders [share this configuration](/docs/builders/azure.html).
None of the authentication options are required, but depending on which
ones are specified a different authentication method may be used. See the
[shared Azure builders documentation](/docs/builders/azure.html) for more
information.
<%= partial "partials/builder/azure/common/client/_Config-not-required.html" %>
### Builder specific options
### Azure chroot builder specific options
#### Required:
<%= partial "partials/builder/azure/chroot/_Config-required.html" %>