feat: add README.md for EDP Release 'PoC' and update docs-url in catalog-info.yaml

This commit is contained in:
Stephan Lo 2024-12-18 15:26:35 +01:00
parent 9acc97880b
commit 30023b23a0
2 changed files with 56 additions and 1 deletions

55
docs/README.md Normal file
View file

@ -0,0 +1,55 @@
# 🌟 EdgeDeveloperPlatform - EDP Release 'PoC'
Telekom MMS & T-Systems, December 2024
> **Tagline:** Change the way we work with IDP's.
---
## 📋 Table of Contents
- [🌟 EdgeDeveloperPlatform - EDP Release 'PoC'](#-edgedeveloperplatform---edp-release-poc)
- [📋 Table of Contents](#-table-of-contents)
- [📖 About the Product](#-about-the-product)
- [🛠️ Application Stack](#-application-stack)
- [📖 Access our Documentation](#-access-our-documentation)
- [📝 License](#-license)
---
## 📖 About the Product
**edpbuilder** is a tool to quickly instantiate and manage **I**nternal **D**eveloper **P**latform's (**IDP**s).
The **E**dge **D**eveloper **P**latform Builder(**edp**builder) 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.
One usecase to demonstrate the capabilities of our tool is the PetClinic Application. (LINK)
### 🛠️ Application Stack
- **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
## 📖 Access our Documentation
Our documentation is designed to be easily accessible regardless of your environment. Here are three primary ways to view it:
1. **in Our Open Sovereign Cloud**
Our documentation can be easily accessed through a Backstage instance hosted on our Open Sovereign Cloud (OSC). Simply log in to our OSC Backstage platform to read through the documentation.
2. **in a local kind Cluster**
Using the edpbuilder, you can set up a local IDP that comes with a Backstage instance containing the documentation.
*[How to set up a local IDP on a kind cluster](docs/userguide/edpbuilder.md)*
3. **Forgejo Repository**
If you prefer direct access, the content of our documentation is centrally defined and maintained within the docs folder of this repository.
---
## 📝 License
[LICENSE]

View file

@ -6,7 +6,7 @@ metadata:
description: This component represents the documentation for our project.
annotations:
backstage.io/techdocs-ref: dir:..
backstage.io/docs-url: ./README.md
backstage.io/docs-url: ./docs/README.md
tags:
- documentation
- docs