Jun 23, 2025

How to define variables in a Packer template?

Leave a message

How to Define Variables in a Packer Template?

As a leading packer supplier, I understand the significance of defining variables in a Packer template. Packer is a powerful tool that enables the creation of identical machine images for multiple platforms from a single source configuration. Variables play a crucial role in making these templates flexible, reusable, and easy to maintain. In this blog post, I'll share my insights on how to define variables in a Packer template effectively.

Why Use Variables in Packer Templates?

Before diving into the details of defining variables, let's briefly discuss why they are essential. Variables in Packer templates allow you to parameterize your configurations. This means you can reuse the same template across different environments or scenarios by simply changing the variable values. For example, you might have a template for building virtual machine images, and you want to use it to create images with different operating system versions or instance sizes. By using variables, you can avoid duplicating the template and instead adjust the values as needed.

Defining Variables in a Packer Template

There are several ways to define variables in a Packer template. Let's explore each method in detail.

1. Inline Variable Definitions

The simplest way to define variables in a Packer template is inline. You can define variables directly in the template file using the variables block. Here's an example:

{
    "variables": {
        "os_version": "18.04",
        "instance_size": "t2.medium"
    },
    "builders": [
        {
            "type": "amazon-ebs",
            "region": "us-west-2",
            "source_ami_filter": {
                "filters": {
                    "virtualization-type": "hvm",
                    "name": "ubuntu/images/hvm-ssd/ubuntu-bionic-18.04-amd64-server-*",
                    "root-device-type": "ebs"
                },
                "owners": ["099720109477"],
                "most_recent": true
            },
            "instance_type": "{{user `instance_size`}}",
            "ssh_username": "ubuntu"
        }
    ]
}

In this example, we've defined two variables: os_version and instance_size. We can then reference these variables in other parts of the template using the {{user variable_name}} syntax.

Large Bore Double Grip Retrievable Packercdb1e97debbe45bd8052d9d229c1e958

2. Variable Files

If you have a large number of variables or you want to separate your variable definitions from the main template file, you can use variable files. Variable files are simple JSON or HCL files that contain only variable definitions. Here's an example of a variable file named vars.json:

{
    "os_version": "20.04",
    "instance_size": "t3.small"
}

To use this variable file in your Packer template, you can specify it using the -var-file flag when running the packer build command:

packer build -var-file=vars.json template.json
3. Environment Variables

Another way to define variables is through environment variables. You can set environment variables on your system, and Packer will automatically use them if they match the variable names in your template. Here's an example:

export OS_VERSION="22.04"
export INSTANCE_SIZE="t2.large"
packer build template.json

In your Packer template, you can reference these environment variables using the same {{user variable_name}} syntax. Note that environment variable names are case-sensitive.

4. Command-Line Variables

You can also define variables on the command line when running the packer build command. This is useful for overriding variable values defined in the template or variable files. Here's an example:

packer build -var 'os_version=16.04' -var 'instance_size=t3.medium' template.json

Best Practices for Defining Variables

When defining variables in a Packer template, it's important to follow some best practices to ensure your templates are clean, maintainable, and secure.

  • Use Descriptive Variable Names: Choose variable names that clearly describe their purpose. This makes it easier for others (and yourself) to understand the template.
  • Provide Default Values: Whenever possible, provide default values for your variables. This ensures that your template can still work even if a variable value is not provided. You can define default values in the variables block like this:
{
    "variables": {
        "os_version": "18.04",
        "instance_size": {
            "default": "t2.medium"
        }
    }
}
  • Secure Sensitive Variables: If you need to use sensitive information like passwords or API keys as variables, be careful how you handle them. Avoid hardcoding these values in your template or variable files. Instead, use environment variables or secret management tools to keep them secure.

Our Packer Products

As a packer supplier, we offer a wide range of high-quality packers for various applications. Some of our popular products include:

Conclusion

Defining variables in a Packer template is a fundamental skill that can greatly enhance the flexibility and reusability of your configurations. By using inline variable definitions, variable files, environment variables, and command-line variables, you can create templates that are adaptable to different scenarios. Remember to follow best practices when defining variables to ensure the security and maintainability of your templates.

If you're interested in our packer products or have any questions about defining variables in Packer templates, please don't hesitate to contact us for a procurement discussion. We're here to help you find the best solutions for your needs.

References

  • Packer Documentation - HashiCorp. https://www.packer.io/docs
  • AWS Documentation - Amazon Elastic Compute Cloud. https://docs.aws.amazon.com/ec2/index.html
Send Inquiry