Skip to content

Hetzner Object Storage (geführt) ​

Ein privater Bucket für Platform-Asset-Store (customers/) und Generator-Handoff (generator/). Siehe Spatial Production Contract.

1. S3-Credentials ​

  1. Hetzner Console → Projekt öffnen
  2. Linkes Menü: Security
  3. Oben: S3 Credentials → Generate credentials
  4. Beschreibung z. B. raumgrid-prod
  5. Access Key + Secret Key sofort speichern (Secret ist danach nicht mehr sichtbar)

Ein Credential-Paar für Platform und Generator reicht. Isolation über Prefixes.

2. Bucket anlegen ​

  1. Linkes Menü: Object Storage → Create Bucket
  2. Location: dieselbe Region wie der App-Server (fsn1 / nbg1 / hel1)
  3. Name: global eindeutig, z. B. raumgrid-prod
  4. Visibility: private (Pflicht)
  5. Create & Buy now

3. Endpoint / Region ​

LocationEndpointAWS_DEFAULT_REGION
Falkensteinhttps://fsn1.your-objectstorage.comfsn1
Nuremberghttps://nbg1.your-objectstorage.comnbg1
Helsinkihttps://hel1.your-objectstorage.comhel1

Notieren: Bucket-Name, Location, Endpoint, Access Key, Secret Key.

4. Smoke-Test ​

Mit AWS CLI (Beispiel fsn1 / Bucket raumgrid-prod):

bash
export AWS_ACCESS_KEY_ID=…
export AWS_SECRET_ACCESS_KEY=…
aws s3 ls s3://raumgrid-prod/ \
  --endpoint-url https://fsn1.your-objectstorage.com \
  --region fsn1
echo ok | aws s3 cp - s3://raumgrid-prod/generator/_smoke.txt \
  --endpoint-url https://fsn1.your-objectstorage.com \
  --region fsn1

Erst danach Env in Platform/Generator setzen (siehe docker/.env.production.example und Contract).

Prefixes ​

PrefixNutzung
customers/{slug}/…Platform Asset-Store (Web-Auslieferung)
generator/jobs/{jobId}/splat.plyGenerator → Platform Handoff