# nurdynzo/helm-chart architecture

> Architecture diagram of the GitHub repository nurdynzo/helm-chart, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nurdynzo/helm-chart
- Repository: https://github.com/nurdynzo/helm-chart

## Overview

##### Project type and purpose
- This repo is a set of Helm charts (“aks-agic” and “demo-chart”) used to package, configure, and deploy applications onto a Kubernetes cluster (specifically Azure Kubernetes Service with Azure Application Gateway Ingress Controller, based on “aks-agic”).
- The charts provide template files for Deployment, Service, Ingress, HPA, ConfigMap, etc., and the GitHub Actions workflow (release.yml) automates packaging/publishing chart releases.

##### File structure
- Top-level:
- .github/workflows/release.yml → CI/CD pipeline for chart releases
- charts/aks-agic → Helm chart that sets up AGIC integration
- charts/demo-chart → sample/demo Helm chart for arbitrary app
- Each chart contains:
- Chart.yaml (metadata)
- values.yaml (default values)
- templates/ (Kubernetes manifest templates: Deployment, Service, Ingress, HPA, ConfigMap, tests)
- No application source code here—only chart definitions.

##### README for additional insights
- README simply names the repo “helm-chart.”

## Diagram (Mermaid)

```mermaid
graph TD
    %% GitHub & CI/CD
    subgraph "GitHub & CI/CD" 
        GitHubRepo["GitHub Repository"]:::repo
        GitHubActions["GitHub Actions (release.yml)"]:::ci
    end

    %% Chart Registry & Helm
    subgraph "Chart Registry & Helm" 
        HelmRegistry["Helm Chart Registry"]:::artifact
        HelmCLI["Helm CLI"]:::artifact
    end

    %% Kubernetes Cluster
    subgraph "AKS Cluster & AGIC" 
        KubernetesAPI["Kubernetes API Server"]:::k8s
        AKSCluster["AKS Cluster"]:::k8s
        subgraph "AGIC Integration"
            AGICPod["AGIC Pod"]:::infra
            ApplicationGateway["Azure Application Gateway"]:::infra
        end
        Internet["Internet"]:::external
    end

    %% Demo Chart Subgraph
    subgraph "demo-chart" 
        DemoChartMeta["Chart.yaml"]:::chart
        DemoValues["values.yaml"]:::chart
        DemoIgnore[".helmignore"]:::chart
        DemoTemplates["templates/"]:::chart
        DemoChartMeta --> DemoValues
        DemoValues --> DemoIgnore
        DemoIgnore --> DemoTemplates
    end

    %% aks-agic Chart Subgraph
    subgraph "aks-agic" 
        AksChartMeta["Chart.yaml"]:::chart
        AksValues["values.yaml"]:::chart
        AksIgnore[".helmignore"]:::chart
        AksTemplates["templates/"]:::chart
        AksChartMeta --> AksValues
        AksValues --> AksIgnore
        AksIgnore --> AksTemplates
    end

    %% Flows
    GitHubRepo -->|"push/tag"| GitHubActions
    GitHubActions -->|"package & publish"| HelmRegistry
    HelmCLI -->|"pull chart"| HelmRegistry
    HelmCLI -->|"helm install"| KubernetesAPI
    KubernetesAPI -->|"manage resources"| AKSCluster
    AKSCluster --> DemoChartMeta
    AKSCluster --> AksChartMeta
    AKSCluster --> DemoTemplates
    AKSCluster --> AksTemplates

    DemoTemplates -->|"deploy resources"| KubernetesAPI
    AksTemplates -->|"deploy AGIC components"| KubernetesAPI

    %% Ingress & AGIC flow
    AKSCluster --> DemoIngress["Demo Ingress"]:::k8s
    AKSCluster --> AksIngress["AGIC Ingress"]:::k8s
    DemoIngress -->|"watches"| AGICPod
    AksIngress -->|"watches"| AGICPod
    AGICPod -->|"configures"| ApplicationGateway
    ApplicationGateway --> Internet

    %% Click Events
    click GitHubRepo "https://github.com/nurdynzo/helm-chart/blob/main/README.md"
    click GitHubActions "https://github.com/nurdynzo/helm-chart/blob/main/.github/workflows/release.yml"
    click AksChartMeta "https://github.com/nurdynzo/helm-chart/blob/main/charts/aks-agic/Chart.yaml"
    click AksValues "https://github.com/nurdynzo/helm-chart/blob/main/charts/aks-agic/values.yaml"
    click AksIgnore "https://github.com/nurdynzo/helm-chart/blob/main/charts/aks-agic/.helmignore"
    click AksTemplates "https://github.com/nurdynzo/helm-chart/tree/main/charts/aks-agic/templates/"
    click DemoChartMeta "https://github.com/nurdynzo/helm-chart/blob/main/charts/demo-chart/Chart.yaml"
    click DemoValues "https://github.com/nurdynzo/helm-chart/blob/main/charts/demo-chart/values.yaml"
    click DemoIgnore "https://github.com/nurdynzo/helm-chart/blob/main/charts/demo-chart/.helmignore"
    click DemoTemplates "https://github.com/nurdynzo/helm-chart/tree/main/charts/demo-chart/templates/"

    %% Styles
    classDef repo fill:#f9f,stroke:#333,stroke-width:1px
    classDef ci fill:#ff9,stroke:#333,stroke-width:1px
    classDef artifact fill:#9ff,stroke:#333,stroke-width:1px
    classDef k8s fill:#cfc,stroke:#333,stroke-width:1px
    classDef infra fill:#fcc,stroke:#333,stroke-width:1px
    classDef external fill:#ccc,stroke:#333,stroke-width:1px
    classDef chart fill:#fcf,stroke:#333,stroke-width:1px
```
