docker-compose.yml

# =============================================================================
# TelemetryFlow PHP SDK - Docker Compose
# =============================================================================
#
# TelemetryFlow PHP SDK - AI-Powered Observability & Incident Response Management (IRM) Platform
# Copyright (c) 2024-2026 Telemetri Data Indonesia. All rights reserved.
#
# PROFILES:
# - dev:       Development environment (sdk-dev, otel-collector)
# - full:      Full observability stack (+ Prometheus)
# - example:   SDK example runners (basic, http-server)
#
# Usage:
#   # Build the SDK image
#   docker-compose build
#
#   # Run the SDK generator (init command)
#   docker-compose run --rm sdk-gen init --project myapp --service my-service --output /workspace
#
#   # Generate an example application
#   docker-compose run --rm sdk-gen example basic --output /workspace/example
#
#   # Start development environment with the OTLP collector
#   docker-compose --profile dev up -d otel-collector
#
#   # Start full observability stack (+ Prometheus)
#   docker-compose --profile full up -d
#
#   # Run SDK examples against the collector
#   docker-compose --profile example up
#
# =============================================================================
# OTLP Endpoints
# =============================================================================
#
#   HTTP (v1 standard):
#     POST http://localhost:4318/v1/traces
#     POST http://localhost:4318/v1/metrics
#     POST http://localhost:4318/v1/logs
#
#   gRPC: localhost:4317
#
# =============================================================================

#================================================================================================
# NETWORK SETUP
#================================================================================================
networks:
  telemetryflow_sdk_net:
    name: telemetryflow_php_sdk_net
    driver: bridge
    ipam:
      config:
        - subnet: 172.162.0.0/16

#================================================================================================
# SERVICES
#================================================================================================
services:

  #==============================================================================================
  # SDK SERVICES
  #==============================================================================================

  #----------------------------------------------------------------------------------------------
  # SDK Generator (telemetryflow-gen CLI)
  #----------------------------------------------------------------------------------------------
  sdk-gen:
    container_name: ${CONTAINER_NAME:-telemetryflow_php_sdk_gen}
    image: ${IMAGE_NAME:-telemetryflow/telemetryflow-php-sdk}:${IMAGE_TAG:-1.0.0}
    build:
      context: .
      dockerfile: Dockerfile
      args:
        VERSION: ${VERSION:-1.0.0}
        GIT_COMMIT: ${GIT_COMMIT:-unknown}
        GIT_BRANCH: ${GIT_BRANCH:-main}
        BUILD_TIME: ${BUILD_TIME:-unknown}
    entrypoint: ["/usr/local/bin/telemetryflow-gen"]
    command: ["--help"]
    volumes:
      - ./workspace:/workspace
    working_dir: /workspace
    networks:
      - telemetryflow_sdk_net

  #----------------------------------------------------------------------------------------------
  # SDK Development Container (full tooling + live source mount)
  #----------------------------------------------------------------------------------------------
  sdk-dev:
    container_name: ${CONTAINER_NAME_DEV:-telemetryflow_php_sdk_dev}
    image: ${IMAGE_NAME:-telemetryflow/telemetryflow-php-sdk}:${IMAGE_TAG:-1.0.0}-dev
    build:
      context: .
      dockerfile: Dockerfile.dev
      args:
        VERSION: ${VERSION:-1.0.0}
    entrypoint: ["sh", "-c"]
    command: ["echo 'TelemetryFlow PHP SDK dev container ready. Run: telemetryflow-gen --help' && sleep infinity"]
    environment:
      - TELEMETRYFLOW_API_KEY_ID=${TELEMETRYFLOW_API_KEY_ID:-tfk_example}
      - TELEMETRYFLOW_API_KEY_SECRET=${TELEMETRYFLOW_API_KEY_SECRET:-tfs_example}
      - TELEMETRYFLOW_ENDPOINT=${TELEMETRYFLOW_ENDPOINT:-otel-collector:4317}
      - TELEMETRYFLOW_SERVICE_NAME=${TELEMETRYFLOW_SERVICE_NAME:-telemetryflow-php-sdk}
      - TELEMETRYFLOW_SERVICE_VERSION=${TELEMETRYFLOW_SERVICE_VERSION:-1.0.0}
      - TELEMETRYFLOW_ENVIRONMENT=${TELEMETRYFLOW_ENVIRONMENT:-development}
      - TELEMETRYFLOW_INSECURE=${TELEMETRYFLOW_INSECURE:-true}
      - XDEBUG_MODE=${XDEBUG_MODE:-off}
    volumes:
      - .:/app
      - ./workspace:/workspace
    working_dir: /app
    depends_on:
      otel-collector:
        condition: service_healthy
    networks:
      telemetryflow_sdk_net:
        ipv4_address: ${CONTAINER_IP_SDK_DEV:-172.162.152.11}
    profiles:
      - dev

  #==============================================================================================
  # MONITORING SERVICES
  #==============================================================================================

  #----------------------------------------------------------------------------------------------
  # OTEL COLLECTOR (OpenTelemetry Collector Contrib)
  # Receives OTLP telemetry from the SDK and exports to debug + Prometheus.
  #----------------------------------------------------------------------------------------------
  otel-collector:
    profiles: ["dev", "full", "example"]
    image: otel/opentelemetry-collector-contrib:${OTEL_VERSION:-0.108.0}
    container_name: ${CONTAINER_OTEL:-telemetryflow_php_sdk_collector}
    restart: unless-stopped
    command: ["--config=/etc/otelcol-contrib/config.yaml"]
    volumes:
      - ./configs/otel-collector.yaml:/etc/otelcol-contrib/config.yaml:ro
    ports:
      - "${PORT_OTEL_GRPC:-4317}:4317"      # OTLP gRPC
      - "${PORT_OTEL_HTTP:-4318}:4318"      # OTLP HTTP
      - "${PORT_OTEL_METRICS:-8889}:8889"   # Prometheus exporter
      - "${PORT_OTEL_HEALTH:-13133}:13133"  # Health check
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost:13133"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 10s
    networks:
      telemetryflow_sdk_net:
        ipv4_address: ${CONTAINER_IP_OTEL:-172.162.152.30}

  #----------------------------------------------------------------------------------------------
  # PROMETHEUS (metrics visualization)
  #----------------------------------------------------------------------------------------------
  prometheus:
    profiles: ["full"]
    image: prom/prometheus:${PROMETHEUS_VERSION:-v2.54.1}
    container_name: ${CONTAINER_PROMETHEUS:-telemetryflow_php_sdk_prometheus}
    restart: unless-stopped
    volumes:
      - ./configs/prometheus.yaml:/etc/prometheus/prometheus.yml:ro
      - prometheus-data:/prometheus
    ports:
      - "${PORT_PROMETHEUS:-9090}:9090"
    depends_on:
      otel-collector:
        condition: service_healthy
    networks:
      telemetryflow_sdk_net:
        ipv4_address: ${CONTAINER_IP_PROMETHEUS:-172.162.152.70}

  #==============================================================================================
  # EXAMPLE RUNNERS
  #==============================================================================================

  #----------------------------------------------------------------------------------------------
  # Basic Example
  #----------------------------------------------------------------------------------------------
  example-basic:
    profiles: ["example"]
    image: ${IMAGE_NAME:-telemetryflow/telemetryflow-php-sdk}:${IMAGE_TAG:-1.0.0}-dev
    build:
      context: .
      dockerfile: Dockerfile.dev
    entrypoint: ["php", "/app/examples/basic/main.php"]
    environment:
      - TELEMETRYFLOW_API_KEY_ID=${TELEMETRYFLOW_API_KEY_ID:-tfk_example}
      - TELEMETRYFLOW_API_KEY_SECRET=${TELEMETRYFLOW_API_KEY_SECRET:-tfs_example}
      - TELEMETRYFLOW_ENDPOINT=${TELEMETRYFLOW_ENDPOINT:-otel-collector:4317}
      - TELEMETRYFLOW_SERVICE_NAME=${TELEMETRYFLOW_SERVICE_NAME:-php-basic-example}
      - TELEMETRYFLOW_INSECURE=true
      - TELEMETRYFLOW_PROTOCOL=grpc
    depends_on:
      otel-collector:
        condition: service_healthy
    networks:
      - telemetryflow_sdk_net

  #----------------------------------------------------------------------------------------------
  # HTTP Server Example
  #----------------------------------------------------------------------------------------------
  example-http-server:
    profiles: ["example"]
    image: ${IMAGE_NAME:-telemetryflow/telemetryflow-php-sdk}:${IMAGE_TAG:-1.0.0}-dev
    build:
      context: .
      dockerfile: Dockerfile.dev
    entrypoint: ["php", "-S", "0.0.0.0:8080", "/app/examples/http-server/main.php"]
    environment:
      - TELEMETRYFLOW_API_KEY_ID=${TELEMETRYFLOW_API_KEY_ID:-tfk_example}
      - TELEMETRYFLOW_API_KEY_SECRET=${TELEMETRYFLOW_API_KEY_SECRET:-tfs_example}
      - TELEMETRYFLOW_ENDPOINT=${TELEMETRYFLOW_ENDPOINT:-otel-collector:4317}
      - TELEMETRYFLOW_SERVICE_NAME=${TELEMETRYFLOW_SERVICE_NAME:-php-http-example}
      - TELEMETRYFLOW_INSECURE=true
      - TELEMETRYFLOW_PROTOCOL=grpc
    ports:
      - "${APP_PORT:-8080}:8080"
    depends_on:
      otel-collector:
        condition: service_healthy
    networks:
      - telemetryflow_sdk_net

#================================================================================================
# VOLUMES
#================================================================================================
volumes:
  prometheus-data:
    driver: local