/ansible-minio

Ansible role to install the minio S3 compatible object storage server (https://minio.io)

Primary LanguageShellMIT LicenseMIT

minio logo

Ansible Role: Minio

Build Status License GitHub tag

Install and configure the Minio S3 compatible object storage server on RHEL/CentOS and Debian/Ubuntu.

Requirements

Ansible: ansible >= 2.8, < 2.9

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

minio_server_bin: /usr/local/bin/minio
minio_client_bin: /usr/local/bin/mc

Installation path of the Minio server and client binaries.

minio_server_release: ""
minio_client_release: ""

Release to install for both server and client; lastest if the default. Can be 'RELEASE.2019-06-27T21-13-50Z' for instance.

minio_user: minio
minio_group: minio
minio_usergroup_manage: true

Name and group of the user running the minio server. Without explicitly disabling minio_usergroup_manage: false this role will create/update this user and group. The created/updated user will be installed/updated as a system user.

minio_server_envfile: /etc/default/minio

Path to the file containing the minio server configuration ENV variables.

minio_server_addr: ":9091"

The Minio server listen address.

minio_server_datadirs:
  - /var/lib/minio

Directories of the folder containing the minio server data

minio_server_make_datadirs: true

Create directories from minio_server_datadirs

minio_server_cluster_nodes: [ ]

Set a list of nodes to create a distributed cluster.

In this mode, ansible will create your server datadirs, but use this list for the server startup. Note you will need a number of disks to satisfy Minio's distributed storage requirements.

Example:

minio_server_datadirs:
  - '/minio-data'
  - ...
minio_server_cluster_nodes:
  - 'https://server1/minio-data'
  - 'https://server2/minio-data'
  - 'https://server3/minio-data'
  - ...
minio_server_env_extra: ""

Additional environment variables to be set in Minio server environment

minio_server_opts: ""

Additional CLI options that must be appended to the minio server start command.

minio_access_key: ""
minio_secret_key: ""

Minio access and secret keys. Change the value in order to rotate credentials.

minio_install_server: true
minio_install_client: true

Options to modify number of parity blocks

minio_storage_class_standard:
minio_storage_class_rrs:

Switches to disable minio server and/or minio client installation.

Dependencies

None.

Example Playbook

- name: "Install Minio"
  hosts: all
  become: yes
  roles:
    - { role: atosatto.minio }
  vars:
    minio_server_datadirs: [ "/minio-test" ]

Changelog

See changelog.

License

MIT