README.md

Packer Plugin Gridscale

The gridscale packer plugin can be used with HashiCorp Packer to create custom templates in gridscale. Docs: docs.

Maintainers

This provider plugin is maintained by the Packer team at gridscale.

Requirements

• Packer ≥ v1.7.0
• Go ≥ 1.17 (to build the provider plugin)

Installation

Automatic installation:

Packer (≥ v1.7.0) supports a new packer init command allowing automatic installation of Packer plugins. Plugin installation.

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

packer {
  required_plugins {
    gridscale = {
      version = ">= 0.0.1"
      source  = "github.com/gridscale/gridscale"
    }
  }
}

Manual installation

Plugin installation

Building/Developing the Provider

Build:

$ git clone [email protected]:gridscale/packer-plugin-gridscale.git
$ cd packer-plugin-gridscale
$ make build

For dev:

$ make dev

Running Acceptance Tests

Requirements:

• Environment varialbe GRIDSCALE_UUID has to be set.
• Environment varialbe GRIDSCALE_TOKEN has to be set.

In packer-plugin-gridscale directory, run:

make acctest

This will run the acceptance test for packer-plugin-gridscale.

Examples:

Releasing the Provider:

• Update version in version/version.go
• Do make generate to regenerate docs and go file config.hcl2spec.go (if there are updates in config.go).
• Add entries to CHANGELOG.md