github.com/hashicorp/packer

NOTES:

• data/packer-image-iteration has been removed. This was an undocumented and unusable data source that was built for experimentation but not released. It should not affect users in any way but is being mentioned for visibility purposes. GH-12111

FEATURES:

• core: Metadata for capturing template types such as JSON or HCL2 has been added to the HCP Packer registry metadata. Upon running a packer build the type of template used during execution will be sent along to the registry as additional build metadata.GH-12132

PLUGINS:

The following external plugins have been updated and pinned to address open issues. Please see their respective changelogs for details on plugin specific bug fixes and improvements.

• alicloud@v1.0.5 - CHANGELOG
• amazon@v1.1.6 - CHANGELOG
• proxmox@v1.1.0 - CHANGELOG
• vsphere@v1.1.1 - CHANGELOG
• qemu@v1.0.8 - CHANGELOG

IMPROVEMENTS:

• cmd/hcl2_upgrade: Generate variable block for all referenced user input variables. GH-12136
• cmd/validate: Add support for the -evaluate-datasources flag to evaluate the data sources from a template during validation time. GH-12106 GH-12152
• core/hcl2: Variable definition files containing undeclared variables within an HCL2 template will no longer warn during build execution. Warnings will be displayed to a user during template validation, which can be disabled by passing the -no-warn-undeclared-var flag to the validate command. GH-12104 GH-12109
• core: Docker images have been updated to include the xorriso package for supporting the creation of ISO files.GH-12081
• core: Split HCP Packer publishing components into a separate internal-only module. GH-11 GH-12116

BUG FIXES:

• cmd/init: The init command will try to fallback to the next available version for a plugin, if the most recent version is not available or has a missing checksum file. This should prevent Packer from trying to install versions that have a GitHub tag but no actual assets. GH-12103
• cmd/plugins: The plugins install sub-command will try to fallback to the next available version for a plugin, if the most recent version is not available or has a missing checksum file. This should prevent Packer from trying to install versions that have a GitHub tag but no actual assets. GH-12103
• core: Bump Go version to 1.18.9 to address vulnerability GO-2022-1144, which concerns the net/http and golang.org/x/net packages.GH-12153 GH-12158
• core: Fix the registration of deleted input artifacts in HCP Packer when setting keep_input_artifacts to false.GH-11462
• core: Using different template types when building a HCP Packer image iteration will now trigger a runtime build error due to the mixing of template types. GH-12132

NOTES:

• Packer user documentation has been moved to the new HashiCorp developer documentation portal. The main Packer site (https://www.packer.io) will continue to be the home for Packer but all requests for general documentation and binary downloads will be redirected to https://developer.hashicorp.com/packer. Users are encouraged to visit the developer documentation portal for access to all Packer related documentation; including integrations with HCP Packer.

• The Oracle builder and post-processor are no longer vendored with Packer core. Users of the Oracle plugin should use packer init to install the latest version of the plugin. See the Oracle Plugin Documentation for more information. GH-11983

• HCP Packer environment variables: The behavior of some HCP Packer-specific environment variables have changed slightly. Refer to HCP Packer in the Packer documentation for a full list of HCP Packer environment variables. GH-12059

  • For JSON templates, the HCP_PACKER_REGISTRY environment variable was previously required to enable the HCP Packer integration. In this release, the environment variable is now optional, and can be used for disabling the publishing of metadata for any HCP Packer enabled configuration template.
  • For HCL2 templates, the HCP_PACKER_REGISTRY environment variable can be used to disable publishing to a HCP Packer registry even if the template defines a hcp_packer_registry block. This can be useful for testing that a template works as intended prior to pushing metadata to HCP Packer.
  • The HCP_PACKER_BUCKET_NAME environment variable is now the only requirement to push metadata to a HCP Packer registry, in both JSON and HCL2 templates without a hcp_packer_registry block.

FEATURES:

• provisioner/powershell: Add use_pwsh configuration argument to support pwsh in powershell provisioner. GH-11950

PLUGINS:

• builder/oracle: Remove Oracle plugin from the list of vendored plugins. GH-11983

IMPROVEMENTS:

• command/hcl2_upgrade: Has been updated to persist all possible template engine options that were supported by the legacy JSON templates. While the upgrade command copies the template engine options as is support for the template options may not actually work with HCL2 templates; indicated by an error similar to fieldname type <no value> is invalid. Before executing a build with the upgraded template you are encouraged to run packer validate against the template and fix any invalid <no value> references. GH-12068
• core/hcl2: Packer will now report an error when executing a build with no sources selected for execution. GH-12016
• core/hcp: Configuration errors for HCP Packer enabled builds have been consolidated into a single report to help users address all potential issues before retrying their build. GH-12031
• core/hcp: Named builds within a legacy JSON template are now published to a HCP Packer registry using its full build name (e.g happycloud.windows-srv-2019), as opposed to just the build name field (e.g "name"="windows-srv-2019"). Builders with no defined name will continue to publish build metadate using the builder type as the build name (e.g happycloud). GH-12059
• core:hcl2: When a variable is set in a variables definitions file (i.e *.pkrvars.hcl), but isn't defined with the template files (i.e *.pkr.hcl), the outputted error message will now include an example of variable block that can be added to the build template to remedy the issue. GH-12020
• core: Add ppc64le to binary releases for Linux. GH-11966
• core: Bump github.com/hashicorp/packer-plugin-sdk from 0.3.1 to 0.3.2. GH-11981
• core: Bump supported Go version to 1.18. GH-11927

BUG FIXES:

• command/hcl2_upgrade: special case: Azure shared_image_gallery fix. GH-12087
• core: Bump golang.org/x/sys to address CVE-2022-29526. GH-11953
• core: Bump golang.org/x/text to v0.3.8. GH-12047
• core: Update dependency to resolve GO-2022-0969. GH-12009

NOTES:

• There's been a change in the way the ssh_timeout and the ssh_handshake_attempts configuration arguments work together. The behaviour is unchanged if both or none are specified. However, if only one of the two is set the other won't have a default value anymore and will be ignored. See Packer Plugin SDK change for details

• packer-plugin-digitalocean: The Digital Ocean Packer plugin has been handed over to the Digital Ocean team. New releases for this plugin are available at https://github.com/digitalocean/packer-plugin-digitalocean. This plugin is still being bundled in the Packer binary but will be removed in a future release. Existing references to the plugin will continue to work but users are advised to update the required_plugins block to use the new plugin source address. GH-11912

required_plugins {
    digitalocean = {
     source =  "github.com/digitalocean/digitalocean"
     version = ">=1.0.8"
    }
}

• packer-plugin-outscale: The Outscale Packer plugin managed by the Outscale team, since Packer 1.7.9, has been removed from the Packer binary. Users are advised to install the latest version of the plugin by running packer plugins install github.com/outscale/outscale. GH-11912

• packer-plugin-scaleway: The Scaleway Packer plugin managed by the Scaleway team, since Packer 1.7.7, has been removed from the Packer binary. Users are advised to install the latest version of the plugin by running packer plugins install github.com/scaleway/scaleway. GH-11912

FEATURES:

• Future Scaffolding: This release contains additional changes that allow Packer core to validate that a newly built image is a direct child of a HCP Packer registry source image. This feature is only available for HCP Packer enabled builds using the hcp_packer_image and hcp_packer_iteration data source for setting a builder's source image. GH-11861

PLUGINS:

The following external plugins have been updated and pinned to address open issues. Please see their respective changelogs for details on plugin specific bug fixes and improvements.

• amazon@v1.1.2 - CHANGELOG
• ansible@v1.0.3 - CHANGELOG
• azure@v1.3.0 - CHANGELOG
• docker@v1.0.7 - CHANGELOG
• googlecompute@v1.0.14 - CHANGELOG
• lxc@v1.0.2 - CHANGELOG
• triton@v1.0.2 - CHANGELOG
• vsphere@v1.0.7 - CHANGELOG
• yandex@v1.1.2 - CHANGELOG

IMPROVEMENTS:

• Bump packer-plugin-sdk to v0.3.1 to fix inconsistencies between ssh_timeout and ssh_handshake_attempts configuration arguments in the SSH communicator. GH-11909
• core: During long running builds the HCP Packer registry will mark a build as timed out if it has not posted an update after a certain number of minutes. For HCP Packer enabled builds a status update will now be sent every 2 minutes to the registry to prevent long builds from being marked as timed out. GH-11846
• data/hcp_packer_image: Add component_type configuration argument to support specifying an exact build image when multiple images exist in the same provider and region for a given HCP Packer bucket iteration. GH-11872
• data/hcp_packer_image: Add support for channel as input argument to retrieve an image from the associated iteration. If using several images from a single iteration, you may prefer sourcing an iteration first, and referencing it for subsequent uses, as every hcp_packer_image with the channel set will generate a potentially billable HCP Packer request but if several hcp_packer_images use a shared hcp_packer_iteration that will only generate one potentially billable request. GH-11865

BUG FIXES

• core/hcl2: Fix crash when parsing malformed provisioner override blocks. GH-11881
• core/hcl2: Fix crash when running packer validate on templates containing one or more HCP Packer data sources. GH-11883