Packer Plugin hashicorp-aws

The hashicorp-aws multi-component plugin can be used with HashiCorp Packer to create images supported by hashicorp-aws. For the full list of available features for this plugin see docs.

Installation

Using pre-built releases

Using the packer init command

Starting from version 1.7, Packer supports a new packer init command allowing automatic installation of Packer plugins. Read the Packer documentation for more information.

To install this plugin, copy and paste this code into Packer configuration. Then, run packer init.

packer {
  required_plugins {
    hashicorp-aws = {
      version = ">= 0.0.1"
      source = "github.com/QubitPi/hashicorp-aws"
    }
  }
}

Manual installation

We can find pre-built binary releases of the plugin here. Once we have downloaded the latest archive corresponding to our target OS, uncompress it to retrieve the plugin binary file corresponding to our platform. To install the plugin, please follow the Packer documentation on installing a plugin.

From Sources

If one prefer to build the plugin from sources, clone the GitHub repository locally and run the command make build from the root directory. Upon successful compilation, a packer-plugin-hashicorp-aws plugin binary file can be found in the root directory. To install the compiled plugin, please follow the official Packer documentation on installing a plugin.

Configuration

For more information on how to configure the plugin, please read the documentation located in the docs/ directory.

Contributing

See CONTRIBUTING.md for best practices and instructions on contributing to hashicorp-aws Plugin.

Developing hashicorp-aws Plugin

The Go Workspace

Go expects a single workspace for third-party Go tools installed via go install. By default, this workspace is located in $HOME/go with source code for these tools stored in $HOME/go/src and the compiled binaries in $HOME/go/bin. Set $GOPATH environment variable to this path first:

export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Building from Source

1. Clone this GitHub repository locally:

   git clone git@github.com:QubitPi/packer-plugin-hashicorp-aws.git
   cd packer-plugin-hashicorp-aws

2. Build the plugin from the root directory:

   make build

   After we successfully compile, the packer-plugin-hashicorp-aws plugin binary file is in the root directory.

Running Acceptance Tests

Make sure to install the plugin locally using the steps in Build from source.

Once everything needed is set up, run:

make test

This will run the acceptance tests for all plugins in this set.

Registering Plugin as Packer Integration

Partner and community plugins can be hard to find if a user doesn't know what they are looking for. To assist with plugin discovery Packer offers an integration portal at https://developer.hashicorp.com/packer/integrations to list known integrations that work with the latest release of Packer.

Registering a plugin as an integration requires metadata configuration within the plugin repository and approval by the Packer team. To initiate the process of registering your plugin as a Packer integration refer to the Developing Plugins page.

License

The use and distribution terms for [packer-plugin-hashicorp-aws] are covered by the Apache License, Version 2.0.