https://github.com/hashicorp/packer-plugin-docker

Packer plugin for Docker Builder
https://github.com/hashicorp/packer-plugin-docker

docker packer packer-plugin

Last synced: about 4 hours ago
JSON representation

Packer plugin for Docker Builder

• Host: GitHub
• URL: https://github.com/hashicorp/packer-plugin-docker
• Owner: hashicorp
• License: mpl-2.0
• Created: 2021-02-08T18:37:09.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-12-10T19:28:07.000Z (12 days ago)
• Last Synced: 2024-12-16T21:38:55.354Z (6 days ago)
• Topics: docker, packer, packer-plugin
• Language: Go
• Homepage: https://www.packer.io/docs/builders/docker
• Size: 986 KB
• Stars: 31
• Watchers: 11
• Forks: 26
• Open Issues: 30
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

README

        
# Packer Plugin Docker

The `Docker` multi-component plugin can be used with HashiCorp [Packer](https://www.packer.io)

to create custom images. For the full list of available features for this plugin see [docs](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](https://www.packer.io/docs/commands/init) for more information.

To install this plugin, copy and paste this code into your Packer configuration .

Then, run [`packer init`](https://www.packer.io/docs/commands/init).

```hcl

packer {

  required_plugins {

    docker = {

      version = ">= 1.1.1"

      source  = "github.com/hashicorp/docker"

    }

  }

}

```

#### Manual installation

You can find pre-built binary releases of the plugin [here](https://github.com/hashicorp/packer-plugin-docker/releases).

Once you have downloaded the latest archive corresponding to your target OS,

uncompress it to retrieve the plugin binary file corresponding to your platform.

To install the plugin, please follow the Packer documentation on

[installing a plugin](https://www.packer.io/docs/extending/plugins/#installing-plugins).

### From Sources

If you prefer to build the plugin from sources, clone the GitHub repository

locally and run the command `go build` from the root

directory. Upon successful compilation, a `packer-plugin-docker` 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](https://www.packer.io/docs/extending/plugins/#installing-plugins).

### Configuration

For more information on how to configure the plugin, please read the

documentation located in the [`docs/`](docs) directory.

## Contributing

See

[CONTRIBUTING.md](https://github.com/hashicorp/packer-plugin-docker/blob/master/.github/CONTRIBUTING.md)

for best practices and instructions on contributing to Docker Plugin.