pub-solar/infra
6
1
Fork 3
Code Issues 20 Pull requests 9 Actions Packages Projects 1 Releases Wiki Activity
infra/docs/garage.md
teutat3s 8f6a7ab05e
Some checks failed
Flake checks / Check (pull_request) Failing after 23s
Details
docs: more garage CLI usage, avoid leaking secret
2024-10-23 20:58:27 +02:00

2 KiB
Raw Blame History

Garage

How-To create a new bucket + keys

Requirements:

  • garage RPC credentials, in the shared keepass, search for 'garage rpc secret'.
  • Setup WireGuard for hosts: trinkgenossin, optionally: delite, blue-shell
ssh barkeeper@trinkgenossin.wg.pub.solar

Add a few spaces to avoid leaking the secret to the shell history

export GARAGE_RPC_SECRET=


Now, you can run the following command to check the cluster status:

garage status



Command to list all existing buckets:

garage bucket list


garage bucket create <bucket-name>
garage key create <bucket-name>-key
garage bucket allow <bucket-name> --read --write --key <bucket-name>-key

Full example for mastodon bucket:

garage bucket create mastodon

garage key create mastodon-key

garage bucket allow mastodon --read --write --key mastodon-key

Docs: https://garagehq.deuxfleurs.fr/documentation/quick-start/#creating-buckets-and-keys

Then setup your favourite S3 client or use the bucket with any S3 compatible software.

Notes on manual setup steps

ssh barkeeper@trinkgenossin.wg.pub.solar

export GARAGE_RPC_SECRET=<secret-in-keepass>

# Uses the default config /etc/garage.toml
garage node id

garage node connect <node-id2>
garage node connect <node-id3>

garage status

#Zones
#DE-1 DE-2 NL-1

garage layout assign fdaa -z DE-1 -c 800G -t trinkgenossin
garage layout assign 8835 -z DE-2 -c 800G -t blue-shell
garage layout assign 73da -z NL-1 -c 800G -t delite
garage layout show
garage layout apply --version 1

Source: https://garagehq.deuxfleurs.fr/documentation/cookbook/real-world/#creating-a-cluster-layout

Further reading: