Merge pull request #8887 from hashicorp/untangle_ssh_docs_from_aws

Untangle ssh docs from aws
This commit is contained in:
Megan Marsh 2020-03-13 11:09:47 -07:00 committed by GitHub
commit 698f744780
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 18 additions and 24 deletions

View File

@ -77,13 +77,12 @@ type SSH struct {
// A plaintext password to use to authenticate with SSH. // A plaintext password to use to authenticate with SSH.
SSHPassword string `mapstructure:"ssh_password"` SSHPassword string `mapstructure:"ssh_password"`
// If specified, this is the key that will be used for SSH with the // If specified, this is the key that will be used for SSH with the
// machine. The key must match a key pair name loaded up into Amazon EC2. // machine. The key must match a key pair name loaded up into the remote.
// By default, this is blank, and Packer will generate a temporary keypair // By default, this is blank, and Packer will generate a temporary keypair
// unless [`ssh_password`](../templates/communicator.html#ssh_password) is // unless [`ssh_password`](#ssh_password) is used.
// used. // [`ssh_private_key_file`](#ssh_private_key_file) or
// [`ssh_private_key_file`](../templates/communicator.html#ssh_private_key_file) // [`ssh_agent_auth`](#ssh_agent_auth) must be specified when
// or `ssh_agent_auth` must be specified when `ssh_keypair_name` is // [`ssh_keypair_name`](#ssh_keypair_name) is utilized.
// utilized.
SSHKeyPairName string `mapstructure:"ssh_keypair_name"` SSHKeyPairName string `mapstructure:"ssh_keypair_name"`
// The name of the temporary key pair to generate. By default, Packer // The name of the temporary key pair to generate. By default, Packer
// generates a name that looks like `packer_<UUID>`, where &lt;UUID&gt; is // generates a name that looks like `packer_<UUID>`, where &lt;UUID&gt; is
@ -109,12 +108,10 @@ type SSH struct {
SSHTimeout time.Duration `mapstructure:"ssh_timeout"` SSHTimeout time.Duration `mapstructure:"ssh_timeout"`
// If true, the local SSH agent will be used to authenticate connections to // If true, the local SSH agent will be used to authenticate connections to
// the source instance. No temporary keypair will be created, and the // the source instance. No temporary keypair will be created, and the
// values of `ssh_password` and `ssh_private_key_file` will be ignored. To // values of [`ssh_password`](#ssh_password) and
// use this option with a key pair already configured in the source AMI, // [`ssh_private_key_file`](#ssh_private_key_file) will be ignored. The
// leave the `ssh_keypair_name` blank. To associate an existing key pair in // environment variable `SSH_AUTH_SOCK` must be set for this option to work
// AWS with the source instance, set the `ssh_keypair_name` field to the // properly.
// name of the key pair. The environment variable `SSH_AUTH_SOCK` must be
// set for this option to work properly.
SSHAgentAuth bool `mapstructure:"ssh_agent_auth"` SSHAgentAuth bool `mapstructure:"ssh_agent_auth"`
// If true, SSH agent forwarding will be disabled. Defaults to `false`. // If true, SSH agent forwarding will be disabled. Defaults to `false`.
SSHDisableAgentForwarding bool `mapstructure:"ssh_disable_agent_forwarding"` SSHDisableAgentForwarding bool `mapstructure:"ssh_disable_agent_forwarding"`

View File

@ -10,13 +10,12 @@
- `ssh_password` (string) - A plaintext password to use to authenticate with SSH. - `ssh_password` (string) - A plaintext password to use to authenticate with SSH.
- `ssh_keypair_name` (string) - If specified, this is the key that will be used for SSH with the - `ssh_keypair_name` (string) - If specified, this is the key that will be used for SSH with the
machine. The key must match a key pair name loaded up into Amazon EC2. machine. The key must match a key pair name loaded up into the remote.
By default, this is blank, and Packer will generate a temporary keypair By default, this is blank, and Packer will generate a temporary keypair
unless [`ssh_password`](../templates/communicator.html#ssh_password) is unless [`ssh_password`](#ssh_password) is used.
used. [`ssh_private_key_file`](#ssh_private_key_file) or
[`ssh_private_key_file`](../templates/communicator.html#ssh_private_key_file) [`ssh_agent_auth`](#ssh_agent_auth) must be specified when
or `ssh_agent_auth` must be specified when `ssh_keypair_name` is [`ssh_keypair_name`](#ssh_keypair_name) is utilized.
utilized.
- `temporary_key_pair_name` (string) - The name of the temporary key pair to generate. By default, Packer - `temporary_key_pair_name` (string) - The name of the temporary key pair to generate. By default, Packer
generates a name that looks like `packer_<UUID>`, where &lt;UUID&gt; is generates a name that looks like `packer_<UUID>`, where &lt;UUID&gt; is
@ -42,12 +41,10 @@
- `ssh_agent_auth` (bool) - If true, the local SSH agent will be used to authenticate connections to - `ssh_agent_auth` (bool) - If true, the local SSH agent will be used to authenticate connections to
the source instance. No temporary keypair will be created, and the the source instance. No temporary keypair will be created, and the
values of `ssh_password` and `ssh_private_key_file` will be ignored. To values of [`ssh_password`](#ssh_password) and
use this option with a key pair already configured in the source AMI, [`ssh_private_key_file`](#ssh_private_key_file) will be ignored. The
leave the `ssh_keypair_name` blank. To associate an existing key pair in environment variable `SSH_AUTH_SOCK` must be set for this option to work
AWS with the source instance, set the `ssh_keypair_name` field to the properly.
name of the key pair. The environment variable `SSH_AUTH_SOCK` must be
set for this option to work properly.
- `ssh_disable_agent_forwarding` (bool) - If true, SSH agent forwarding will be disabled. Defaults to `false`. - `ssh_disable_agent_forwarding` (bool) - If true, SSH agent forwarding will be disabled. Defaults to `false`.