alexisfacques.ansible_module_s3_minio_bucket

ansible-module-minio-bucket

ansible-module-minio-bucket is a special Ansible module that helps you create and delete MinIO S3 buckets. It works similarly to the s3_bucket and aws_s3 modules, but it can handle MinIO bucket policies.

Getting Started

Requirements

Below are the requirements for the host that runs this module.

You need to have minio installed for Python.

Installing

Using "Ansible Role"

You can clone this repository into your Ansible role_path, or install it using ansible-galaxy:
```
ansible-galaxy install alexisfacques.ansible_module_minio_bucket
```

Make sure to import the role in your playbooks before you run any role or task that needs the minio_bucket module:

- hosts: all
  roles:
    - alexisfacques.ansible_module_minio_bucket
  tasks:
    - minio_bucket:
        ...

Using "Ansible Library"

If importing a role seems complicated, you can also place this module in the library directory specified in your ansible.cfg file. The default is a sub-directory named library within the directory where your playbooks are located:

[defaults]
library = /path/to/your/library

Usage

Parameters

Here's a table explaining the parameters you can use:

Parameter	Choices/Defaults	Comments
s3_url - string / required		The S3 URL endpoint.
name - string / required		The name of the S3 bucket.
access_key - string / required		Your MinIO S3 access key.
secret_key - string / required		Your MinIO S3 secret key.
state	Choices: present / absent	Define whether to create or delete the S3 bucket.
policy	Choices: private (leave empty) / read-only / write-only / read-write	The bucket policy for MinIO S3.
validate_certs boolean /	Choices: yes / no	If "no", SSL certificates won't be checked for boto versions >= 2.6.0.