Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
P
packer
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Kristopher Ruzic
packer
Commits
3cc90768
Commit
3cc90768
authored
Jun 23, 2015
by
Mitchell Hashimoto
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
website: update docs to link to communicator
parent
4244a6ce
Changes
15
Show whitespace changes
Inline
Side-by-side
Showing
15 changed files
with
62 additions
and
190 deletions
+62
-190
website/source/docs/builders/amazon-chroot.html.markdown
website/source/docs/builders/amazon-chroot.html.markdown
+4
-0
website/source/docs/builders/amazon-ebs.html.markdown
website/source/docs/builders/amazon-ebs.html.markdown
+6
-13
website/source/docs/builders/amazon-instance.html.markdown
website/source/docs/builders/amazon-instance.html.markdown
+4
-11
website/source/docs/builders/digitalocean.html.markdown
website/source/docs/builders/digitalocean.html.markdown
+4
-10
website/source/docs/builders/docker.html.markdown
website/source/docs/builders/docker.html.markdown
+4
-0
website/source/docs/builders/googlecompute.markdown
website/source/docs/builders/googlecompute.markdown
+6
-9
website/source/docs/builders/null.html.markdown
website/source/docs/builders/null.html.markdown
+2
-19
website/source/docs/builders/openstack.html.markdown
website/source/docs/builders/openstack.html.markdown
+4
-10
website/source/docs/builders/parallels-iso.html.markdown
website/source/docs/builders/parallels-iso.html.markdown
+4
-15
website/source/docs/builders/parallels-pvm.html.markdown
website/source/docs/builders/parallels-pvm.html.markdown
+4
-15
website/source/docs/builders/qemu.html.markdown
website/source/docs/builders/qemu.html.markdown
+4
-17
website/source/docs/builders/virtualbox-iso.html.markdown
website/source/docs/builders/virtualbox-iso.html.markdown
+4
-15
website/source/docs/builders/virtualbox-ovf.html.markdown
website/source/docs/builders/virtualbox-ovf.html.markdown
+4
-15
website/source/docs/builders/vmware-iso.html.markdown
website/source/docs/builders/vmware-iso.html.markdown
+4
-22
website/source/docs/builders/vmware-vmx.html.markdown
website/source/docs/builders/vmware-vmx.html.markdown
+4
-19
No files found.
website/source/docs/builders/amazon-chroot.html.markdown
View file @
3cc90768
...
...
@@ -51,6 +51,10 @@ There are many configuration options available for the builder. They are
segmented below into two categories: required and optional parameters. Within
each category, the available configuration keys are alphabetized.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`access_key`
(string) - The access key used to communicate with AWS.
...
...
website/source/docs/builders/amazon-ebs.html.markdown
View file @
3cc90768
...
...
@@ -31,6 +31,10 @@ There are many configuration options available for the builder. They are
segmented below into two categories: required and optional parameters. Within
each category, the available configuration keys are alphabetized.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`access_key`
(string) - The access key used to communicate with AWS.
...
...
@@ -154,20 +158,9 @@ AMI if one with the same name already exists. Default `false`.
generate a temporary keypair.
`ssh_private_key_file`
must be specified
with this.
*
`ssh_port`
(integer) - The port that SSH will be available on. This defaults
to port 22.
*
`ssh_private_key_file`
(string) - Use this ssh private key file instead of
a generated ssh key pair for connecting to the instance. This key file must
already exist on the
`source_ami`
*
`ssh_private_ip`
(bool) - If true, then SSH will always use the private
IP if available.
*
`ssh_timeout`
(string) - The time to wait for SSH to become available
before timing out. The format of this value is a duration such as "5s"
or "5m". The default SSH timeout is "5m", or five minutes.
*
`subnet_id`
(string) - If using VPC, the ID of the subnet, such as
"subnet-12345def", where Packer will launch the EC2 instance. This field is
required if you are using an non-default VPC.
...
...
website/source/docs/builders/amazon-instance.html.markdown
View file @
3cc90768
...
...
@@ -36,6 +36,10 @@ There are many configuration options available for the builder. They are
segmented below into two categories: required and optional parameters. Within
each category, the available configuration keys are alphabetized.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`access_key`
(string) - The access key used to communicate with AWS.
...
...
@@ -193,20 +197,9 @@ AMI if one with the same name already exists. Default `false`.
generate a temporary keypair.
`ssh_private_key_file`
must be specified
with this.
*
`ssh_port`
(integer) - The port that SSH will be available on. This defaults
to port 22.
*
`ssh_private_key_file`
(string) - Use this ssh private key file instead of
a generated ssh key pair for connecting to the instance. This key file must
already exist on the
`source_ami`
*
`ssh_private_ip`
(bool) - If true, then SSH will always use the private
IP if available.
*
`ssh_timeout`
(string) - The time to wait for SSH to become available
before timing out. The format of this value is a duration such as "5s"
or "5m". The default SSH timeout is "5m", or five minutes.
*
`subnet_id`
(string) - If using VPC, the ID of the subnet, such as
"subnet-12345def", where Packer will launch the EC2 instance. This field is
required if you are using an non-default VPC.
...
...
website/source/docs/builders/digitalocean.html.markdown
View file @
3cc90768
...
...
@@ -24,6 +24,10 @@ There are many configuration options available for the builder. They are
segmented below into two categories: required and optional parameters. Within
each category, the available configuration keys are alphabetized.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`api_token`
(string) - The client TOKEN to use to access your account.
...
...
@@ -53,16 +57,6 @@ each category, the available configuration keys are alphabetized.
To help make this unique, use a function like
`timestamp`
(see
[
configuration templates
](
/docs/templates/configuration-templates.html
)
for more info)
*
`ssh_port`
(integer) - The port that SSH will be available on. Defaults to port
22.
*
`ssh_timeout`
(string) - The time to wait for SSH to become available
before timing out. The format of this value is a duration such as "5s"
or "5m". The default SSH timeout is "1m".
*
`ssh_username`
(string) - The username to use in order to communicate
over SSH to the running droplet. Default is "root".
*
`state_timeout`
(string) - The time to wait, as a duration string,
for a droplet to enter a desired state (such as "active") before
timing out. The default state timeout is "6m".
...
...
website/source/docs/builders/docker.html.markdown
View file @
3cc90768
...
...
@@ -62,6 +62,10 @@ Configuration options are organized below into two categories: required and
optional. Within each category, the available options are alphabetized and
described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`commit`
(boolean) - If true, the container will be committed to an
...
...
website/source/docs/builders/googlecompute.markdown
View file @
3cc90768
...
...
@@ -85,6 +85,10 @@ existing GCE image. The account file is obtained in the previous section.
Configuration options are organized below into two categories: required and optional. Within
each category, the available options are alphabetized and described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`project_id`
(string) - The project ID that will be used to launch instances
...
...
@@ -120,13 +124,6 @@ each category, the available options are alphabetized and described.
*
`network`
(string) - The Google Compute network to use for the launched
instance. Defaults to
`"default"`
.
*
`ssh_port`
(integer) - The SSH port. Defaults to
`22`
.
*
`ssh_timeout`
(string) - The time to wait for SSH to become available.
Defaults to
`"1m"`
.
*
`ssh_username`
(string) - The SSH username. Defaults to
`"root"`
.
*
`state_timeout`
(string) - The time to wait for instance state changes.
Defaults to
`"5m"`
.
...
...
website/source/docs/builders/null.html.markdown
View file @
3cc90768
...
...
@@ -29,23 +29,6 @@ no provisioners are defined, but it will connect to the specified host via ssh.
## Configuration Reference
Configuration options are organized into two categories: required and
optional. Within each category, the available options are alphabetized and
described.
### Required:
*
`host`
(string) - The hostname or IP address to connect to.
*
`ssh_password`
(string) - The password to be used for the ssh connection.
Cannot be combined with ssh_private_key_file.
*
`ssh_private_key_file`
(string) - The filename of the ssh private key to be
used for the ssh connection. E.g. /home/user/.ssh/identity_rsa.
*
`ssh_username`
(string) - The username to be used for the ssh connection.
### Optional:
*
`port`
(integer) - ssh port to connect to, defaults to 22.
The null builder has no configuration parameters other than the
[
communicator
](
/docs/templates/communicator.html
)
settings.
website/source/docs/builders/openstack.html.markdown
View file @
3cc90768
...
...
@@ -27,6 +27,10 @@ There are many configuration options available for the builder. They are
segmented below into two categories: required and optional parameters. Within
each category, the available configuration keys are alphabetized.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`flavor`
(string) - The ID, name, or full URL for the desired flavor for the
...
...
@@ -82,16 +86,6 @@ each category, the available configuration keys are alphabetized.
If not specified, Packer will use the environment variable
`OS_REGION_NAME`
, if set.
*
`ssh_port`
(integer) - The port that SSH will be available on. Defaults to port
22.
*
`ssh_timeout`
(string) - The time to wait for SSH to become available
before timing out. The format of this value is a duration such as "5s"
or "1m". The default SSH timeout is "5m".
*
`ssh_username`
(string) - The username to use in order to communicate
over SSH to the running server. The default is "root".
*
`ssh_interface`
(string) - The type of interface to connect via SSH. Values
useful for Rackspace are "public" or "private", and the default behavior is
to connect via whichever is returned first from the OpenStack API.
...
...
website/source/docs/builders/parallels-iso.html.markdown
View file @
3cc90768
...
...
@@ -50,6 +50,10 @@ There are many configuration options available for the Parallels builder.
They are organized below into two categories: required and optional. Within
each category, the available options are alphabetized and described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`iso_checksum`
(string) - The checksum for the OS ISO file. Because ISO
...
...
@@ -190,21 +194,6 @@ each category, the available options are alphabetized and described.
If it doesn't shut down in this time, it is an error. By default, the timeout
is "5m", or five minutes.
*
`ssh_key_path`
(string) - Path to a private key to use for authenticating
with SSH. By default this is not set (key-based auth won't be used).
The associated public key is expected to already be configured on the
VM being prepared by some other process (kickstart, etc.).
*
`ssh_password`
(string) - The password for
`ssh_username`
to use to
authenticate with SSH. By default this is the empty string.
*
`ssh_port`
(integer) - The port that SSH will be listening on in the guest
virtual machine. By default this is 22.
*
`ssh_wait_timeout`
(string) - The duration to wait for SSH to become
available. By default this is "20m", or 20 minutes. Note that this should
be quite long since the timer begins as soon as the virtual machine is booted.
*
`vm_name`
(string) - This is the name of the PVM directory for the new
virtual machine, without the file extension. By default this is
"packer-BUILDNAME", where "BUILDNAME" is the name of the build.
...
...
website/source/docs/builders/parallels-pvm.html.markdown
View file @
3cc90768
...
...
@@ -46,6 +46,10 @@ There are many configuration options available for the Parallels builder.
They are organized below into two categories: required and optional. Within
each category, the available options are alphabetized and described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`source_path`
(string) - The path to a PVM directory that acts as
...
...
@@ -133,21 +137,6 @@ each category, the available options are alphabetized and described.
If it doesn't shut down in this time, it is an error. By default, the timeout
is "5m", or five minutes.
*
`ssh_key_path`
(string) - Path to a private key to use for authenticating
with SSH. By default this is not set (key-based auth won't be used).
The associated public key is expected to already be configured on the
VM being prepared by some other process (kickstart, etc.).
*
`ssh_password`
(string) - The password for
`ssh_username`
to use to
authenticate with SSH. By default this is the empty string.
*
`ssh_port`
(integer) - The port that SSH will be listening on in the guest
virtual machine. By default this is 22.
*
`ssh_wait_timeout`
(string) - The duration to wait for SSH to become
available. By default this is "20m", or 20 minutes. Note that this should
be quite long since the timer begins as soon as the virtual machine is booted.
*
`vm_name`
(string) - This is the name of the virtual machine when it is
imported as well as the name of the PVM directory when the virtual machine is
exported. By default this is "packer-BUILDNAME", where "BUILDNAME" is
...
...
website/source/docs/builders/qemu.html.markdown
View file @
3cc90768
...
...
@@ -73,6 +73,10 @@ There are many configuration options available for the Qemu builder.
They are organized below into two categories: required and optional. Within
each category, the available options are alphabetized and described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`iso_checksum`
(string) - The checksum for the OS ISO file. Because ISO
...
...
@@ -241,23 +245,6 @@ qemu-system-x86 command. The arguments are all printed for review.
Packer will choose a randomly available port in this range to use as the
host port.
*
`ssh_key_path`
(string) - Path to a private key to use for authenticating
with SSH. By default this is not set (key-based auth won't be used).
The associated public key is expected to already be configured on the
VM being prepared by some other process (kickstart, etc.).
*
`ssh_password`
(string) - The password for
`ssh_username`
to use to
authenticate with SSH. By default this is the empty string.
*
`ssh_port`
(integer) - The port that SSH will be listening on in the guest
virtual machine. By default this is 22. The Qemu builder will map, via
port forward, a port on the host machine to the port listed here so
machines outside the installing VM can access the VM.
*
`ssh_wait_timeout`
(string) - The duration to wait for SSH to become
available. By default this is "20m", or 20 minutes. Note that this should
be quite long since the timer begins as soon as the virtual machine is booted.
*
`vm_name`
(string) - This is the name of the image (QCOW2 or IMG) file for
the new virtual machine, without the file extension. By default this is
"packer-BUILDNAME", where "BUILDNAME" is the name of the build.
...
...
website/source/docs/builders/virtualbox-iso.html.markdown
View file @
3cc90768
...
...
@@ -48,6 +48,10 @@ There are many configuration options available for the VirtualBox builder.
They are organized below into two categories: required and optional. Within
each category, the available options are alphabetized and described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`iso_checksum`
(string) - The checksum for the OS ISO file. Because ISO
...
...
@@ -196,21 +200,6 @@ each category, the available options are alphabetized and described.
Packer will choose a randomly available port in this range to use as the
host port.
*
`ssh_key_path`
(string) - Path to a private key to use for authenticating
with SSH. By default this is not set (key-based auth won't be used).
The associated public key is expected to already be configured on the
VM being prepared by some other process (kickstart, etc.).
*
`ssh_password`
(string) - The password for
`ssh_username`
to use to
authenticate with SSH. By default this is the empty string.
*
`ssh_port`
(integer) - The port that SSH will be listening on in the guest
virtual machine. By default this is 22.
*
`ssh_wait_timeout`
(string) - The duration to wait for SSH to become
available. By default this is "20m", or 20 minutes. Note that this should
be quite long since the timer begins as soon as the virtual machine is booted.
*
`ssh_skip_nat_mapping`
(bool) - Defaults to false. When enabled, Packer does
not setup forwarded port mapping for SSH requests and uses
`ssh_port`
on the
host to communicate to the virtual machine
...
...
website/source/docs/builders/virtualbox-ovf.html.markdown
View file @
3cc90768
...
...
@@ -54,6 +54,10 @@ There are many configuration options available for the VirtualBox builder.
They are organized below into two categories: required and optional. Within
each category, the available options are alphabetized and described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`source_path`
(string) - The path to an OVF or OVA file that acts as
...
...
@@ -171,21 +175,6 @@ each category, the available options are alphabetized and described.
Packer will choose a randomly available port in this range to use as the
host port.
*
`ssh_key_path`
(string) - Path to a private key to use for authenticating
with SSH. By default this is not set (key-based auth won't be used).
The associated public key is expected to already be configured on the
VM being prepared by some other process (kickstart, etc.).
*
`ssh_password`
(string) - The password for
`ssh_username`
to use to
authenticate with SSH. By default this is the empty string.
*
`ssh_port`
(integer) - The port that SSH will be listening on in the guest
virtual machine. By default this is 22.
*
`ssh_wait_timeout`
(string) - The duration to wait for SSH to become
available. By default this is "20m", or 20 minutes. Note that this should
be quite long since the timer begins as soon as the virtual machine is booted.
*
`ssh_skip_nat_mapping`
(bool) - Defaults to false. When enabled, Packer does
not setup forwarded port mapping for SSH requests and uses
`ssh_port`
on the
host to communicate to the virtual machine
...
...
website/source/docs/builders/vmware-iso.html.markdown
View file @
3cc90768
...
...
@@ -49,6 +49,10 @@ There are many configuration options available for the VMware builder.
They are organized below into two categories: required and optional. Within
each category, the available options are alphabetized and described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`iso_checksum`
(string) - The checksum for the OS ISO file. Because ISO
...
...
@@ -201,28 +205,6 @@ each category, the available options are alphabetized and described.
slightly larger. If you find this to be the case, you can disable compaction
using this configuration value.
*
`ssh_host`
(string) - Hostname or IP address of the host. By default, DHCP
is used to connect to the host and this field is not used.
*
`ssh_key_path`
(string) - Path to a private key to use for authenticating
with SSH. By default this is not set (key-based auth won't be used).
The associated public key is expected to already be configured on the
VM being prepared by some other process (kickstart, etc.).
*
`ssh_password`
(string) - The password for
`ssh_username`
to use to
authenticate with SSH. By default this is the empty string.
*
`ssh_port`
(integer) - The port that SSH will listen on within the virtual
machine. By default this is 22.
*
`ssh_skip_request_pty`
(boolean) - If true, a pty will not be requested as
part of the SSH connection. By default, this is "false", so a pty
_will_ be requested.
*
`ssh_wait_timeout`
(string) - The duration to wait for SSH to become
available. By default this is "20m", or 20 minutes. Note that this should
be quite long since the timer begins as soon as the virtual machine is booted.
*
`tools_upload_flavor`
(string) - The flavor of the VMware Tools ISO to
upload into the VM. Valid values are "darwin", "linux", and "windows".
By default, this is empty, which means VMware tools won't be uploaded.
...
...
website/source/docs/builders/vmware-vmx.html.markdown
View file @
3cc90768
...
...
@@ -44,6 +44,10 @@ There are many configuration options available for the VMware builder.
They are organized below into two categories: required and optional. Within
each category, the available options are alphabetized and described.
In addition to the options listed here, a
[
communicator
](
/docs/templates/communicator.html
)
can be configured for this builder.
### Required:
*
`source_path`
(string) - Path to the source VMX file to clone.
...
...
@@ -126,25 +130,6 @@ each category, the available options are alphabetized and described.
slightly larger. If you find this to be the case, you can disable compaction
using this configuration value.
*
`ssh_key_path`
(string) - Path to a private key to use for authenticating
with SSH. By default this is not set (key-based auth won't be used).
The associated public key is expected to already be configured on the
VM being prepared by some other process (kickstart, etc.).
*
`ssh_password`
(string) - The password for
`ssh_username`
to use to
authenticate with SSH. By default this is the empty string.
*
`ssh_port`
(integer) - The port that SSH will listen on within the virtual
machine. By default this is 22.
*
`ssh_skip_request_pty`
(boolean) - If true, a pty will not be requested as
part of the SSH connection. By default, this is "false", so a pty
_will_ be requested.
*
`ssh_wait_timeout`
(string) - The duration to wait for SSH to become
available. By default this is "20m", or 20 minutes. Note that this should
be quite long since the timer begins as soon as the virtual machine is booted.
*
`vm_name`
(string) - This is the name of the VMX file for the new virtual
machine, without the file extension. By default this is "packer-BUILDNAME",
where "BUILDNAME" is the name of the build.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment