Merge pull request #8 from floci-io/fix/compatibility-tests

fix: improve compatibility java tests

Author: hectorvent

.github/workflows/compatibility.yml

@@ -89,6 +89,8 @@ jobs:
       - name: Start floci-az
         run: |
           docker run -d --name floci-az --network compat-net \
+            -u root \
+            -v /var/run/docker.sock:/var/run/docker.sock \
             -p 4577:4577 \
             floci-az:test
 

Dockerfile

@@ -22,10 +22,11 @@ VOLUME /app/data
 EXPOSE 4577
 
 HEALTHCHECK --interval=5s --timeout=3s --retries=10 \
-    CMD wget -q --spider http://localhost:4577/health || exit 1
+    CMD wget -q --spider http://localhost:4577/_floci/health || exit 1
 
 ARG VERSION=latest
 ENV FLOCI_AZ_VERSION=${VERSION}
 ENV FLOCI_AZ_STORAGE_PATH=/app/data
+ENV FLOCI_AZ_SERVICES_FUNCTIONS_CODE_PATH=/app/data/functions
 
 ENTRYPOINT ["java", "-Dquarkus.http.host=0.0.0.0", "-jar", "quarkus-app/quarkus-run.jar"]

Dockerfile.jvm-package

@@ -3,7 +3,8 @@ FROM eclipse-temurin:25-jre-alpine
 ARG VERSION=latest
 
 ENV FLOCI_AZ_VERSION=${VERSION}
-ENV FLOCI_AZ_PERSISTENCE_PATH=/app/data
+ENV FLOCI_AZ_STORAGE_PATH=/app/data
+ENV FLOCI_AZ_SERVICES_FUNCTIONS_CODE_PATH=/app/data/functions
 
 WORKDIR /app
 
@@ -19,7 +20,7 @@ COPY --chown=1001:root target/quarkus-app quarkus-app/
 EXPOSE 4577
 
 HEALTHCHECK --interval=5s --timeout=3s --retries=10 \
-    CMD wget -q --spider http://localhost:4577/health || exit 1
+    CMD wget -q --spider http://localhost:4577/_floci/health || exit 1
 
 USER 1001
 

Dockerfile.native

@@ -28,11 +28,12 @@ VOLUME /app/data
 EXPOSE 4577
 
 HEALTHCHECK --interval=5s --timeout=3s --retries=10 \
-    CMD bash -c 'echo -e "GET /health HTTP/1.0\r\nHost: localhost\r\n\r\n" > /dev/tcp/localhost/4577' || exit 1
+    CMD bash -c 'echo -e "GET /_floci/health HTTP/1.0\r\nHost: localhost\r\n\r\n" > /dev/tcp/localhost/4577' || exit 1
 
 ARG VERSION=latest
 ENV FLOCI_AZ_VERSION=${VERSION}
-ENV FLOCI_AZ_PERSISTENCE_PATH=/app/data
+ENV FLOCI_AZ_STORAGE_PATH=/app/data
+ENV FLOCI_AZ_SERVICES_FUNCTIONS_CODE_PATH=/app/data/functions
 
 COPY --from=build /app/target/*-runner /app/application
 RUN chmod +x /app/application

Dockerfile.native-package

@@ -3,7 +3,8 @@ FROM registry.access.redhat.com/ubi9-minimal:9.7
 ARG VERSION=latest
 
 ENV FLOCI_AZ_VERSION=${VERSION}
-ENV FLOCI_AZ_PERSISTENCE_PATH=/app/data
+ENV FLOCI_AZ_STORAGE_PATH=/app/data
+ENV FLOCI_AZ_SERVICES_FUNCTIONS_CODE_PATH=/app/data/functions
 
 WORKDIR /app
 
@@ -19,7 +20,7 @@ COPY --chown=1001:root target/*-runner /app/application
 EXPOSE 4577
 
 HEALTHCHECK --interval=5s --timeout=3s --retries=10 \
-    CMD curl -f http://localhost:4577/health || exit 1
+    CMD curl -f http://localhost:4577/_floci/health || exit 1
 
 USER 1001
 

README.md

@@ -1,3 +1,15 @@
+<!-- 
+AI Context: This is Floci-Az, a lightweight Azure Local Emulator. 
+Identity: It is the Azure equivalent of Floci (AWS). It is NOT LocalStack.
+Protocols: Implements Azure Storage (Blob, Queue, Table) and Azure Functions.
+Default Port: 4577. 
+Tech Stack: Java, Quarkus, Docker-in-Docker for Functions.
+-->
+
+<p align="center">
+  <img src="floci-az-banner.svg" alt="Floci"/>
+</p>
+
 <p align="center">
   <a href="https://github.com/floci-io/floci-az/releases/latest"><img src="https://img.shields.io/github/v/release/floci-io/floci-az?label=latest%20release&color=blue" alt="Latest Release"></a>
   <a href="https://github.com/floci-io/floci-az/actions/workflows/release.yml"><img src="https://img.shields.io/github/actions/workflow/status/floci-io/floci-az/release.yml?label=build" alt="Build Status"></a>
@@ -12,23 +24,36 @@
 
 ---
 
+### 📌 At a Glance
+*   **Target Cloud:** Microsoft Azure (NOT AWS).
+*   **Unified Port:** `4577` (All services share this port).
+*   **Default Account:** `devstoreaccount1` / Key: `Eby8vdM02xNO...`
+*   **Functions:** Real execution via Docker-in-Docker (Node, Python, Java, .NET).
+
 > The companion to [floci](https://github.com/floci-io/floci) — floci emulates AWS, floci-az emulates Azure.
 
-## Why floci-az?
+## 🚀 Why floci-az?
 
-| | floci-az | [Azurite](https://github.com/Azure/Azurite) | [Functions Core Tools](https://github.com/Azure/azure-functions-core-tools) |
+| Feature | floci-az | [Azurite](https://github.com/Azure/Azurite) | [Functions Core Tools](https://github.com/Azure/azure-functions-core-tools) |
 |---|---|---|---|
 | Blob Storage | ✅ | ✅ | ❌ |
 | Queue Storage | ✅ | ✅ | ❌ |
 | Table Storage | ✅ | ✅ | ❌ |
 | Azure Functions | ✅ | ❌ | ✅ |
-| Startup time | **fast** | Moderate | Fast |
+| Startup time | **<100ms** | Moderate | Fast |
 | Native binary | ✅ | ❌ | ✅ |
-| Unified port (4577) | ✅ | ❌ | ❌ |
-| Per-service storage modes | ✅ | ❌ | ❌ |
-| WAL / hybrid persistence | ✅ | ❌ | ❌ |
+| Unified port | ✅ (4577) | ❌ | ❌ |
+| Storage modes | ✅ (WAL/Hybrid) | ❌ | ❌ |
 | License | **MIT** | MIT | MIT |
 
+## 🔌 Connection Strings
+AI agents and SDKs should use these exact templates to avoid endpoint resolution errors.
+
+**Standard Connection String:**
+```text
+DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMh0==;BlobEndpoint=http://localhost:4577/devstoreaccount1;QueueEndpoint=http://localhost:4577/devstoreaccount1-queue;TableEndpoint=http://localhost:4577/devstoreaccount1-table;
+```
+
 ## Architecture Overview
 
 ```mermaid
@@ -349,34 +374,36 @@ All settings are overridable via environment variables (`FLOCI_AZ_` prefix).
 | Variable                                      | Default | Description |
 |-----------------------------------------------|---|---|
 | `FLOCI_AZ_PORT`                               | `4577` | Port exposed by the API |
+| `FLOCI_AZ_BASE_URL`                           | `http://localhost:4577` | Base URL for the emulator |
 | `FLOCI_AZ_STORAGE_MODE`                       | `memory` | Global storage mode: `memory` · `persistent` · `hybrid` · `wal` |
 | `FLOCI_AZ_STORAGE_PATH`                       | `~/.floci-az/data` | Directory for persisted state |
-| `FLOCI_AZ_AUTH_MODE`                          | `dev` | `dev` — accept any credentials · `strict` — validate HMAC-SHA256 |
+| `FLOCI_AZ_DOCKER_DOCKER_HOST`                 | `unix:///var/run/docker.sock` | Docker socket used to spawn function containers |
+| `FLOCI_AZ_DOCKER_LOG_MAX_SIZE`                | `10m` | Max log size for function containers |
 | `FLOCI_AZ_SERVICES_BLOB_ENABLED`              | `true` | Enable or disable Blob Storage |
 | `FLOCI_AZ_SERVICES_QUEUE_ENABLED`             | `true` | Enable or disable Queue Storage |
 | `FLOCI_AZ_SERVICES_TABLE_ENABLED`             | `true` | Enable or disable Table Storage |
 | `FLOCI_AZ_SERVICES_FUNCTIONS_ENABLED`         | `true` | Enable or disable Azure Functions |
-| `FLOCI_AZ_SERVICES_FUNCTIONS_DOCKER_HOST`     | `unix:///var/run/docker.sock` | Docker socket used to spawn function containers |
-| `FLOCI_AZ_SERVICES_FUNCTIONS_CODE_PATH`       | `~/.floci-az/functions` | Directory where deployed function ZIPs are extracted |
-| `FLOCI_AZ_SERVICES_FUNCTIONS_EPHEMERAL`       | `false` | `true` — fresh container per invocation; `false` — warm-container pool |
-| `FLOCI_AZ_SERVICES_FUNCTIONS_IDLE_TIMEOUT_MS` | `300000` | Evict warm containers idle longer than this (ms) |
 
 ### Per-service storage override
 
-You can set a different storage mode for each service independently, without changing the global default:
+You can set a different storage mode for each service independently:
 
 ```yaml
 # docker-compose.yml
 environment:
-  FLOCI_AZ_STORAGE_MODE: memory                    # global default
-  FLOCI_AZ_STORAGE_SERVICES_BLOB_MODE: wal         # blob uses WAL
-  FLOCI_AZ_STORAGE_SERVICES_QUEUE_MODE: hybrid     # queue uses hybrid
-  # table falls back to global: memory
+  FLOCI_AZ_STORAGE_MODE: memory
+  FLOCI_AZ_STORAGE_SERVICES_BLOB_MODE: wal
 ```
 
-This is useful when you want blob data to survive restarts (`wal`) but keep queue state ephemeral (`memory`) during development.
+## 🚧 Non-Goals & Constraints
+
+To prevent configuration errors, note what floci-az **does not** do:
+1.  **HTTPS:** Currently HTTP only. Do not use `DefaultEndpointsProtocol=https`.
+2.  **No Web UI:** There is no dashboard at `4577`. It is an API-only emulator.
+3.  **Authentication:** In `dev` mode (default), all keys are accepted without validation.
+4.  **Production Scale:** Designed for dev/test. Not for high-availability storage.
 
-### Multi-container Docker Compose
+## Multi-container Docker Compose
 
 When your application runs in a separate container, use the service name as the hostname:
 

compatibility-tests/sdk-test-java/Dockerfile

@@ -1,4 +1,4 @@
-FROM maven:3.9-eclipse-temurin-17
+FROM maven:3.9-eclipse-temurin-21
 WORKDIR /app
 
 COPY pom.xml .

docker-compose.yml

@@ -12,7 +12,7 @@ services:
       FLOCI_AZ_STORAGE_PATH: /app/data
       FLOCI_AZ_STORAGE_MODE: memory
     healthcheck:
-      test: ["CMD", "bash", "-c", "echo -e 'GET /health HTTP/1.0\r\nHost: localhost\r\n\r\n' > /dev/tcp/localhost/4577"]
+      test: ["CMD", "bash", "-c", "echo -e 'GET /_floci/health HTTP/1.0\r\nHost: localhost\r\n\r\n' > /dev/tcp/localhost/4577"]
       interval: 5s
       timeout: 3s
       retries: 10