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

     1  ---
     2  page_title: Upgrade to v1.11
     3  description: Learn how to upgrade your Packer installation to v1.11
     4  ---
     5  
     6  # Upgrade to v1.11
     7  
     8  This topic describes upgrade considerations for Packer v1.11. Refer to the [v1.11 release notes](/packer/docs/release-notes/v1_11) for details about changes in v1.11.
     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](/packer/install) for instructions
    13  
    14  ## Upgrade from 1.10 
    15  
    16  Take the following actions as a result of changes between v1.10 and v1.11.
    17  
    18  ### Review templates
    19  
    20  Packer v1.11 supports existing v1.10 templates. No action is required. 
    21  
    22  ### Review plugin management processes
    23  
    24  Because we have made the following changes to how Packer manages plugins, you should review your plugin management processes and make changes accordingly:
    25  
    26  * Single-component plugins are no longer supported. Update your dependencies to multi-component plugins. For example, update `packer-builder-hashicups-coffee` to `packer-plugin-hashicups`.
    27  
    28  * Packer requires all plugins to be installed in the plugins directory. Plugins must follow the hierarchy that matches the expected source. Plugins must follow the `packer-plugin-<name>` naming convention. Plugins must be accompanied by a `SHA256SUM` file. If you manage plugin installations outside of Packer's plugin directory, modify your installation processes to meet these requirements. Refer to [Install Plugins](/packer/docs/plugins/install) for additional information.
    29  
    30  * Packer requires semantic versioning for plugins installed from Packer HCL2 templates. Refer to [Requirements](/packer/docs/plugins/install#requiremets) in the Packer plugin installation documentation for additional information.
    31  
    32  * You can use `-dev` pre-release versions of plugins in your builds using the `packer plugins install --path` command. Refer to [Use a plugin under development](/packer/docs/plugins/install#use-a-plugin-under-development).
    33  
    34  * You can use the `packer plugins install --path` command to install plugins from non-Github hosts. This command installs the plugin in the Packer plugin directory and creates the file hierarchy that matches the supplied source. As result, Packer is able to discover non-Github sources specified in the `required_plugins` blocks. This enables you to add version constraints on those plugins if you so choose.
    35    Although you can add non-GitHub sources to `required_plugins` for validation purposes, remote installation is still limited to Github-sourced plugins. Refer to [Define plugin source](/packer/docs/templates/hcl_templates/blocks/packer#define-plugin-source) in the `required_plugins` reference documentation for additional information.
    36  
    37  ## Troubleshooting
    38  
    39  This section provides guidance on potential issues you may experience after upgrading.
    40  
    41  ### Missing plugins error
    42  
    43  Packer may report that you one or more plugins are missing after the upgrade.
    44  This may occur if you had used one of the following plugin installation methods that are longer supported:
    45  
    46  * Installed the plugin to the directory Packer is invoked from.
    47  * Installed the plugin alongside the Packer binary.
    48  * Installed the plugin under the root of the `PACKER_PLUGIN_PATH` directory.
    49  
    50  For any missing components, you may need to reinstall their respective plugins as described in [Installing Plugins](/packer/docs/plugins/install).
    51  
    52  ### Use `required_plugins` message
    53  
    54  Packer may print a message directing you to specify plugins in the `required_plugins` block in your template and install them using the `packer init` command.
    55  This is the preferred way to manage the plugins, but it is not required. You can still install plugins manually using the `packer plugins install` command. Refer to [Installing Plugins](/packer/docs/plugins/install)
    56  
    57  ### Blocked remote access to plugin 
    58  
    59  If you cannot remotely install a plugin for any reason, such as a firewall configuration or GitHub is blocking access, you can use the local installation methods. Refer to [Installing Plugins](/packer/docs/plugins/install)
    60  
    61  ### Install plugins from legacy JSON template 
    62  
    63  The `required_plugins` block is only available within HCL templates. Legacy JSON users must use `packer plugins install` 
    64  
    65  ## Installing plugins outside of namespace directories
    66  
    67  Packer no longer supports installing plugins that are named `packer-plugin-<name>` under a single root directory.
    68  You can still use Packer CLI commands to install plugins and customise which root directory manages those plugins by setting the `PACKER_PLUGIN_PATH` environment variable so that it points to the custom directory.
    69  Once set, Packer automatically creates the subdirectories that match the sources of the plugins under that directory.
    70  
    71  ## Reference
    72  
    73  Refer to the following topics for additional information about using the Packer CLI to install plugins:
    74  * [`packer init`](https://developer.hashicorp.com/packer/docs/commands/init)
    75  * [`packer plugins install`](https://developer.hashicorp.com/packer/docs/commands/plugins/install).