README.md

# AstraCloud Developer Platform



**AstraCloud Developer Platform** is a zero-cost, home-lab-first, multi-cloud Internal Developer Platform.



It is designed to demonstrate professional-level skills in:



- Platform engineering

- Kubernetes and GitOps

- DevSecOps pipelines

- Multi-cloud architecture

- On-prem/home-server infrastructure

- Observability

- Backup and disaster recovery

- Cost-controlled cloud usage



## Final Goal



Build a self-service developer portal where a user can create a new app from a template and automatically get:



- GitHub repository structure

- Dockerfile

- Helm chart

- CI/CD pipeline

- Security scanning

- Argo CD GitOps deployment

- Kubernetes namespace

- Ingress URL

- Monitoring dashboard

- Logs dashboard

- Documentation page



Primary production runs on a home-server K3s cluster. AWS, Azure, and GCP are used as temporary disaster recovery and staging targets, created and destroyed with Terraform and Ansible.



## High-Level Architecture



```mermaid

flowchart TD

    Dev[Developer] --> Portal[Backstage Developer Portal]

    Portal --> Templates[Software Templates]

    Templates --> GitHub[GitHub Repository]

    GitHub --> Actions[GitHub Actions CI]

    Actions --> Security[Security Gates]

    Security --> Registry[Harbor Registry]

    Actions --> GitOps[GitOps Repository]

    GitOps --> Argo[Argo CD]

    Argo --> Home[Home Server K3s]

    Argo --> AWS[AWS Temporary DR]

    Argo --> Azure[Azure Temporary DR]

    Argo --> GCP[GCP Temporary DR]

    Home --> Obs[Prometheus Grafana Loki]

    Home --> Backup[Velero Longhorn MinIO]

```



## Project Phases



1. Phase 0: Project foundation and repository structure

2. Phase 1: Home server base setup

3. Phase 2: K3s and Kubernetes bootstrap

4. Phase 3: Argo CD GitOps foundation

5. Phase 4: Backstage developer portal

6. Phase 5: First app template

7. Phase 6: GitHub Actions CI/CD

8. Phase 7: Harbor image registry

9. Phase 8: Security scanning

10. Phase 9: Kyverno Kubernetes policies

11. Phase 10: Monitoring and logs

12. Phase 11: More service templates

13. Phase 12: Keycloak authentication

14. Phase 13: Backup and restore

15. Phase 14: AWS temporary DR

16. Phase 15: Azure temporary DR

17. Phase 16: GCP temporary DR

18. Phase 17: Jenkins operations automation

19. Phase 18: Final documentation and demo



## Current Phase



**Phase 0: Foundation**



This repo currently contains the starter structure, documentation, diagrams, and standards.



## Next Step



Move to `docs/phase-0-checklist.md` and complete all checklist items.