edp-doc/README.md

59 lines
2.7 KiB
Markdown
Raw Normal View History

2024-12-20 12:17:03 +00:00
# 🌟 EDP - EdgeDeveloperPlatform
2024-12-20 12:17:03 +00:00
> * Owner: Telekom MMS & T-Systems
> * Date: December 20, 2024
> * Version: Release 1.0.0 ('PoC')
2024-12-20 12:17:03 +00:00
## About this Repository
2024-12-20 12:17:03 +00:00
This repo [`edp-doc`](https://forgejo.edf-bootstrap.cx.fg1.ffm.osc.live/DevFW-CICD/edp-doc) is the documentation repository of the **EDP product**.
2024-12-20 12:17:03 +00:00
## About the EDP Product
2024-12-20 12:17:03 +00:00
EDP is a product developed by the IPCEI-CIS subproject 'edge Developer Framework'. The goal is to provide a cutting edge developer experience for developing and delivering applications in the cloud edge continuum.
2024-12-20 12:17:03 +00:00
## What EDP contains
2024-12-20 12:17:03 +00:00
The EDP product consists of three parts:
2024-12-20 12:17:03 +00:00
1. The platform orchestrator, processing declarative 'platform stack' descriptions
1. The predefined stack for a Demo EDP instance
1. The documentation
2024-12-20 12:17:03 +00:00
### Platform Orchestrator `edpbuilder`
2024-12-20 12:17:03 +00:00
[edpbuilder](https://forgejo.edf-bootstrap.cx.fg1.ffm.osc.live/DevFW/edpbuilder) is a tool to quickly instantiate and manage Internal Development Platforms (IDPs).
The Edge Development Platform Builder (edpbuilder) can easily setup a Kubenetes cluster (local kind cluster or OSC instance) and deploy tools to manage the Kubernetes resources and the software lifecicle of an application.
2024-12-20 12:17:03 +00:00
### Predefined `Demo EDP` Stack
2024-12-17 10:51:16 +00:00
2024-12-20 12:17:03 +00:00
There are predefined stack sets for deploying and orchestrating a whole platform.
2024-12-20 12:17:03 +00:00
At the time of writing (version PoC) we provide the [`Demo EDP`as PoC stack](https://forgejo.edf-bootstrap.cx.fg1.ffm.osc.live/DevFW-CICD/stacks).
2024-12-19 10:57:53 +00:00
2024-12-20 12:17:03 +00:00
#### `Demo EDP` Stack
2024-12-18 16:41:01 +00:00
2024-12-20 12:17:03 +00:00
The `Demo EDP` Stack contains the follwing application components:
2024-12-20 12:17:03 +00:00
* Version-Control: Forgejo
* CI: Forgejo Actions
* CD: ArgoCD
* Monitoring: Grafana, Prometheus, Loki, Promtail
* SSO: Keycloak
* Developer Portal: Backstage
* Secret-Management: OpenBao, external-secrets
* Infrastructur-Provisioning: Crossplane
2024-12-19 10:57:53 +00:00
2024-12-20 12:17:03 +00:00
One usecase to demonstrate the capabilities and development lifecycle flow through all stack components is the [PetClinic Application](./docs/user-documentation/petclinic.md)
2024-12-20 12:17:03 +00:00
### Documentation
2024-12-20 12:17:03 +00:00
The EDP documentation is subject to this repo in folder [`docs`](./docs/). It is created in the [`mkdocs`](https://www.mkdocs.org/) documentation format and natively embedded in the [`Backstage TechDocs` documentation technology](https://backstage.io/docs/features/techdocs/).
2024-12-20 12:17:03 +00:00
Thus it can be read in four ways by
2024-12-20 12:17:03 +00:00
1. [accessing the Backstage portal in a running Demo EDP](./docs/introduction/index.md#doc-in-backstage-in-a-running-demo-edp)
2. [accessing the Backstage portal in a Demo EDP setup on your computer](./docs/introduction/index.md#doc-in-backstage-in-a-demo-edp-setup-on-your-computer)
3. [browsing the documentaion repository](./docs/introduction/index.md#doc-in-the-repository)
4. [browsing in a Backstage simulation on your computer](./docs/introduction/index.md#doc-in-a-backstage-simulation)