chore: stop tracking storage/, moved out as standalone garage deployment
Garage storage is now managed independently at ../dochub-storage, decoupled from this repo to avoid confusion with the app stack.
This commit is contained in:
parent
360e9e5a14
commit
d2d046802b
@ -1,36 +0,0 @@
|
||||
# DocHub Storage (Garage)
|
||||
|
||||
S3-compatible object storage for DocHub, deployed independently from the
|
||||
app stack in `docker-compose.yml` at the repo root, using
|
||||
[Garage](https://garagehq.deuxfleurs.fr/) — a fully open source (AGPL)
|
||||
object store purpose-built for self-hosting. `backend/app/garage_client.py`
|
||||
talks to it over the standard S3 API via `boto3`.
|
||||
|
||||
Single-node setup, matching this project's learning/small-team scope
|
||||
(`replication_factor = 1` in `garage.toml` — no data redundancy across
|
||||
nodes, since there's only one node).
|
||||
|
||||
## First-time setup
|
||||
|
||||
```bash
|
||||
cd storage
|
||||
docker compose up -d
|
||||
./init-garage.sh
|
||||
docker compose exec garage /garage key info dochub-backend
|
||||
```
|
||||
|
||||
The last command prints an access key ID and secret key. Set those as
|
||||
`GARAGE_ACCESS_KEY` / `GARAGE_SECRET_KEY` for the DocHub backend.
|
||||
|
||||
## Connecting the backend
|
||||
|
||||
From the repo root, when running `docker compose up` there:
|
||||
|
||||
```bash
|
||||
GARAGE_ENDPOINT=<this-server-ip>:3900 \
|
||||
GARAGE_ACCESS_KEY=<from init-garage.sh> \
|
||||
GARAGE_SECRET_KEY=<from init-garage.sh> \
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
Garage's S3 API listens on port `3900`.
|
||||
@ -1,13 +0,0 @@
|
||||
services:
|
||||
garage:
|
||||
image: dxflrs/garage:v1.0.1
|
||||
network_mode: host
|
||||
volumes:
|
||||
- ./garage.toml:/etc/garage.toml:ro
|
||||
- garage-meta:/var/lib/garage/meta
|
||||
- garage-data:/var/lib/garage/data
|
||||
restart: unless-stopped
|
||||
|
||||
volumes:
|
||||
garage-meta:
|
||||
garage-data:
|
||||
@ -1,23 +0,0 @@
|
||||
metadata_dir = "/var/lib/garage/meta"
|
||||
data_dir = "/var/lib/garage/data"
|
||||
db_engine = "sqlite"
|
||||
|
||||
replication_factor = 1
|
||||
|
||||
rpc_bind_addr = "[::]:3901"
|
||||
rpc_public_addr = "127.0.0.1:3901"
|
||||
rpc_secret = "62b86336239b3fd482f05e0caed739198a9601917cb1f80a7d8d429775be9e5c"
|
||||
|
||||
[s3_api]
|
||||
s3_region = "garage"
|
||||
api_bind_addr = "[::]:3900"
|
||||
root_domain = ".s3.garage.localhost"
|
||||
|
||||
[s3_web]
|
||||
bind_addr = "[::]:3902"
|
||||
root_domain = ".web.garage.localhost"
|
||||
index = "index.html"
|
||||
|
||||
[admin]
|
||||
api_bind_addr = "[::]:3903"
|
||||
admin_token = "fad952cc1c31f6e53b63b24d9dbbae75809906cfa61a933a91545e6130e32a31"
|
||||
@ -1,35 +0,0 @@
|
||||
#!/usr/bin/env bash
|
||||
# One-time Garage initialization: assigns this single node to the cluster
|
||||
# layout, then creates the DocHub bucket and an access key for the backend.
|
||||
#
|
||||
# Run this once after `docker compose up -d` in this directory.
|
||||
set -euo pipefail
|
||||
|
||||
GARAGE="docker compose exec garage /garage"
|
||||
|
||||
echo "Waiting for garage to be ready..."
|
||||
until $GARAGE status >/dev/null 2>&1; do
|
||||
sleep 1
|
||||
done
|
||||
|
||||
NODE_ID=$($GARAGE status | awk '/NODE ID/{found=1; next} found && NF {print $1; exit}')
|
||||
if [ -z "$NODE_ID" ]; then
|
||||
echo "Could not determine node ID from 'garage status' output." >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "Assigning layout to node $NODE_ID (single node, capacity 10G)..."
|
||||
$GARAGE layout assign -z dochub -c 10G "$NODE_ID"
|
||||
$GARAGE layout apply --version 1
|
||||
|
||||
echo "Creating bucket 'dochub'..."
|
||||
$GARAGE bucket create dochub
|
||||
|
||||
echo "Creating access key 'dochub-backend'..."
|
||||
$GARAGE key create dochub-backend
|
||||
$GARAGE bucket allow --read --write --owner dochub --key dochub-backend
|
||||
|
||||
echo
|
||||
echo "Done. Run 'docker compose exec garage /garage key info dochub-backend'"
|
||||
echo "to retrieve the access key ID and secret key, then set them as"
|
||||
echo "MINIO_ACCESS_KEY / MINIO_SECRET_KEY for the DocHub backend."
|
||||
Loading…
Reference in New Issue
Block a user