Known issues for the Bolt 1.x release series.
Tasks executed with PowerShell version 2.x or earlier cannot use parameters named
When executing PowerShell tasks on targets using a PowerShell interpreter version 2.x or earlier, you cannot use a task parameter with the name
type. Bolt versions 1.30.0 and earlier contained a bug that made parameters with the string
type in their name (for example,
serverType) incompatible. Starting with Bolt version 1.31.0, only PowerShell parameters with
type as their complete name are incompatible. For PowerShell version 3 and later, any parameter names are permissible.
JSON strings as command arguments might require additional escaping in PowerShell
When passing complex arguments to tasks with
--params, JSON strings (typically created with the
ConvertTo-Json cmdlet) might require additional escaping. In some cases, you can use the PowerShell stop parsing symbol
--% as a workaround. (BOLT-1130)
SSH keys generated with ssh-keygen from OpenSSH 7.8+ fail
OpenSSH 7.8 switched to generating private keys with its own format rather than the OpenSSL PEM format. The Bolt SSH implementation assumes any key using the OpenSSH format uses ed25519, resulting in false errors such as:
OpenSSH keys only supported if ED25519 is available net-ssh requires the following gems for ed25519 support: * ed25519 (>= 1.2, < 2.0) * bcrypt_pbkdf (>= 1.0, < 2.0) See https://github.com/net-ssh/net-ssh/issues/565 for more information Gem::LoadError : "ed25519 is not part of the bundle. Add it to your Gemfile."
Failed to connect to HOST: expected 64-byte String, got NUM
As a workaround, you can generate new keys with the ssh-keygen
-m PEM flag. For existing keys, you can try exporting keys from the OpenSSH format using the
-e option, although export is not implemented for all private key types. (BOLT-920)
Commands fail in remote Windows sessions
Interactive tools fail when run in a remote PowerShell session. For example, using
--password to prompt for a password when running Bolt triggers an error. As a workaround, consider putting the password in
bolt.yaml or an inventory file, or passing the password on the command line. (BOLT-1075)
Unable to authenticate with ed25519 keys over SSH transport on Windows
ed25519 keys to authenticate over the SSH transport when using Windows bolt controllers is currently unsupported because the ed25519 gem is not installable on Windows. The error message below is an example of an error message to expect.
unsupported key type `ssh-ed25519' net-ssh requires the following gems for ed25519 support: * ed25519 (>= 1.2, < 2.0) * bcrypt_pbkdf (>= 1.0, < 2.0)