From 3b22da251d68eedb60f9beff7f2e555449ced637 Mon Sep 17 00:00:00 2001 From: Baptiste Jonglez Date: Tue, 28 Feb 2023 09:10:49 +0100 Subject: Add documentation on community Ansible roles --- doc/book/cookbook/_index.md | 6 +++++- doc/book/cookbook/ansible.md | 51 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+), 1 deletion(-) create mode 100644 doc/book/cookbook/ansible.md (limited to 'doc') diff --git a/doc/book/cookbook/_index.md b/doc/book/cookbook/_index.md index 34e2ed92..a85678fb 100644 --- a/doc/book/cookbook/_index.md +++ b/doc/book/cookbook/_index.md @@ -6,7 +6,7 @@ sort_by = "weight" +++ A cookbook, when you cook, is a collection of recipes. -Similarly, Garage's cookbook contains a collection of recipes that are known to works well! +Similarly, Garage's cookbook contains a collection of recipes that are known to work well! This chapter could also be referred as "Tutorials" or "Best practices". - **[Multi-node deployment](@/documentation/cookbook/real-world.md):** This page will walk you through all of the necessary @@ -26,6 +26,10 @@ This chapter could also be referred as "Tutorials" or "Best practices". - **[Configuring a reverse-proxy](@/documentation/cookbook/reverse-proxy.md):** This page explains how to configure a reverse-proxy to add TLS support to your S3 api endpoint. +- **[Deploying on Kubernetes](@/documentation/cookbook/kubernetes.md):** This page explains how to deploy Garage on Kubernetes using our Helm chart. + +- **[Deploying with Ansible](@/documentation/cookbook/ansible.md):** This page lists available Ansible roles developed by the community to deploy Garage. + - **[Monitoring Garage](@/documentation/cookbook/monitoring.md)** This page explains the Prometheus metrics available for monitoring the Garage cluster/nodes. diff --git a/doc/book/cookbook/ansible.md b/doc/book/cookbook/ansible.md new file mode 100644 index 00000000..6d624c9c --- /dev/null +++ b/doc/book/cookbook/ansible.md @@ -0,0 +1,51 @@ ++++ +title = "Deploying with Ansible" +weight = 35 ++++ + +While Ansible is not officially supported to deploy Garage, several community members +have published Ansible roles. We list them and compare them below. + +## Comparison of Ansible roles + +| Feature | [ansible-role-garage](#zorun-ansible-role-garage) | [garage-docker-ansible-deploy](#moan0s-garage-docker-ansible-deploy) | +|------------------------------------|---------------------------------------------|---------------------------------------------------------------| +| **Runtime** | Systemd | Docker | +| **Target OS** | Any Linux | Any Linux | +| **Architecture** | amd64, arm64, i686 | amd64, arm64 | +| **Additional software** | None | Traefik | +| **Automatic node connection** | ❌ | ✅ | +| **Layout management** | ❌ | ✅ | +| **Manage buckets & keys** | ❌ | ✅ (basic) | +| **Allow custom Garage config** | ✅ | ❌ | +| **Facilitate Garage upgrades** | ✅ | ❌ | +| **Multiple instances on one host** | ✅ | ✅ | + + +## zorun/ansible-role-garage + +[Source code](https://github.com/zorun/ansible-role-garage), [Ansible galaxy](https://galaxy.ansible.com/zorun/garage) + +This role is voluntarily simple: it relies on the official Garage static +binaries and only requires Systemd. As such, it should work on any +Linux-based OS. + +To make things more flexible, the user has to provide a Garage +configuration template. This allows to customize Garage configuration in +any way. + +Some more features might be added, such as a way to automatically connect +nodes to each other or to define a layout. + +## moan0s/garage-docker-ansible-deploy + +[Source code](https://github.com/moan0s/garage-docker-ansible-deploy), [Blog post](https://hyteck.de/post/garage/) + +This role is based on the Docker image for Garage, and comes with +"batteries included": it will additionally install Docker and Traefik. In +addition, it is "opinionated" in the sense that it expects a particular +deployment structure (one instance per disk, one gateway per host, +structured DNS names, etc). + +As a result, this role makes it easier to start with Garage on Ansible, +but is less flexible. -- cgit v1.2.3 From f056ad569dc599ba5f145819bc91a8f15e105347 Mon Sep 17 00:00:00 2001 From: Jonathan Davies Date: Sat, 4 Feb 2023 09:19:19 +0000 Subject: binary-packages.md: Added. --- doc/book/cookbook/_index.md | 4 ++++ doc/book/cookbook/binary-packages.md | 28 ++++++++++++++++++++++++++++ 2 files changed, 32 insertions(+) create mode 100644 doc/book/cookbook/binary-packages.md (limited to 'doc') diff --git a/doc/book/cookbook/_index.md b/doc/book/cookbook/_index.md index a85678fb..07bf6ebf 100644 --- a/doc/book/cookbook/_index.md +++ b/doc/book/cookbook/_index.md @@ -16,6 +16,10 @@ This chapter could also be referred as "Tutorials" or "Best practices". source in case a binary is not provided for your architecture, or if you want to hack with us! +- **[Binary packages](@/documentation/cookbook/binary-packages.md):** This page + lists the different platforms that provide ready-built software packages for + Garage. + - **[Integration with Systemd](@/documentation/cookbook/systemd.md):** This page explains how to run Garage as a Systemd service (instead of as a Docker container). diff --git a/doc/book/cookbook/binary-packages.md b/doc/book/cookbook/binary-packages.md new file mode 100644 index 00000000..606de2b6 --- /dev/null +++ b/doc/book/cookbook/binary-packages.md @@ -0,0 +1,28 @@ ++++ +title = "Binary packages" +weight = 11 ++++ + +Garage is also available in binary packages on: + +## Alpine Linux + +```bash +apk install garage +``` + +## Arch Linux + +Garage is available in the [AUR](https://aur.archlinux.org/packages/garage). + +## FreeBSD + +```bash +pkg install garage +``` + +## NixOS + +```bash +nix-shell -p garage +``` -- cgit v1.2.3 From db69267a56d388ef7e86fbd53a5c24fb110742ba Mon Sep 17 00:00:00 2001 From: vincent Date: Tue, 7 Mar 2023 21:34:55 +0100 Subject: =?UTF-8?q?M=C3=A0J=20logo=20pour=20autocollants?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/sticker/Garage.pdf | 3 - doc/sticker/Garage.png | Bin 15861 -> 0 bytes doc/sticker/Garage.svg | 182 ++++++++++++++++++++++++++++++++++++++++++++- doc/sticker/Garage_NGI.pdf | 3 + doc/sticker/Garage_NGI.png | Bin 0 -> 15861 bytes doc/sticker/Garage_NGI.svg | 1 + 6 files changed, 185 insertions(+), 4 deletions(-) delete mode 100644 doc/sticker/Garage.pdf delete mode 100644 doc/sticker/Garage.png create mode 100644 doc/sticker/Garage_NGI.pdf create mode 100644 doc/sticker/Garage_NGI.png create mode 100644 doc/sticker/Garage_NGI.svg (limited to 'doc') diff --git a/doc/sticker/Garage.pdf b/doc/sticker/Garage.pdf deleted file mode 100644 index 1359a30d..00000000 --- a/doc/sticker/Garage.pdf +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:bddc78212b9c45e9e9f60b6fa53f0bc2c6f24230aaf81f1d4232d56851a2130a -size 417440 diff --git a/doc/sticker/Garage.png b/doc/sticker/Garage.png deleted file mode 100644 index ab95b731..00000000 Binary files a/doc/sticker/Garage.png and /dev/null differ diff --git a/doc/sticker/Garage.svg b/doc/sticker/Garage.svg index da04692b..9464986f 100644 --- a/doc/sticker/Garage.svg +++ b/doc/sticker/Garage.svg @@ -1 +1,181 @@ - \ No newline at end of file + + + + + + + + + + texte garage + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/doc/sticker/Garage_NGI.pdf b/doc/sticker/Garage_NGI.pdf new file mode 100644 index 00000000..1359a30d --- /dev/null +++ b/doc/sticker/Garage_NGI.pdf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:bddc78212b9c45e9e9f60b6fa53f0bc2c6f24230aaf81f1d4232d56851a2130a +size 417440 diff --git a/doc/sticker/Garage_NGI.png b/doc/sticker/Garage_NGI.png new file mode 100644 index 00000000..ab95b731 Binary files /dev/null and b/doc/sticker/Garage_NGI.png differ diff --git a/doc/sticker/Garage_NGI.svg b/doc/sticker/Garage_NGI.svg new file mode 100644 index 00000000..da04692b --- /dev/null +++ b/doc/sticker/Garage_NGI.svg @@ -0,0 +1 @@ + \ No newline at end of file -- cgit v1.2.3