# riamanral/k8s-aws-setup architecture

> Architecture diagram of the GitHub repository riamanral/k8s-aws-setup, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/riamanral/k8s-aws-setup
- Repository: https://github.com/riamanral/k8s-aws-setup

## Overview

This is a hands-on project for building and operating a private, multi-node k3s cluster on AWS, first manually and then with Terraform. Its documented scope includes infrastructure, configuration management, SSM access, CI/CD, Kubernetes components, and start/stop automation. The supplied tree contains only README.md, so implementation paths and most component wiring cannot be verified; only the documented Terraform-to-AWS provisioning relationship is shown.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provisioning["Infrastructure"]
  node_terraform["Terraform"]
  node_networking["Networking"]
  node_iam["IAM"]
  node_ssm["SSM Access"]
end

subgraph group_cluster["Cluster Setup"]
  node_ansible["Ansible Playbooks"]
  node_k3s{{"Private k3s Cluster"}}
  node_kubernetes["Kubernetes Components"]
end

subgraph group_operations["Operations"]
  node_cicd["CI/CD"]
  node_scripts["Start/Stop Scripts"]
end

node_operator(("Operator"))
node_aws{{"AWS"}}

node_operator -->|"uses"| node_terraform
node_terraform -->|"provisions"| node_aws
node_operator -->|"uses"| node_ansible
node_operator -->|"runs"| node_scripts

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_terraform,node_networking,node_iam,node_ssm toneBlue
class node_ansible,node_k3s,node_kubernetes toneAmber
class node_cicd,node_scripts toneMint
class node_operator,node_aws toneIndigo
```

## Components

### Infrastructure

- **Terraform**
- **Networking**
- **IAM**
- **SSM Access**

### Cluster Setup

- **Ansible Playbooks**
- **Private k3s Cluster**
- **Kubernetes Components**

### Operations

- **CI/CD**
- **Start/Stop Scripts**

### Other components

- **Operator**
- **AWS**

## Connections

- Operator → Terraform: uses
- Terraform → AWS: provisions
- Operator → Ansible Playbooks: uses
- Operator → Start/Stop Scripts: runs