# gowthamsirigiri/jenkins_master_slave_autoscaling architecture

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

- Interactive diagram: https://gitdiagram.com/gowthamsirigiri/jenkins_master_slave_autoscaling
- Repository: https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling

## Overview

This repository is an architecture blueprint, not an implementation: Jenkins on a Dockerized EC2 master coordinates work, while an EC2 Auto Scaling Group provisions agents to execute jobs. The documented setup covers agent bootstrap and JNLP connectivity, node configuration, and metric-driven scaling. All repository nodes point to README.md; relationships are limited to those described there.

Main entry points: [`README.md`](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md) (Jenkins master)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Jenkins control plane"]
  node_master["Jenkins master<br/>[README.md]"]
  node_docker["Docker runtime<br/>[README.md]"]
  node_master_ec2["Master EC2<br/>[README.md]"]
  node_node_config["Node configuration<br/>[README.md]"]
end

subgraph group_scaling["Agent provisioning"]
  node_scaling_policy["Scaling metrics<br/>[README.md]"]
  node_asg["Auto Scaling Group<br/>[README.md]"]
  node_launch_config["Launch config / template<br/>[README.md]"]
end

subgraph group_execution["Agent execution"]
  node_agent_ec2["Agent EC2 instances<br/>[README.md]"]
  node_bootstrap["Agent bootstrap<br/>[README.md]"]
  node_agent_jar["Jenkins agent JAR<br/>[README.md]"]
  node_jnlp["JNLP connection<br/>[README.md]"]
  node_job_execution["Agent job execution<br/>[README.md]"]
end

node_teams(("Dev / QA teams"))

node_teams -->|"access UI"| node_master
node_docker -->|"runs"| node_master
node_master_ec2 -->|"hosts"| node_master
node_master -->|"configure nodes"| node_node_config
node_launch_config -->|"configures"| node_asg
node_asg -->|"provisions"| node_agent_ec2
node_scaling_policy -->|"triggers scaling"| node_asg
node_agent_ec2 -->|"runs"| node_bootstrap
node_bootstrap -->|"downloads"| node_agent_jar
node_bootstrap -->|"downloads from"| node_master
node_bootstrap -->|"establishes"| node_jnlp
node_jnlp -->|"connects to"| node_master
node_master -->|"coordinates jobs"| node_job_execution
node_job_execution -->|"executes on"| node_agent_ec2

click node_master "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_docker "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_master_ec2 "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_node_config "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_scaling_policy "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_asg "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_launch_config "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_agent_ec2 "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_bootstrap "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_agent_jar "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_jnlp "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"
click node_job_execution "https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md"

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_master,node_docker,node_master_ec2,node_node_config toneBlue
class node_scaling_policy,node_asg,node_launch_config toneAmber
class node_agent_ec2,node_bootstrap,node_agent_jar,node_jnlp,node_job_execution toneMint
class node_teams toneIndigo
```

## Components

### Jenkins control plane

- [Jenkins master](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [Docker runtime](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [Master EC2](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [Node configuration](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`

### Agent provisioning

- [Scaling metrics](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [Auto Scaling Group](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [Launch config / template](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`

### Agent execution

- [Agent EC2 instances](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [Agent bootstrap](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [Jenkins agent JAR](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [JNLP connection](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`
- [Agent job execution](https://github.com/gowthamsirigiri/jenkins_master_slave_autoscaling/blob/main/README.md): `README.md`

### Other components

- **Dev / QA teams**

## Connections

- Dev / QA teams → Jenkins master: access UI (evidence: `README.md`)
- Docker runtime → Jenkins master: runs (evidence: `README.md`)
- Master EC2 → Jenkins master: hosts (evidence: `README.md`)
- Jenkins master → Node configuration: configure nodes (evidence: `README.md`)
- Launch config / template → Auto Scaling Group: configures (evidence: `README.md`)
- Auto Scaling Group → Agent EC2 instances: provisions (evidence: `README.md`)
- Scaling metrics → Auto Scaling Group: triggers scaling (evidence: `README.md`)
- Agent EC2 instances → Agent bootstrap: runs (evidence: `README.md`)
- Agent bootstrap → Jenkins agent JAR: downloads (evidence: `README.md`)
- Agent bootstrap → Jenkins master: downloads from (evidence: `README.md`)
- Agent bootstrap → JNLP connection: establishes (evidence: `README.md`)
- JNLP connection → Jenkins master: connects to (evidence: `README.md`)
- Jenkins master → Agent job execution: coordinates jobs (evidence: `README.md`)
- Agent job execution → Agent EC2 instances: executes on (evidence: `README.md`)
