Repository Map
A map of every Marqo service repo aggregated into this hub: what it is, where its docs live, and how to dig in. Built for humans and agents trying to figure out what is what and how to change things.
| Repo | What it is | Docs | Runbooks |
|---|---|---|---|
| Actions | Shared, reusable GitHub Actions workflows (lint, Claude review, SonarQube, Compass metrics). | docs | — |
| Cloud Control Plane | Control plane: admin/ecom APIs, agentic search, Shopify integrations, settings. The most heavily documented service (runbooks, design, dev guides). | docs | 85 |
| Cloud Control Plane Cdk | CDK/IaC for deploying control-plane cells (AWS/GCP), backup orchestration and key-sync lambdas. | docs | — |
| Cloud Data Plane | Data plane: multitenant EKS, index workflows, autoscaling, Cloudflare ingest. Home of most infra/ops runbooks. | docs | 28 |
| Cloud Integration Tests | Cross-service integration + billing test suites run against staging/prod. | docs | — |
| Escalator | Self-service tool for temporary admin access to production AWS accounts. | docs | — |
| Marqo | The open-source Marqo engine (deprecated public repo). Curated subset of internal/dev docs only. | docs | — |
| Polo | AWS cost-observability service (ClickHouse + collectors + Cloudflare Worker SPA). Architecture, features and ops runbooks. | docs | 6 |
| Py Marqo | Official Python client for Marqo. Contributing + test-harness docs. | docs | — |
| Reindexing Pipeline | Serverless pipeline (Lambdas + K8s job) that reindexes/replays documents into Vespa via the ecommerce API. | docs | — |
| Terraform Provider Marqo | OpenTofu/Terraform provider for managing Marqo Cloud indexes. | docs | — |
Find things by intent
- Something is broken / on-call: start with the cross-repo Runbooks.
- Understand a system: see Architecture & Design.
- Build / change / test a service: see Development & Tooling.
This page is generated by scripts/build_docusaurus_docs.py.