terraform-provider-docker

README

Docker Hub Terraform Provider

This project is used to manage Docker resources (such as repositories, teams, organization settings, and more) using Terraform. It allows users to define Docker infrastructure as code, integrating Docker services into their Terraform workflows. The Terraform Registry page for this provider can be found here.

[!WARNING] This project is not for managing objects in a local docker engine. If you would like to use Terraform to interact with a docker engine, kreuzwerker/docker is a fine provider.

Requirements

• Terraform >= 1.1
• Go >= 1.21 (to build the provider plugin)

Usage

Below is a basic example of how to use the Docker services Terraform provider to create a Docker repository. Using DOCKER_USERNAME and DOCKER_PASSWORD as an environment variable, you can use the following code:

terraform {
  required_providers {
    docker = {
      source  = "docker/docker"
      version = "~> 1.0"
    }
  }
}

provider "docker" { }

resource "docker_repository" "example" {
  name        = "example-repo"
  description = "This is an example Docker repository"
  private     = true
}

Contributing

We welcome contributions to the Docker services Terraform provider, detailed documentation for contributing & building the provider can be found here

Roadmap

Our roadmap is managed through GitHub issues. You can view upcoming features and enhancements, as well as report bugs or request new features, by visiting our issues page.

Support

TODO: how much will we be supporting this & at what cadence?

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for more information.