https://github.com/atosatto/ansible-minio

Ansible role to install the minio S3 compatible object storage server (https://minio.io)
https://github.com/atosatto/ansible-minio

ansible minio minio-client minio-server

Last synced: 6 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/atosatto/ansible-minio
• Owner: atosatto
• License: mit
• Created: 2017-01-02T16:34:49.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2023-12-15T12:04:22.000Z (about 1 year ago)
• Last Synced: 2024-12-27T05:05:54.305Z (13 days ago)
• Topics: ansible, minio, minio-client, minio-server
• Language: Shell
• Homepage: https://galaxy.ansible.com/atosatto/minio/
• Size: 94.7 KB
• Stars: 116
• Watchers: 5
• Forks: 93
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        


# Ansible Role: Minio

[![Build Status](https://travis-ci.org/atosatto/ansible-minio.svg?branch=master)](https://travis-ci.org/atosatto/ansible-minio)

[![License](https://img.shields.io/badge/license-MIT%20License-brightgreen.svg)](https://opensource.org/licenses/MIT)

[![Ansible Role](https://img.shields.io/badge/ansible%20role-atosatto.minio-blue.svg)](https://galaxy.ansible.com/atosatto/minio/)

[![GitHub tag](https://img.shields.io/github/tag/atosatto/ansible-minio.svg)](https://github.com/atosatto/ansible-minio/tags)

Install and configure the [Minio](https://minio.io/) S3 compatible object storage server

on RHEL/CentOS and Debian/Ubuntu.

## Requirements

None.

## Role Variables

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

```yaml

minio_server_bin: /usr/local/bin/minio

minio_client_bin: /usr/local/bin/mc

```

Installation path of the Minio server and client binaries.

```yaml

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.

```yaml

minio_user: minio

minio_group: minio

```

Name and group of the user running the minio server.

**NB**: This role automatically creates the minio user and/or group if these does not exist in the system.

```yaml

minio_server_envfile: /etc/default/minio

```

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

```yaml

minio_server_addr: ":9091"

```

The Minio server listen address.

```yaml

minio_server_datadirs:

  - /var/lib/minio

```

Directories of the folder containing the minio server data

```yaml

minio_server_make_datadirs: true

```

Create directories from `minio_server_datadirs`

```yaml

minio_server_cluster_nodes: [ ]

```

Set a list of nodes to create a [distributed cluster](https://docs.minio.io/docs/distributed-minio-quickstart-guide).

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:

```yaml

minio_server_datadirs:

  - '/minio-data'

  - ...

minio_server_cluster_nodes:

  - 'https://server1/minio-data'

  - 'https://server2/minio-data'

  - 'https://server3/minio-data'

  - ...

```

```yaml

minio_server_env_extra: ""

```

Additional environment variables to be set in Minio server environment

```yaml

minio_server_opts: ""

```

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

```yaml

minio_access_key: ""

minio_secret_key: ""

```

Minio access and secret keys.

```yaml

minio_install_server: true

minio_install_client: true

```

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

## Dependencies

None.

## Example Playbook

```yaml

- name: "Install Minio"

  hosts: all

  become: yes

  roles:

    - { role: atosatto.minio }

  vars:

    minio_server_datadirs: [ "/minio-test" ]

```

## Changelog

See [changelog](CHANGELOG.md).

## License

MIT