# ayosal/argocd-hybrid architecture

> Architecture diagram of the GitHub repository ayosal/argocd-hybrid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayosal/argocd-hybrid
- Repository: https://github.com/ayosal/argocd-hybrid

## Overview

This repository is a GitOps deployment configuration for Apigee hybrid on GKE, using ArgoCD’s App-of-Apps pattern. The documented workflow is to prepare the Apigee organization and cluster, install prerequisites such as CRDs and secrets, then have a root ArgoCD application manage child applications that deploy the Apigee Helm charts and supporting services. The chart directories capture major runtime capabilities; the README describes their roles but no source excerpts were provided, so relationships beyond those documented are omitted.

Main entry points: [`apps/templates`](https://github.com/ayosal/argocd-hybrid/tree/main/apps/templates) (Child app definitions), [`apps.yaml`](https://github.com/ayosal/argocd-hybrid/blob/main/apps.yaml) (Root application), [`apps/templates/operator.yaml`](https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/operator.yaml) (Operator app template), [`apps/apigee-charts`](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts) (Helm chart sources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Cluster setup"]
  node_gke["GKE cluster"]
  node_apigeecloud["Apigee organization"]
end

subgraph group_gitops["ArgoCD orchestration"]
  node_childdefs["Child app definitions"]
  node_chartrepo["Helm chart sources"]
  node_rootapp["Root application<br/>[apps.yaml]"]
  node_operatorapp["Operator app template<br/>[operator.yaml]"]
end

subgraph group_apigee["Apigee components"]
  node_operator["Apigee operator"]
  node_crds["Apigee CRDs"]
  node_datastore[("Datastore")]
  node_environment["Environment"]
  node_ingress["Ingress manager"]
  node_organization["Organization"]
  node_redis[("Redis")]
  node_telemetry["Telemetry"]
  node_virtualhost["Virtual host"]
end

subgraph group_support["Cluster services"]
  node_certmanager["Cert manager<br/>[cert-manager.yaml]"]
  node_nginx["Nginx<br/>[nginx.yaml]"]
  node_secretstore["Secret store CSI<br/>[secret-store.yaml]"]
  node_vault["Vault<br/>[vault.yaml]"]
end

node_user(("Platform operator"))
node_argocd["ArgoCD"]

node_user -->|"prepares"| node_apigeecloud
node_user -->|"creates"| node_gke
node_user -->|"installs"| node_argocd
node_user -->|"defines"| node_rootapp
node_rootapp -->|"targets folder"| node_childdefs
node_argocd -->|"manages apps"| node_childdefs
node_childdefs -->|"points to charts"| node_chartrepo
node_user -->|"applies first"| node_crds
node_operatorapp -->|"deploys chart"| node_operator
node_childdefs -->|"includes definition"| node_operatorapp
node_childdefs -.->|"deploys chart"| node_datastore
node_childdefs -.->|"deploys chart"| node_environment
node_childdefs -.->|"deploys chart"| node_ingress
node_childdefs -.->|"deploys chart"| node_organization
node_childdefs -.->|"deploys chart"| node_redis
node_childdefs -.->|"deploys chart"| node_telemetry
node_childdefs -.->|"deploys chart"| node_virtualhost
node_argocd -->|"installs service"| node_certmanager
node_argocd -->|"installs service"| node_nginx
node_argocd -->|"installs service"| node_secretstore
node_argocd -->|"installs service"| node_vault

click node_operator "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-operator"
click node_crds "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-operator/etc/crds/default"
click node_datastore "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-datastore"
click node_environment "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-env"
click node_ingress "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-ingress-manager"
click node_organization "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-org"
click node_redis "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-redis"
click node_telemetry "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-telemetry"
click node_virtualhost "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-virtualhost"
click node_certmanager "https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/cert-manager.yaml"
click node_nginx "https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/nginx.yaml"
click node_secretstore "https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/secret-store.yaml"
click node_vault "https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/vault.yaml"
click node_childdefs "https://github.com/ayosal/argocd-hybrid/tree/main/apps/templates"
click node_chartrepo "https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts"
click node_rootapp "https://github.com/ayosal/argocd-hybrid/blob/main/apps.yaml"
click node_operatorapp "https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/operator.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gke,node_apigeecloud toneBlue
class node_childdefs,node_chartrepo,node_rootapp,node_operatorapp toneAmber
class node_operator,node_crds,node_datastore,node_environment,node_ingress,node_organization,node_redis,node_telemetry,node_virtualhost toneMint
class node_certmanager,node_nginx,node_secretstore,node_vault toneRose
class node_user,node_argocd toneIndigo
```

## Components

### Cluster setup

- **GKE cluster**
- **Apigee organization**

### ArgoCD orchestration

- [Child app definitions](https://github.com/ayosal/argocd-hybrid/tree/main/apps/templates): `apps/templates`
- [Helm chart sources](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts): `apps/apigee-charts`
- [Root application](https://github.com/ayosal/argocd-hybrid/blob/main/apps.yaml): `apps.yaml`
- [Operator app template](https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/operator.yaml): `apps/templates/operator.yaml`

### Apigee components

- [Apigee operator](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-operator): `apps/apigee-charts/apigee-operator`
- [Apigee CRDs](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-operator/etc/crds/default): `apps/apigee-charts/apigee-operator/etc/crds/default`
- [Datastore](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-datastore): `apps/apigee-charts/apigee-datastore`
- [Environment](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-env): `apps/apigee-charts/apigee-env`
- [Ingress manager](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-ingress-manager): `apps/apigee-charts/apigee-ingress-manager`
- [Organization](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-org): `apps/apigee-charts/apigee-org`
- [Redis](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-redis): `apps/apigee-charts/apigee-redis`
- [Telemetry](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-telemetry): `apps/apigee-charts/apigee-telemetry`
- [Virtual host](https://github.com/ayosal/argocd-hybrid/tree/main/apps/apigee-charts/apigee-virtualhost): `apps/apigee-charts/apigee-virtualhost`

### Cluster services

- [Cert manager](https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/cert-manager.yaml): `apps/templates/cert-manager.yaml`
- [Nginx](https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/nginx.yaml): `apps/templates/nginx.yaml`
- [Secret store CSI](https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/secret-store.yaml): `apps/templates/secret-store.yaml`
- [Vault](https://github.com/ayosal/argocd-hybrid/blob/main/apps/templates/vault.yaml): `apps/templates/vault.yaml`

### Other components

- **Platform operator**
- **ArgoCD**

## Connections

- Platform operator → Apigee organization: prepares (evidence: `README.md`)
- Platform operator → GKE cluster: creates (evidence: `README.md`)
- Platform operator → ArgoCD: installs (evidence: `README.md`)
- Platform operator → Root application: defines (evidence: `README.md`)
- Root application → Child app definitions: targets folder (evidence: `README.md`)
- ArgoCD → Child app definitions: manages apps (evidence: `README.md`)
- Child app definitions → Helm chart sources: points to charts (evidence: `README.md`)
- Platform operator → Apigee CRDs: applies first (evidence: `README.md`)
- Operator app template → Apigee operator: deploys chart (evidence: `README.md`)
- Child app definitions → Operator app template: includes definition (evidence: `README.md`)
- Child app definitions → Datastore: deploys chart
- Child app definitions → Environment: deploys chart
- Child app definitions → Ingress manager: deploys chart
- Child app definitions → Organization: deploys chart
- Child app definitions → Redis: deploys chart
- Child app definitions → Telemetry: deploys chart
- Child app definitions → Virtual host: deploys chart
- ArgoCD → Cert manager: installs service (evidence: `README.md`)
- ArgoCD → Nginx: installs service (evidence: `README.md`)
- ArgoCD → Secret store CSI: installs service (evidence: `README.md`)
- ArgoCD → Vault: installs service (evidence: `README.md`)
