• Stars
    star
    232
  • Rank 172,847 (Top 4 %)
  • Language
    Go
  • License
    GNU Affero Genera...
  • Created almost 5 years ago
  • Updated 3 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Terraform provider for managing MinIO S3 buckets and IAM Users.

minio-provider-terraform

Terraform Provider for MinIO

Contributors GitHub go.mod Go version GitHub Workflow Status GitHub release (latest by date including pre-releases)

Explore the docs »

Table of Contents

About this project

A Terraform provider to manage MinIO Cloud Storage.

Made with ♥ using Go.

Supported Versions

  • Terraform v1.4
  • Go v1.19

It doesn't mean that this provider won't run on previous versions of Terraform or Go, though. It just means that we can't guarantee backward compatibility.

Building and Installing

Prebuilt versions of this provider are available on the releases page.

But if you need to build it yourself, just download this repository, install Task:

go install github.com/go-task/task/v3/cmd/task@latest

And run the following command to build and install the plugin in the correct folder (resolved automatically based on the current Operating System):

task install

Examples

Use examples/main.tf to create some test config, such as:

provider "minio" {
  minio_server   = "localhost:9000"
  minio_region   = "us-east-1"
  minio_user     = "minio"
  minio_password = "minio123"
}

You may use variables to fill up configurations:

variable "minio_region" {
  description = "Default MINIO region"
  default     = "us-east-1"
}

variable "minio_server" {
  description = "Default MINIO host and port"
  default     = "localhost:9000"
}

variable "minio_user" {
  description = "MINIO user"
  default     = "minio"
}

variable "minio_password" {
  description = "MINIO password"
  default     = "minio123"
}

Testing

For testing locally, run the docker compose to spin up a minio server:

docker-compose up

Access http://localhost:8000 on your browser, apply your terraform templates and watch them going live.

Usage

See our examples folder.

Roadmap

See the open issues for a list of proposed features (and known issues). See CONTRIBUTING for more information.

License

Distributed under the Apache License. See LICENSE for more information.

Acknowledgements