Content
<div align="center">
<img src="https://github.com/codetocloudorg/artwork/blob/main/examples/images/current/code_to_cloud_1920_x_1080_desktop.png?raw=true" alt="Platform Engineering Hub — Code To Cloud: IaC, Kubernetes, DevSecOps, and Cloud-Native Resources" width="600" />
# Platform Engineering
**The open-source hub for platform engineering: IaC templates, Kubernetes guides, DevSecOps practices, and internal developer platform blueprints.**
[](https://github.com/codetocloudorg/platform-engineering)
[](https://github.com/codetocloudorg/platform-engineering/fork)
[](https://github.com/codetocloudorg/platform-engineering/issues)
[](https://github.com/codetocloudorg/platform-engineering/commits/main)
[](LICENSE)
[](https://eng.codetocloud.io)
[](https://discord.gg/vwfwq2EpXJ)
[](https://github.com/codetocloudorg/platform-engineering/graphs/contributors)
[Website](https://eng.codetocloud.io) · [Getting Started](#-quick-start) · [Docs](docs/) · [Contributing](CONTRIBUTING.md) · [Discord](https://discord.gg/vwfwq2EpXJ)
</div>
---
## 📑 Contents
- [Quick Start](#-quick-start)
- [Local Development](#-local-development)
- [What is Platform Engineering?](#-what-is-platform-engineering)
- [Key Components](#-key-components)
- [Learning & Certification](#-learning--certification)
- [Contributing](#-contributing)
---
## 🏢 About
Created by **[Kevin Evans](https://linktr.ee/bash.sh)** and the **[Code to Cloud](https://connect.codetocloud.io)** community. What started as a personal learning journey has grown into a comprehensive resource for platform engineering teams.
> *"It's all in the reflexes."* — Jack Burton
**Focus Areas:** Platform Engineering \u00b7 DevSecOps \u00b7 Cloud-Native Development
This project uses free, community, and open-source software only.
---
## 🚀 Quick Start
```bash
# Clone the repo
git clone https://github.com/codetocloudorg/platform-engineering
# Open in GitHub Codespaces (recommended)
# or use the included devcontainer in VS Code
```
| Step | Description |
|------|-------------|
| 📖 **Learn** | [What is Platform Engineering?](#-what-is-platform-engineering) |
| 🏗️ **Explore** | [Reference Architectures](#️-reference-architecture) |
| 🛠️ **Build** | [Development Setup](docs/development_setup.md) |
| 🎓 **Certify** | [Certification Paths](docs/certifications.md) |
---
## 💻 Local Development
Set up a fully configured local development environment with cloud-native tools.
| Environment | Description | Link |
|-------------|-------------|------|
| 🐧 **Kodra** | Ubuntu desktop with Ghostty, VS Code, and 30+ tools | [kodra.codetocloud.io](https://kodra.codetocloud.io) |
| 🪟 **Kodra WSL** | Windows + WSL2 with Docker CE and Azure tooling | [kodra.wsl.codetocloud.io](https://kodra.wsl.codetocloud.io) |
| ☁️ **Codespaces** | Browser-based dev environment using this repo | [Open in Codespaces](https://github.com/codespaces/new?repo=codetocloudorg/platform-engineering) |
The devcontainer in this repo includes: Terraform, OpenTofu, Dagger, Azure CLI, Bicep, and Docker.
---
## 🌐 What is Platform Engineering?
Platform Engineering builds on DevOps principles to enhance **security**, **compliance**, **cost efficiency**, and **time-to-value** by improving developer experiences and enabling self-service within a secure, governed framework.
It’s both a **mindset shift** and a **set of tools and systems** designed to reduce friction in development. Well-designed platforms eliminate toil by streamlining developer workflows and simplifying operations. These platforms include tools that:
- **Empower developers** with self-service options (e.g., starter kits, IDE plugins)
- **Automate common tasks**
- **Encapsulate best practices** into reusable components
- **Provide early feedback** on issues like security risks
- **Manage infrastructure and tools** to simplify operations
This approach enables development teams to focus on building and delivering value efficiently.
### 🚀 Why Platform Engineering?
In today's fast-paced tech environment, organizations need to innovate quickly while maintaining high standards of reliability and security. Platform Engineering addresses these needs by:
- **🚀 Accelerating Development**: Providing developers with easy access to the tools and environments they need, reducing the time spent on setup and configuration.
- **🔒 Enhancing Security**: Implementing consistent security practices across the platform, ensuring compliance and protecting sensitive data.
- **📈 Improving Reliability**: Standardizing infrastructure and processes to reduce errors and increase system stability.
- **💡 Fostering Innovation**: Enabling teams to experiment and iterate rapidly by providing a flexible and scalable platform.
### 🛠️ Platform Tooling Landscape
The platform engineering tooling landscape is rapidly evolving, encompassing a wide range of technologies that streamline developer workflows, enhance automation, and improve infrastructure management. This includes:
- **Internal Developer Platforms (IDPs)**
- **Infrastructure as Code (IaC)** tools
- **GitOps workflows**
- **Service meshes**
- **Cloud-native runtime environments**
For a deeper dive into the current state of platform engineering and its tooling ecosystem, check out this overview:
- **[Platform Engineering Landscape Overview](docs/platform_engineering_landscape.md)** 🚀
### 🔑 Key Components
| Category | Resources |
|----------|----------|
| **Infrastructure** | [IaC](docs/iac.md) · [CI/CD](docs/ci_cd.md) · [Kubernetes](docs/kubernetes.md) · [Cloud-Native](docs/cloud_native.md) |
| **Developer Experience** | [Codespaces](docs/codespaces.md) · [IDPs](docs/internal_development_platforms.md) · [Automation](docs/automation.md) |
| **Operations** | [Observability](docs/observability/README.md) · [Security](docs/security.md) · [AI Infra](docs/ai_infrastructure.md) |
### 🏗️ Reference Architecture
Standardized frameworks for building scalable, secure IDPs with IaC, GitOps, Kubernetes, and self-service portals.
- [Azure Reference Architecture](docs/images/azure_ref_architecture.jpg)
- [OpenShift Reference Architecture](docs/images/red_hat_openshift_ref_architecture.jpg)
---
## 🎓 Learning & Certification
- [Certification Pathways](docs/certifications.md)
- [Platform Engineering Landscape](docs/platform_engineering_landscape.md)
- [Getting Started Guide](docs/GETTING_STARTED.md)
- [FAQ](docs/FAQ.md)
- [Glossary](docs/GLOSSARY.md)
---
## 📚 Guides & Comparisons
- [Platform Engineering vs DevOps](docs/PLATFORM_ENGINEERING_VS_DEVOPS.md)
- [IDP Comparison — Backstage vs Port vs Cortex](docs/IDP_COMPARISON.md)
- [IaC Comparison — Terraform vs OpenTofu vs Bicep vs Pulumi](docs/IAC_COMPARISON.md)
- [Architecture Guide](docs/ARCHITECTURE.md)
- [Roadmap](docs/ROADMAP.md)
---
## 🤝 Contributing
Contributions welcome! [Open issues](https://github.com/codetocloudorg/platform-engineering/issues), [submit PRs](https://github.com/codetocloudorg/platform-engineering/pulls), or review our [contributing guide](CONTRIBUTING.md).
---
<div align="center">
**[eng.codetocloud.io](https://eng.codetocloud.io)** · Made with ❤️ by Code to Cloud
</div>
