# nukunga/pipe-workshop architecture

> Architecture diagram of the GitHub repository nukunga/pipe-workshop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nukunga/pipe-workshop
- Repository: https://github.com/nukunga/pipe-workshop

## Overview

##### Main Components

A. Development Pipeline Components:
- Source Control (CodeCommit)
- Build System (CodeBuild)
- Deployment System (CodeDeploy)
- Pipeline Orchestration (CodePipeline)

B. Security Testing Layers:
- SCA (Dependency-CHECK)
- SAST (SonarQube)
- DAST (OWASP ZAP)

C. Monitoring & Security Components:
- AWS WAF
- CloudTrail
- GuardDuty
- OpenSearch (for log aggregation and alerting)

**┌─────────────────────────────────────────────────────────────┐**
- Development Layer                        │
- ┤
- Security Testing Layer                   │
- ┤
- Deployment Layer                         │
- ┤
- Monitoring Layer                         │
- ┘

##### Specific Implementation Details

A. Development Flow:
**CodeCommit → CodeBuild → CodeDeploy → Production**

B. Security Testing Integration:
**CodeBuild → [SCA → SAST → DAST] → Security Validation**

C. Monitoring Flow:
**WAF ─┐**

**CloudTrail ─┼→ OpenSearch → Alerts**

**GuardDuty ─┘**

##### Additional Elements

Specific components from the project:
- IAM roles and permissions (from iac/deploy-test/modules/iam-role)
- S3 buckets for artifacts (from iac/deploy-test/modules/s3)
- KMS for encryption (from iac/deploy-test/modules/kms)
- Lambda functions for security hub integration (from yaml&script/lambda)

##### Implementation Notes

- Version/environment indicators
- Security group boundaries
- Alert trigger points

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and classes
    classDef aws fill:#FF9900,stroke:#232F3E,color:white
    classDef security fill:#00A400,stroke:#232F3E,color:white
    classDef monitoring fill:#FF4F8B,stroke:#232F3E,color:white
    classDef storage fill:#3B48CC,stroke:#232F3E,color:white
    classDef iam fill:#C925D1,stroke:#232F3E,color:white
    classDef lambda fill:#FF6B6B,stroke:#232F3E,color:white

    %% Development Layer
    subgraph Development
        CodeCommit["CodeCommit Repository"]:::aws
        CodeBuild["CodeBuild"]:::aws
        CodeDeploy["CodeDeploy"]:::aws
        CodePipeline["CodePipeline"]:::aws
    end

    %% Security Testing Layer
    subgraph SecurityTesting
        SCA["Dependency-CHECK (SCA)"]:::security
        SAST["SonarQube (SAST)"]:::security
        DAST["OWASP ZAP (DAST)"]:::security
        BuildSpec["Build Specifications"]:::aws
    end

    %% Infrastructure Layer
    subgraph Infrastructure
        S3["S3 Buckets"]:::storage
        KMS["KMS Encryption"]:::aws
        IAM["IAM Roles"]:::iam
    end

    %% Monitoring Layer
    subgraph Monitoring
        WAF["AWS WAF"]:::aws
        CloudTrail["CloudTrail"]:::monitoring
        GuardDuty["GuardDuty"]:::monitoring
        OpenSearch["OpenSearch"]:::aws
        SecurityHub["Security Hub"]:::monitoring
    end

    %% Lambda Functions
    subgraph LambdaFunctions
        WAFLambda["WAF Logs Lambda"]:::lambda
        CloudTrailLambda["CloudTrail Logs Lambda"]:::lambda
        GuardDutyLambda["GuardDuty Lambda"]:::lambda
        SecurityHubLambda["Security Hub Lambda"]:::lambda
    end

    %% Relationships
    CodeCommit --> CodePipeline
    CodePipeline --> CodeBuild
    CodeBuild --> |Build Process| BuildSpec
    BuildSpec --> SCA
    BuildSpec --> SAST
    BuildSpec --> DAST
    CodeBuild --> CodeDeploy
    
    WAF --> WAFLambda
    CloudTrail --> CloudTrailLambda
    GuardDuty --> GuardDutyLambda
    SecurityHub --> SecurityHubLambda
    
    WAFLambda --> OpenSearch
    CloudTrailLambda --> OpenSearch
    GuardDutyLambda --> OpenSearch
    SecurityHubLambda --> OpenSearch

    %% Click events for component mapping
    click CodeCommit "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/modules/codecommit/"
    click CodeBuild "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/modules/codebuild/"
    click CodeDeploy "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/modules/terraform-aws-btlabz-arch-ref-ec2-codedeploy-module/"
    click CodePipeline "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/modules/codepipeline/"
    click SAST "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/sonarQube/"
    click DAST "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/owasp-zap/"
    click GuardDutyLambda "https://github.com/nukunga/Pipe-Workshop/blob/main/iac/guardduty_lambda.tf"
    click IAM "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/modules/iam-role/"
    click S3 "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/modules/s3/"
    click KMS "https://github.com/nukunga/Pipe-Workshop/tree/main/iac/deploy-test/modules/kms/"
    click SecurityHubLambda "https://github.com/nukunga/Pipe-Workshop/blob/main/yaml&script/lambda/securityhub.py"
    click BuildSpec "https://github.com/nukunga/Pipe-Workshop/blob/main/yaml&script/buildspec_build.yml"
    click CloudTrailLambda "https://github.com/nukunga/Pipe-Workshop/blob/main/iac/cloudtrail-logs-lambda.zip"
    click WAFLambda "https://github.com/nukunga/Pipe-Workshop/blob/main/iac/aws-waf-logs-lambda.zip"
```
