# kodekloudhub/amazon-elastic-kubernetes-service-course architecture

> Architecture diagram of the GitHub repository kodekloudhub/amazon-elastic-kubernetes-service-course, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kodekloudhub/amazon-elastic-kubernetes-service-course
- Repository: https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course

## Overview

##### Project Type and Purpose
- Type: Infrastructure-as-Code repository using Terraform modules.
- Purpose: Automate provisioning of an AWS EKS (Elastic Kubernetes Service) cluster (control plane, worker nodes, IAM roles, networking, policies) for training or CI/CD pipelines.

##### File Structure
- Top-level:
– README.md: high-level project description & links to docs.
– docs/: markdown guides on deployment, EKS course, playground usage, node configuration.
– eks/: main Terraform directory.
- eks/ directory:
– data.tf, main.tf, eks.tf, nodes.tf, policies.tf, policy.yaml, variables.tf: core Terraform resources.
– modules/: reusable sub-modules:
· create-service-role: defines IAM service role.
· use-service-role: attaches policies or configures role usage.
– check-environment.{ps1,sh}: verify AWS CLI & Terraform setup.
– eks/README.md: module‐specific instructions.

##### README for Insights
- Underlying tech: Terraform, AWS EKS, IAM, VPC/subnets (implied).

##### Sketching Main Components
a. Terraform Workflow
– Local machine or CI runner executes Terraform CLI.
– check-environment scripts validate prerequisites.
b. Terraform Modules & Resources
– Module “create-service-role” → AWS::IAM::Role (+ trust policy).
– Module “use-service-role” → AWS::IAM::RolePolicyAttachment, AWS managed policies.
– VPC/subnet/network/security group definitions (in main.tf or eks.tf).
– aws_eks_cluster resource → control plane.
– aws_eks_node_group or self-managed worker nodes resources → nodes.tf.
– aws_iam_* resources for policies & service roles.
c. AWS Control Plane & Node Groups
– EKS Control Plane (provisioned by AWS, interacts with IAM & VPC).
– Worker Nodes (EC2 instances) in private subnets, joined to cluster.
d. External/Ancillary
– KodeKloud Playground or CI/CD pipeline (Jenkins) invoking Terraform.
– AWS API endpoints.

##### Architectural Patterns/Principles
- Reusability: Terraform modules for service-role creation & usage.
- Idempotence & Declarative provisioning.
- Separation of concerns: IAM, networking, EKS cluster, node groups as separate tf files/modules.

##### Technologies & Frameworks
- Terraform (HCL)
- AWS EKS, IAM, VPC, EC2
- Shell & PowerShell scripts for environment checks
- Markdown docs for user guidance

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Trigger
    Operator["CLI/CI Pipeline"]:::external

    %% Terraform Orchestrator
    subgraph "Terraform IaC Orchestrator"
        direction TB
        CheckSh["check-environment.sh"]:::script
        CheckPS1["check-environment.ps1"]:::script
        MainTF["main.tf"]:::iac
        EksTF["eks.tf"]:::iac
        DataTF["data.tf"]:::iac
        VarTF["variables.tf"]:::iac
        subgraph Modules
            direction TB
            CreateRole["create-service-role"]:::module
            UseRole["use-service-role"]:::module
        end
        PoliciesTF["policies.tf"]:::iac
        PolicyY["policy.yaml"]:::iac
        NodesTF["nodes.tf"]:::iac
    end

    %% AWS Resources
    subgraph "AWS Environment"
        direction TB
        IAM["IAM Service Roles & Policies"]:::aws
        VPC["VPC & Networking"]:::aws
        EKS["EKS Control Plane"]:::aws
        Nodes["EKS Worker Nodes"]:::aws
    end

    %% Documentation
    subgraph "Project Documentation" 
        direction TB
        README["README.md"]:::docs
        DeployMD["deploy.md"]:::docs
        EksCourse["eks-course.md"]:::docs
        NodesMD["nodes.md"]:::docs
        Playground["playground.md"]:::docs
    end

    %% Relationships
    Operator --> CheckSh
    Operator --> CheckPS1
    Operator --> MainTF
    Operator -.-> README
    Operator -.-> DeployMD
    Operator -.-> EksCourse
    Operator -.-> NodesMD
    Operator -.-> Playground

    CheckSh --> MainTF
    CheckPS1 --> MainTF

    MainTF --> IAM
    MainTF --> VPC
    EksTF --> EKS
    DataTF --> VPC
    VarTF --> VPC
    NodesTF --> Nodes
    CreateRole --> IAM
    UseRole --> IAM
    PoliciesTF --> IAM
    PolicyY --> IAM

    IAM --> EKS
    IAM --> Nodes
    VPC --> EKS
    VPC --> Nodes
    EKS <--> Nodes

    %% Click events
    click CheckSh "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/check-environment.sh"
    click CheckPS1 "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/check-environment.ps1"
    click MainTF "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/main.tf"
    click EksTF "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/eks.tf"
    click DataTF "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/data.tf"
    click VarTF "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/variables.tf"
    click CreateRole "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/modules/create-service-role/main.tf"
    click UseRole "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/modules/use-service-role/main.tf"
    click PoliciesTF "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/policies.tf"
    click PolicyY "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/policy.yaml"
    click NodesTF "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/eks/nodes.tf"
    click README "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/README.md"
    click DeployMD "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/docs/deploy.md"
    click EksCourse "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/docs/eks-course.md"
    click NodesMD "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/docs/nodes.md"
    click Playground "https://github.com/kodekloudhub/amazon-elastic-kubernetes-service-course/blob/main/docs/playground.md"

    %% Styles
    classDef external fill:#A0D2DB,stroke:#333,stroke-width:1px
    classDef script fill:#A9DFBF,stroke:#333,stroke-width:1px
    classDef iac fill:#85C1E9,stroke:#333,stroke-width:1px
    classDef module fill:#F7DC6F,stroke:#333,stroke-width:1px
    classDef aws fill:#F5B7B1,stroke:#333,stroke-width:1px
    classDef docs fill:#ABEBC6,stroke:#333,stroke-width:1px
```
