# RFS S3 (Garage) configuration for flist storage and HTTP read endpoint # Copy this file to config/rfs.conf and fill in real values (do not commit secrets). # S3 API endpoint of your Garage server, including scheme and optional port # Examples: # https://hub.grid.tf # http://minio:9000 S3_ENDPOINT="https://hub.grid.tf" # AWS region string expected by the S3-compatible API S3_REGION="us-east-1" # Bucket and key prefix used for RFS store (content-addressed blobs) # The RFS store path will be: s3://...// S3_BUCKET="zos" S3_PREFIX="zosbuilder/store" # Access credentials (required by rfs pack to push blobs) S3_ACCESS_KEY="REPLACE_ME" S3_SECRET_KEY="REPLACE_ME" # Optional: HTTP(S) web endpoint used at runtime to fetch blobs without signed S3 # This is the base URL that serves the same objects as the S3 store, typically a # public or authenticated gateway in front of Garage that allows read access. # The scripts will patch the .fl (sqlite) stores table to use this endpoint. # Ensure this path maps to the same content-addressed layout expected by rfs. # Example: # https://hub.grid.tf/zos/zosbuilder/store WEB_ENDPOINT="https://hub.grid.tf/zos/zosbuilder/store" # Optional: where to upload the .fl manifest sqlite file (separate from blob store) # If you want to keep manifests alongside blobs, a common pattern is: # s3:////manifests/ # Scripts will create manifests/ under S3_PREFIX automatically if left default. MANIFESTS_SUBPATH="manifests" # Behavior flags (can be overridden by CLI flags or env) # Whether to keep s3:// store as a fallback entry in the .fl after adding WEB_ENDPOINT KEEP_S3_FALLBACK="false" # Whether to attempt uploading .fl manifests to S3 (requires MinIO Client: mc) UPLOAD_MANIFESTS="false" # Read-only credentials for route URL in manifest (optional; defaults to write keys above) # These will be embedded into the flist 'route.url' so runtime mounts can read directly from Garage. # If not set, scripts fall back to S3_ACCESS_KEY/S3_SECRET_KEY. READ_ACCESS_KEY="REPLACE_ME_READ" READ_SECRET_KEY="REPLACE_ME_READ" # Route endpoint and parameters for flist route URL patching # - ROUTE_ENDPOINT: host:port base for Garage gateway (scheme is ignored; host:port is extracted) # If not set, defaults to S3_ENDPOINT # - ROUTE_PATH: path to the blob route (default: /blobs) # - ROUTE_REGION: region string for Garage (default: garage) ROUTE_ENDPOINT="https://hub.grid.tf" ROUTE_PATH="/blobs" ROUTE_REGION="garage"