# mukeshr1197/devops-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/mukeshr1197/devops-portfolio
- Repository: https://github.com/mukeshr1197/devops-portfolio

## Overview

This is a small Flask service surrounded by a documented Azure delivery pipeline and Terraform-managed infrastructure. The main workflow runs on pushes to main: GitHub Actions tests the app, builds and scans an image, pushes it to ACR, and deploys it to Container Apps. Terraform provisions the Azure resources; the README also documents OIDC authentication, remote state, and monitoring. Infrastructure and workflow details are based on the README because their source files were not excerpted.

Main entry points: [`.github/workflows/deploy.yml`](https://github.com/mukeshr1197/devops-portfolio/blob/main/.github/workflows/deploy.yml) (Actions workflow), [`terraform/main.tf`](https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf) (Azure resources), [`app/Dockerfile`](https://github.com/mukeshr1197/devops-portfolio/blob/main/app/Dockerfile) (Container image), [`app/app.py`](https://github.com/mukeshr1197/devops-portfolio/blob/main/app/app.py) (Flask endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["Delivery pipeline"]
  node_workflow["Actions workflow<br/>[deploy.yml]"]
  node_tests["App tests<br/>[test_app.py]"]
  node_image["Container image"]
  node_trivy["Trivy scan<br/>[deploy.yml]"]
  node_registry[("Azure registry")]
end

subgraph group_application["Application"]
  node_app["Flask endpoints<br/>[app.py]"]
end

subgraph group_infrastructure["Azure infrastructure"]
  node_terraform["Azure resources<br/>[main.tf]"]
  node_containerapp["Container Apps"]
  node_identity["Entra OIDC<br/>[main.tf]"]
  node_state[("Terraform state<br/>[backend.tf]")]
end

subgraph group_operations["Operations"]
  node_monitor["Azure Monitor<br/>[main.tf]"]
  node_logs[("Log Analytics<br/>[main.tf]")]
  node_email(("Email alerts"))
end

node_github(("GitHub push"))

node_github -->|"triggers"| node_workflow
node_workflow -->|"runs"| node_tests
node_workflow -->|"builds"| node_image
node_workflow -->|"scans"| node_trivy
node_workflow -->|"pushes"| node_registry
node_workflow -->|"deploys"| node_containerapp
node_workflow -->|"authenticates via"| node_identity
node_image -->|"packages"| node_app
node_terraform -->|"provisions"| node_containerapp
node_terraform -->|"provisions"| node_registry
node_terraform -->|"configures"| node_identity
node_terraform -->|"provisions"| node_monitor
node_terraform -->|"provisions"| node_logs
node_terraform -->|"stores remotely"| node_state
node_containerapp -->|"runs"| node_app
node_monitor -->|"watches"| node_logs
node_monitor -->|"alerts"| node_email

click node_workflow "https://github.com/mukeshr1197/devops-portfolio/blob/main/.github/workflows/deploy.yml"
click node_tests "https://github.com/mukeshr1197/devops-portfolio/blob/main/app/test_app.py"
click node_image "https://github.com/mukeshr1197/devops-portfolio/blob/main/app/Dockerfile"
click node_trivy "https://github.com/mukeshr1197/devops-portfolio/blob/main/.github/workflows/deploy.yml"
click node_app "https://github.com/mukeshr1197/devops-portfolio/blob/main/app/app.py"
click node_terraform "https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf"
click node_identity "https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf"
click node_state "https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/backend.tf"
click node_monitor "https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf"
click node_logs "https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf"

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_workflow,node_tests,node_image,node_trivy,node_registry toneBlue
class node_app toneAmber
class node_terraform,node_containerapp,node_identity,node_state toneMint
class node_monitor,node_logs,node_email toneRose
class node_github toneIndigo
```

## Components

### Delivery pipeline

- [Actions workflow](https://github.com/mukeshr1197/devops-portfolio/blob/main/.github/workflows/deploy.yml): `.github/workflows/deploy.yml`
- [App tests](https://github.com/mukeshr1197/devops-portfolio/blob/main/app/test_app.py): `app/test_app.py`
- [Container image](https://github.com/mukeshr1197/devops-portfolio/blob/main/app/Dockerfile): `app/Dockerfile`
- [Trivy scan](https://github.com/mukeshr1197/devops-portfolio/blob/main/.github/workflows/deploy.yml): `.github/workflows/deploy.yml`
- **Azure registry**

### Application

- [Flask endpoints](https://github.com/mukeshr1197/devops-portfolio/blob/main/app/app.py): `app/app.py`

### Azure infrastructure

- [Azure resources](https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf): `terraform/main.tf`
- **Container Apps**
- [Entra OIDC](https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf): `terraform/main.tf`
- [Terraform state](https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/backend.tf): `terraform/backend.tf`

### Operations

- [Azure Monitor](https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf): `terraform/main.tf`
- [Log Analytics](https://github.com/mukeshr1197/devops-portfolio/blob/main/terraform/main.tf): `terraform/main.tf`
- **Email alerts**

### Other components

- **GitHub push**

## Connections

- GitHub push → Actions workflow: triggers (evidence: `README.md`)
- Actions workflow → App tests: runs (evidence: `README.md`)
- Actions workflow → Container image: builds (evidence: `README.md`)
- Actions workflow → Trivy scan: scans (evidence: `README.md`)
- Actions workflow → Azure registry: pushes (evidence: `README.md`)
- Actions workflow → Container Apps: deploys (evidence: `README.md`)
- Actions workflow → Entra OIDC: authenticates via (evidence: `README.md`)
- Container image → Flask endpoints: packages (evidence: `README.md`)
- Azure resources → Container Apps: provisions (evidence: `README.md`)
- Azure resources → Azure registry: provisions (evidence: `README.md`)
- Azure resources → Entra OIDC: configures (evidence: `README.md`)
- Azure resources → Azure Monitor: provisions (evidence: `README.md`)
- Azure resources → Log Analytics: provisions (evidence: `README.md`)
- Azure resources → Terraform state: stores remotely (evidence: `README.md`)
- Container Apps → Flask endpoints: runs (evidence: `README.md`)
- Azure Monitor → Log Analytics: watches (evidence: `README.md`)
- Azure Monitor → Email alerts: alerts (evidence: `README.md`)
