compose.storage-s3.yml

# STUB — the storage scale-out path (not wired up; see ADR 0001).
#
# When local volumes stop fitting, Loki and Tempo move their object storage
# to any S3-compatible backend (Cloudflare R2, Backblaze B2, Hetzner, MinIO)
# without touching the collector, Prometheus, or any client project.
#
# This is deliberately a commented stub: it documents the concrete shape of
# the change so the README's scale-out claim is real, but it is not meant to
# be started until credentials and a bucket exist. To activate:
#
#   1. Create s3 variants of the configs, e.g. config/loki.s3.yaml replacing
#      `common.storage.filesystem` with:
#
#        common:
#          storage:
#            s3:
#              endpoint: ${S3_ENDPOINT}        # e.g. <account>.r2.cloudflarestorage.com
#              bucketnames: cml-loki
#              access_key_id: ${S3_ACCESS_KEY_ID}
#              secret_access_key: ${S3_SECRET_ACCESS_KEY}
#              s3forcepathstyle: true
#
#      and config/tempo.s3.yaml replacing `storage.trace.backend: local` with:
#
#        storage:
#          trace:
#            backend: s3
#            s3:
#              endpoint: ${S3_ENDPOINT}
#              bucket: cml-tempo
#              access_key: ${S3_ACCESS_KEY_ID}
#              secret_key: ${S3_SECRET_ACCESS_KEY}
#
#   2. Uncomment the overlay below and run:
#        docker compose -f compose.yml -f compose.storage-s3.yml up -d
#
# services:
#   loki:
#     volumes:
#       - ./config/loki.s3.yaml:/etc/loki/loki.yaml:ro
#       - loki_data:/loki
#     environment:
#       S3_ENDPOINT: ${S3_ENDPOINT:?set S3_ENDPOINT in .env}
#       S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:?set S3_ACCESS_KEY_ID in .env}
#       S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:?set S3_SECRET_ACCESS_KEY in .env}
#
#   tempo:
#     volumes:
#       - ./config/tempo.s3.yaml:/etc/tempo/tempo.yaml:ro
#       - tempo_data:/var/tempo
#     environment:
#       S3_ENDPOINT: ${S3_ENDPOINT:?set S3_ENDPOINT in .env}
#       S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:?set S3_ACCESS_KEY_ID in .env}
#       S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:?set S3_SECRET_ACCESS_KEY in .env}