Skip to content

Latest commit

 

History

History
97 lines (66 loc) · 1.93 KB

README.md

File metadata and controls

97 lines (66 loc) · 1.93 KB
Raw

terraform-provider-minio

A Terraform provider for Minio, a self-hosted object storage server that is compatible with S3.

Check out the documenation on the Terraform Registry - refaktory/minio for more information and usage examples.

Features

Resources

  • Buckets
    • Create/delete
    • Versioning config
    • Encryption config
    • Replication config
    • Lifecycle config
    • Access rules
  • Users
    • Create/delete
    • Assign policies
    • Assign groups
  • Serviceaccounts
  • Canned policies
  • Groups
    • Create/delete
    • Assign policies
  • Objects
    • [ ] Create files with a given content

Datasources

  • Bucket
  • Canned policy
  • Group
  • User
  • Serviceaccount

Usage

Consult the published documenation on the registry for usage documenation.

Additional examples are available in the ./examples directory.

Local Development

Configure Terraform to use the locally built provider

Add this configuration into $HOME/.terraformrc:

(Notice the trailing /bin in the path)

provider_installation {
  dev_overrides {
    "refaktory-dev/minio" = "/PATH/TO/LOCAL/REPO/bin"
  }

  direct {}
}

Build

Build the provider with make build

Test manually

  • Start a local minio instance in a separate terminal (and keep it running) docker-compose up

  • Use the provider cd ./examples && terraform apply

Deploy

Steps to deploy:

  • make prepare-release
  • git tag v0.X.0
  • git push

Actual publishing is handled by the Github action defined in ./.github/workflows/release.yml.

The module is managed on the Terraform registry at https://registry.terraform.io/publish/provider.

About

Developed by refaktory.