Known issues in the PDK 1.x release series.
PDK 1.15.0 is incompatible with Bundler 2.1.0 and later
PDK 1.15.0 is incompatible with Bundler 2.1.0 and later. Use Bundler 2.0.2 instead.
PDK analytics opt-out dialog causing issues with CI systems
In PDK 1.11.0, when running in a Continuous Integration (CI) environment (such as Travis CI), PDK may get stuck waiting for a response as to whether or not you want to opt-out of anonymous analytics data collection.
PDK_FRONTENDenvironment variable set to the value "noninteractive". For example, if running a validation:
$ PDK_FRONTEND=noninteractive pdk validate
You might also be able to configure the environment variable for the entire job. See https://docs.travis-ci.com/user/environment-variables/ for information about configuring this in Travis CI, or check your CI system's documentation for similar options. PDK-1414, PDK-1415
Using PDK with PowerShell ISE locks the console
If you run the
module command inside a PowerShell ISE window, it returns an error and locks
the console. Do not use PDK with
PowerShell ISE. PDK-1168
PDK not in ZShell PATH on Mac OS X
With ZShell on Mac OS X, PDK is not automatically added to the PATH. To fix
this, add the PATH by adding the line
eval $(/usr/libexec/path_helper -s) to the ZShell
resource file (
pdk test unit --list lacks
pdk test unit --list lacks detailed
information and tests appear duplicated. To get the full text descriptions, execute
the tests in JUnit format by running
pdk test unit --format=junit
Module validation and testing might fail if dependencies include gems with native extensions
You might not be able to use PDK with a module if that module's Gemfile requires Ruby gems with native extensions, particularly when running on Windows.
When you run
pdk validate or
pdk test unit on
a module, PDK tries to install
any missing module dependencies before it runs validations or tests. On some
platforms, PDK can install gems
with native extensions, if you already have the required compilation tools and
libraries installed. On Windows,
however, the Ruby installations
managed by PDK are not configured
to support native extension compilation, even if the necessary tools are
If you encounter this issue on a platform other than Windows, you might be able to resolve it by researching and installing the required dependencies for the gem that is failing to install.
If you encounter this issue on a Windows platform, you must remove or comment out the Gemfile dependencies that include native extensions or that have dependencies that include native extensions.