added repo

2026-08-26 04:03:34 +05:30
parent 2389ec1fd6
commit 1055e1394f
150 changed files with 12395 additions and 0 deletions
@@ -1,2 +1,59 @@
 # devops-infra-argo-config

+GitOps control plane for infrastructure tooling across Meesho's Kubernetes fleet.
+
+This repo manages ArgoCD `Application` resources for every infrastructure tool (Contour, VictoriaMetrics, Grafana, Kyverno, KEDA, external-secrets, Vault, etc.) deployed across ~19 clusters. It uses an **App-of-Applications** pattern: one parent Application per cluster renders child Applications from a `appSpec[]` list via a generic Helm chart.
+
+Each environment tracks a dedicated branch — merging to that branch triggers immediate ArgoCD auto-sync with no staging gate:
+
+| Environment | Branch |
+| ----------- | ------ |
+| Production (prd) | `main` |
+| Staging (stg) | `develop` |
+| Integration (int) | `pre-prod` |
+
+## How it works
+
+```text
+incubator/<env>/<cluster>.yaml          ← Parent Application (one per cluster)
+    └── points at generic-argo-apps-chart/ + values/<env>/<cluster>-values.yaml
+            └── renders one child Application per appSpec[] entry
+                    └── sources charts + overrides from devops-infra-helm-charts
+```
+
+## Directory structure
+
+| Directory | Purpose |
+| --------- | ------- |
+| `incubator/<env>/` | Parent ArgoCD Application YAML, one per cluster |
+| `values/<env>/` | Values files defining which tools deploy per cluster |
+| `generic-argo-apps-chart/` | Helm chart that renders child Applications from `appSpec[]` |
+| `projects/` | ArgoCD `AppProject` definitions (`sre`, `sec`) |
+| `external-name-service-*/` | Cross-cluster DNS routing (ExternalName / MCS topology) |
+| `docs/` | Agent-facing operational documentation |
+| `skills/` | Parameterized agent tasks for common operations |
+| `wiki/` | Architecture decisions and entity pages |
+
+## Getting started
+
+- **Agents:** Read [CLAUDE.md](CLAUDE.md) first.
+- **New team members:** Read [index.md](index.md) for full navigation.
+- **PR reviewers:** Check [docs/global/coding-guidelines/infra-argo.md](docs/global/coding-guidelines/infra-argo.md).
+
+## Common operations
+
+| Task | Procedure |
+| ---- | --------- |
+| Add a tool to a cluster | [docs/platform/procedures/add-tool-to-cluster.md](docs/platform/procedures/add-tool-to-cluster.md) |
+| Upgrade a chart version | [docs/platform/procedures/upgrade-chart-version.md](docs/platform/procedures/upgrade-chart-version.md) |
+| Onboard a new cluster | [docs/platform/procedures/add-new-cluster.md](docs/platform/procedures/add-new-cluster.md) |
+| Roll out a tool fleet-wide | [docs/platform/procedures/fleet-wide-tool-rollout.md](docs/platform/procedures/fleet-wide-tool-rollout.md) |
+| Debug sync failure | [docs/platform/runbooks/argocd-sync-failure.md](docs/platform/runbooks/argocd-sync-failure.md) |
+| Debug Helm render error | [docs/platform/runbooks/render-failure.md](docs/platform/runbooks/render-failure.md) |
+| Find values inconsistencies across clusters | [docs/platform/runbooks/values-drift.md](docs/platform/runbooks/values-drift.md) |
+| Debug stuck deployment | [docs/platform/runbooks/deployment-stuck.md](docs/platform/runbooks/deployment-stuck.md) |
+
+## Sister repos
+
+- [`devops-infra-helm-charts`](https://github.com/Meesho/devops-infra-helm-charts) — Helm charts and `custom-values.yaml` overrides. Every `appSpec[].chartDir` and `valuesDir` must exist here.
+- [`devops-argo-config`](https://github.com/Meesho/devops-argo-config) — Same pattern for service/application workloads (not infra tooling).