Différences

Ci-dessous, les différences entre deux révisions de la page.

--- technique:adminsys:backup:garage [2023/11/04 19:27] – ajout créa layout limaanto
+++ technique:adminsys:backup:garage [2023/11/04 19:53] (Version actuelle) – ajout bucket limaanto
@@ Ligne 1: / Ligne 1: @@
 # Garage
-## Concepts et rappels
+[Garage](https://garagehq.deuxfleurs.fr) est un outil développé par [deuxfleurs](https://deuxfleurs.fr/) un camarade chaton français depuis quelques années. Il s'agit d'un système de stockage de données réparties permettant d'exposer une API S3 (de l'object storage, techno originalement par Amazon mais implémentée par plein d'autres acteurs depuis).
+Le principe est simple. `garage server` démarre un *nœud* garage à l'aide d'un simple [fichier de configuration](https://garagehq.deuxfleurs.fr/documentation/quick-start/#generating-a-first-configuration-file). Ce nœud peut communiquer avec d'autres nœuds faisant partie du même *cluster*, dont l'organisation est décrite par un *layout*. Celui-ci indique pour chaque nœud du cluster
+- son id (qui sera unique entre plusieurs exécutions)
+- où il se trouve physiquement
+- combien d'espace il expose (la *capacité*)
+- comment y accéder
+Lorsque des données sont ajoutées au cluster, garage duplique `n` fois la donnée (`n` configurable mais souvent 2 ou 3) puis cherche à répartir les `n` copies au travers des différents nœuds. Cela se fait proportionnellement à leur capacité annoncée en privilégiant les zones physiques différentes.
+On peut ensuite interagir avec le stockage du cluster par l’intermédiaire de *buckets S3*
-TODO
 ## Implémentation à Picasoft
@@ Ligne 37: / Ligne 47: @@
 xxxxxxxxxxxxxxxx  pica02    xxx.xxx.xxx.xxx:xxxx [garage.picasoft.net]  picasoft_toulouse  1000.0 GB  XXXXXX GB (XXXX%)
 ```
+### Création des buckets
+Afin d'exposer notre cluster à [restic](technique:adminsys:backup:install_and_config), il faut d'abord créer un bucket et une clé associée à l'aide des commandes suivantes, tirées de la [doc garage](https://garagehq.deuxfleurs.fr/documentation/quick-start/#creating-buckets-and-keys):
+```
+garage bucket create picasoft-backups
+garage key create picasoft-backups-key
+garage bucket allow --read --write --owner picasoft-backups --key picasoft-backups-key
+```
+Ce qui nous donne les informations nécessaires pour se connecter au bucket.