# Willkommen auf EDP - Forgejo!

Schön, dass du dabei bist! Hier findest du die wichtigsten Infos zum Einstieg.

EDP ist eine Developer Plattform von Telekom MMS für Developer, gehostet auf der europäischen Open Telekom Cloud.

Forgejo ist das Portal der Plattform, das Git, Continuous Integration und Projektmanagment wie zB Github bereitstellt.

---

## 1. Dein Nutzerkonto

Wir sind in einem 'Friendly-User-Test'.

1. Du bekommst das Konto von unserem Platform-team 'edp-team@telekom.de' bereitgestellt.
2. Nachdem du das Konto hast, [melde dich erstmalig an EDP an](https://edp.buildth.ing) und setze dein eigenes Passwort

---

## 2. Organisationen

Wir organisieren unsere Projekte in **Organisationen**, z. B. `my-org`. Die Namen der Organisation sind global im ganzen EDP, d.h. der Name, den du vergibst, ist einmalig.

Du kannst Organisationen anlegen und andere EDP-User als Mitglieder über Teams dazu einladen, so dass du mit ihnen zusammen in deren Team-Rollen an Repos arbeiten kannst.

---

## 3. Rollen & Teams

Innerhalb jeder Organisation gibt es Teams mit verschiedenen Rechten, Das Team 'Owner' ist per se vorhanden und nicht löschbar.

Weitere Teams kannst du als Mitglied der Owner anlegen und damit die Organisation deiner Arbeit an den Repos gestelten:

| Team          | Berechtigung     |
|---------------|------------------|
| `owners` | Adminrechte      |
| `contributors`| Schreibzugriff   |
| `readers`     | Leserechte       |

---

## 4. Repositories

Repos sind entweder öffentlich, oder privat innerhalb der Organisation oder für dich selbst. 

Wenn du bei öffentlichen Repos mitarbeiten willst, erfolgt das folgendermassen:

1. Forke das Repo (oben rechts: "Fork")
2. Erstelle Pull Requests
3. Oder: Werde Mitglied in einem Team (siehe oben)

Das Clonen geht dann so:

```
# clone with user creds - alternative: use credential-manager
USER=<your username>
PWD=<your password>
git clone https://$USER:$PWD@edp.buildth.ing/<user | org>/<repo.git>

# clone with your personal PAT which you created in your 'Settings -> Applications'
PAT=<your private access token>
git clone https://$USER:$PAT@edp.buildth.ing/<user | org>/<repo.git>
```

---

## 5. Package Management

Forgejo bringt ein [Package Management](https://forgejo.org/docs/latest/user/packages/) mit, und stellt zB. Container Image Repositories bereit.

Hier ist ein kurzes Anwendungsbeispiel mit [`docker login`](https://docs.docker.com/reference/cli/docker/login/#credential-helper-protocol):

```
# use the oci image registry
USER=<your username>
PWD=<your password>
docker login edp.buildth.ing --username $USER --password $PWD

docker pull hello-world
docker tag hello-world edp.buildth.ing/$USER/hello-world
docker push edp.buildth.ing/$USER/hello-world
```

---

## 6. Workflows / CI

Um mit Workflows oder Pipelines zu starten, um zum Beispiel eine CI (Continuous Integration) für ein Repo von dir aufzusetzen, kannst du unser ['fibboacchi'-Beispiel-Projekt](https://edp.buildth.ing/DevFW-CICD/fibonacci_pipeline) forken.

---

## ❓ Fragen oder Probleme?

- Lies das Willkommens-Repo: [`edp-team/welcome`](https://edp.buildth.ing/edp-team/welcome)
- Bei Feedback oder Ideen für Erweiterungen bitte [hier: `edp-team/feedback`](https://edp.buildth.ing/edp-team/feedback) einen Issue erzeugen
- Oder schreibe uns an edp-team@telekom.de
- Die allgemeine [Benutzer-Dokumentation von Forgejo](https://forgejo.org/docs/latest/user/) hilft beim Managen deiner Organisationen und Projekte.

---