github.com/hashicorp/packer@v1.14.3/website/content/docs/upgrade/v1_12.mdx (about)

     1  ---
     2  page_title: Upgrade to v1.12
     3  description: Learn how to upgrade your Packer installation to v1.12
     4  ---
     5  
     6  # Upgrade to v1.12
     7  
     8  The topic describes upgrade considerations for Packer v1.12. Refer to the [v1.12 release notes](/packer/docs/release-notes/v1_12) for details about changes in v1.12.
     9  
    10  ## Overview
    11  
    12  You can use the upgrade command for the package manager you installed Packer with or download and replace the existing binary to upgrade Packer. Refer to [Install Packer](https://developer.hashicorp.com/packer/install) for instructions.
    13  
    14  ## Upgrade from 1.11
    15  
    16  Packer 1.12's notable changes can be summarised by the following points:
    17  
    18  1. Protocol changes for Packer/plugin communication
    19  2. Introduction of a Directed Acyclic Graph (DAG) for Data Sources and Locals
    20  
    21  **Note**: These are not breaking changes, and your templates should continue working as-is.
    22  
    23  ## Protocol changes
    24  
    25  When initialising, Packer is now able to pick between two different protocols for communication with plugins: gob (legacy), and protobuf/msgpack.
    26  
    27  The protobuf/msgpack protocol will become the standard approach after this release, but in order to avoid breaking retro-compatibility, Packer only chooses this protocol if the following conditions are true:
    28  
    29  1. All the plugin candidates for a build support the new protocol
    30  2. Packer supports the protocol
    31  
    32  This is an internal Packer change and should be completely transparent to you.
    33  However, if you start seeing errors with Packer/plugin communication like serialization errors, please [report it to us](https://github.com/hashicorp/packer/issues) so we can fix it in a later version.
    34  You can set the `PACKER_FORCE_GOB` environment variable to force Packer and plugins to use the legacy serialization format for communication.
    35  
    36  Example: `export PACKER_FORCE_GOB=1` will force using gob for serialization.
    37  
    38  ## Data Source and Locals DAG support
    39  
    40  In order to allow more flexibility in how you define data sources and locals, we introduced a graph-based approach to scheduling the evaluation of those components.
    41  With this change, you can use a local variable in a data source, and vice-versa. You are not bound to a strict evaluation order.
    42  
    43  If your templates worked with older versions of Packer, this change should be transparent to you.
    44  However, if you are experiencing errors with your data sources or locals, typically errors due to unkown values, or other dependency problems, please [report it to us](https://github.com/hashicorp/packer/issues) so we can fix it in a later version.
    45  You can use the `--use-sequential-evaluation` command-line option can be used to revert back to the evaluation scheduler that Packer used prior to v1.12.0.
    46  
    47  Example: `packer build --use-sequential-evaluation <TEMPLATE>` will force Packer to use the sequential evaluation methods.