refactor: reorganize examples and add docker-compose setups

- Move k8s/ to examples/kubernetes/ with sidecar/ and daemonset/ subdirs
- Add docker-compose examples for both plugins with MinIO integration
- Add build-docker.sh script for cross-platform Docker builds
- Update out_clp_s3_v2 README with comprehensive documentation
- Update plugin-config.conf with cleaner defaults

Author: jackluo923

plugins/out_clp_s3/examples/docker-compose/README.md

@@ -0,0 +1,59 @@
+# Docker Compose Example
+
+Local development setup with MinIO (S3-compatible storage) for testing the out_clp_s3 plugin.
+
+> **See also:** [Plugin README](../../README.md) for configuration options |
+> [Main README](../../../../README.md) for project overview
+
+## Quick Start
+
+```shell
+docker compose up
+```
+
+This starts:
+- **MinIO** - S3-compatible storage
+- **Fluent Bit** - with the CLP plugin configured
+- **Log generator** - produces sample log lines
+
+## Services
+
+| Service | URL | Credentials |
+|---------|-----|-------------|
+| MinIO Console | http://localhost:9001 | minioadmin / minioadmin |
+| MinIO API | http://localhost:9000 | - |
+
+## Verify Logs
+
+Logs are uploaded when the buffer reaches `upload_size_mb` (default: 16 MB). To see uploads sooner,
+generate more logs or lower the threshold in `fluent-bit.conf`.
+
+```shell
+# Check uploaded files
+docker compose exec minio mc ls local/logs/ --recursive
+
+# Or open MinIO Console
+open http://localhost:9001
+```
+
+## Configuration
+
+Edit `fluent-bit.conf` to customize:
+- Input paths and parsers
+- Upload size threshold (`upload_size_mb`)
+- Output bucket and prefix
+
+See [plugin documentation](../../README.md) for all options.
+
+## Cleanup
+
+```shell
+docker compose down -v
+```
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `docker-compose.yaml` | Service definitions |
+| `fluent-bit.conf` | Fluent Bit configuration |

plugins/out_clp_s3/examples/docker-compose/docker-compose.yaml

@@ -0,0 +1,79 @@
+# Docker Compose for local development and testing
+# Usage: docker compose up
+#
+# Services:
+#   - minio: S3-compatible storage (console at http://localhost:9001)
+#   - fluent-bit: Log collector with CLP plugin
+#   - log-generator: Generates sample logs for testing
+
+services:
+  minio:
+    image: minio/minio:latest
+    command: server /data --console-address ":9001"
+    ports:
+      - "9000:9000"   # S3 API
+      - "9001:9001"   # Console
+    environment:
+      MINIO_ROOT_USER: minioadmin
+      MINIO_ROOT_PASSWORD: minioadmin
+    volumes:
+      - minio-data:/data
+    healthcheck:
+      test: ["CMD", "mc", "ready", "local"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  minio-setup:
+    image: minio/mc:latest
+    depends_on:
+      minio:
+        condition: service_healthy
+    entrypoint: >
+      /bin/sh -c "
+      mc alias set local http://minio:9000 minioadmin minioadmin;
+      mc mb local/logs --ignore-existing;
+      mc anonymous set download local/logs;
+      echo 'Bucket created and configured';
+      "
+
+  fluent-bit:
+    # Pre-built image (uncomment when available):
+    # image: ghcr.io/y-scope/fluent-bit-clp-s3:latest
+    # Build locally:
+    build:
+      context: ../../../..
+      dockerfile: plugins/out_clp_s3/Dockerfile
+    depends_on:
+      minio-setup:
+        condition: service_completed_successfully
+    environment:
+      AWS_REGION: us-east-1
+      AWS_ENDPOINT_URL: http://minio:9000
+      AWS_ACCESS_KEY_ID: minioadmin
+      AWS_SECRET_ACCESS_KEY: minioadmin
+    volumes:
+      - ./fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf:ro
+      - logs:/logs:ro
+    restart: unless-stopped
+
+  # Generates sample logs for testing
+  log-generator:
+    image: alpine:latest
+    volumes:
+      - logs:/logs
+    entrypoint: >
+      /bin/sh -c "
+      mkdir -p /logs;
+      echo 'Starting log generator...';
+      i=0;
+      while true; do
+        echo \"$$(date -u +%Y-%m-%dT%H:%M:%SZ) INFO Log message $$i from container\" >> /logs/app.log;
+        i=$$((i + 1));
+        sleep 0.1;
+      done
+      "
+
+volumes:
+  minio-data:
+  logs:

plugins/out_clp_s3/examples/docker-compose/fluent-bit.conf

@@ -0,0 +1,24 @@
+# Fluent Bit configuration for Docker Compose
+# Watches /logs directory and uploads to MinIO
+
+[SERVICE]
+    flush        1
+    daemon       off
+    log_level    info
+    plugins_file /fluent-bit/etc/plugin-config.conf
+
+[INPUT]
+    name         tail
+    path         /logs/*.log
+    tag          app
+    refresh_interval 5
+    read_from_head true
+
+[OUTPUT]
+    name              out_clp_s3
+    match             *
+    s3_bucket         logs
+    s3_region         us-east-1
+    s3_bucket_prefix  app/
+    upload_size_mb    16
+    use_disk_buffer   true

plugins/out_clp_s3/plugin-config.conf

@@ -1,4 +1,3 @@
 # Plugin configuration referenced in Fluent Bit configuration
 [PLUGINS]
-    path /fluent-bit/bin/out_clp_s3.so
-    #path ./out_clp_s3.so
+    path /fluent-bit/lib/out_clp_s3.so