Build 3001262204: add gravitee stack

gravitee/README.md

@@ -0,0 +1,32 @@
+# Gravitee APIM (optional)
+
+This folder is used by the optional Gravitee APIM stack defined in `docker-compose.gravitee.yml`.
+The services will create their own data directories under `gravitee/` when started.
+
+## Start Gravitee with Magent
+
+Run Magent and Gravitee together:
+
+```bash
+docker compose -f docker-compose.yml -f docker-compose.gravitee.yml up -d
+```
+
+Gravitee services:
+
+- Gateway: http://localhost:8082
+- Management API: http://localhost:8083
+- Management UI: http://localhost:8084
+- Developer portal: http://localhost:8085
+
+Default credentials for the Management UI are typically `admin / admin` on first boot.
+Change the password on first login.
+
+## Create a Magent API in Gravitee
+
+1) Open the Management UI at http://localhost:8084.
+2) Create a new API (v4 or v2).
+3) Set the backend endpoint to `http://magent:8000`.
+4) Add a path mapping for `/api` if you want the gateway to front the Magent API.
+5) Deploy the API.
+
+Once deployed, route requests through `http://localhost:8082`.