30 lines
971 B
Markdown
30 lines
971 B
Markdown
# `finallycoffee.services.minio` ansible role
|
|
|
|
## Overview
|
|
|
|
This role deploys a [min.io](https://min.io) server (s3-compatible object storage server)
|
|
using the official docker container image.
|
|
|
|
## Configuration
|
|
|
|
The role requires setting the password for the `root` user (name can be changed by
|
|
setting `minio_root_username`) in `minio_root_password`. That user has full control
|
|
over the minio-server instance.
|
|
|
|
### Useful config hints
|
|
|
|
Most configuration is done by setting environment variables in
|
|
`minio_container_extra_env`, for example:
|
|
|
|
```yaml
|
|
minio_container_extra_env:
|
|
# disable the "console" web browser UI
|
|
MINIO_BROWSER: off
|
|
# enable public prometheus metrics on `/minio/v2/metrics/cluster`
|
|
MINIO_PROMETHEUS_AUTH_TYPE: public
|
|
```
|
|
|
|
When serving minio (or any s3-compatible server) on a "subfolder",
|
|
see https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTRedirect.html
|
|
and https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html
|