moan0s / garage-docker-ansible-deploy

Garage (distributed, s3 compatible object storage service) setup using Ansible and Docker

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Garage Docker Ansible Deploy

Garage Logo

Lint badge

Garage is an open-source distributed object storage service tailored for self-hosting. This playbook helps you to set up such a cluster:

  • Reverse Proxy automatically managed by Traefik.

Planned Features

  • Multiple host support
    • Testing
    • Documentation explaining on how to run this playbook on multiple hosts

Installing

To configure and install Garage on your own server(s), follow the README in the docs/ directory.

Design

Garage is a very flexible software that can server a lot of use-cases. This playbook is opinionated in the sense that it reduces the flexibility of garage in favor of an easy deployment that should serve common use cases. While the playbook should of course be reusable and fairly modular it will never be a solution to all use cases. Assumptions that are made currently:

  • Nodes have a public IPv4/IPv6 address
  • one subdomain per node, 1 additional subdomain per gateway node

The playbook will by default

  • Enable the admin API for each node, reachable via the assigned subdomain
  • Expose a user-defined port per node for replication
  • Use a gateway to expose the s3 API on a new subdomain

Support

Related

This playbook started as a copy of these projects and aims to have a similar layout and reuse some roles. Check them out!

Miscellaneous

  • Set garage_debian_buster: true to avoid a bug with debian buster (tested on a raspi 3A) (more information)
  • Installing docker on Raspberry PI needs you to set docker_apt_arch: arm64 in your vars.yml. Refer to this issue for more information.

Developer Notes

Use ansible_facts[‘distribution_major_version’] instead of garage_debian_buster

About

Garage (distributed, s3 compatible object storage service) setup using Ansible and Docker

License:GNU Affero General Public License v3.0


Languages

Language:Makefile 100.0%