Wiki source code of Git Integration in Fabric
Last modified by Dimitri Rupp on 2026/06/11 09:30
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**On this page**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | = Git Integration in Fabric = | ||
| 6 | |||
| 7 | {{info}} | ||
| 8 | **Zweck:** Ueberblick, wie ein **Fabric-Arbeitsbereich** mit einem **GitHub-Repository** verbunden werden kann. | ||
| 9 | **Voraussetzung:** GitHub-Konto, das der Organisation hinzugefuegt wurde + 2FA aktiviert + Personal Access Token. | ||
| 10 | {{/info}} | ||
| 11 | |||
| 12 | == Ueberblick == | ||
| 13 | |||
| 14 | Zweck dieses Dokuments ist es, einen Ueberblick darueber zu geben, wie ein **Fabric-Arbeitsbereich** mit einem **GitHub-Repository** verbunden werden kann. | ||
| 15 | |||
| 16 | Bevor ein Repository erstellt werden kann, muessen die Benutzer **GitHub-Konten besitzen**, die der **Organisation hinzugefuegt** wurden. Ein **IT-Administrator oder Inhaber** der GitHub-Organisation kann neue Mitglieder zur Organisation einladen. | ||
| 17 | |||
| 18 | == 1. GitHub-User zur Organisation einladen (IT-Admin / Inhaber) == | ||
| 19 | |||
| 20 | * Im **Organisations-Dashboard** zu **„People"** gehen und auf **„Invite member"** klicken. | ||
| 21 | * Den **GitHub-Benutzernamen** oder die **E-Mail-Adresse** des Benutzers eingeben. | ||
| 22 | * Die **Rolle** auswaehlen — **Mitglied** (Standard) oder **Inhaber**, falls erweiterte Berechtigungen erforderlich sind. | ||
| 23 | |||
| 24 | == 2. Zwei-Faktor-Authentifizierung (2FA) einrichten (vom Benutzer) == | ||
| 25 | |||
| 26 | * Zu den **Sicherheitseinstellungen** gehen: **Profilbild → Einstellungen (Settings)**. | ||
| 27 | * In der linken Seitenleiste **„Password and authentication"** waehlen. | ||
| 28 | * **2FA-Einrichtung starten:** Unter **„Two-factor authentication"** auf **„Enable two-factor authentication"** klicken. | ||
| 29 | |||
| 30 | == 3. Integration eines GitHub-Repositories mit einem Fabric-Arbeitsbereich == | ||
| 31 | |||
| 32 | === Anforderungen auf Fabric-Seite === | ||
| 33 | |||
| 34 | Der **Arbeitsbereich** muss durch eine **Fabric-Kapazitaet** unterstuetzt werden. | ||
| 35 | |||
| 36 | === Anforderungen auf GitHub-Seite === | ||
| 37 | |||
| 38 | * Der Benutzer muss Teil der **Collaborators** und **Teams** im Repository sein. | ||
| 39 | * Der Benutzer muss ueber **Schreibzugriff** auf das Repository verfuegen. | ||
| 40 | * Es muss ein **feingranulares persoenliches Zugriffstoken** (**Personal Access Token**, **PAT**) generiert werden, um den Arbeitsbereich mit dem Repository zu verbinden. | ||
| 41 | |||
| 42 | === Vorgehensweise im Fabric-Arbeitsbereich === | ||
| 43 | |||
| 44 | 1. Zu **Workspace-Einstellungen > Git-Integration** navigieren und **GitHub** auswaehlen. | ||
| 45 | 2. Das **Konto hinzufuegen** und das zuvor erstellte **Zugriffstoken** im vorgesehenen Feld eingeben. | ||
| 46 | 3. Den **Arbeitsbereich mit dem Git-Repository verbinden**. | ||
| 47 | 4. Den **Branch** waehlen, auf dem gearbeitet werden soll. | ||
| 48 | |||
| 49 | == Workflow nach erfolgreicher Integration == | ||
| 50 | |||
| 51 | {{mermaid}} | ||
| 52 | flowchart LR | ||
| 53 | DEV[Entwickler<br/>im Fabric-Arbeitsbereich] -->|aendert Item| WS[Fabric Workspace<br/>Lakehouses / Notebooks / Pipelines] | ||
| 54 | WS -->|"Commit + Push"| REPO[GitHub Repository<br/>SPL Tele org] | ||
| 55 | REPO -->|"Pull / Branch"| WS2[Anderer Workspace<br/>z.B. Test / Prod] | ||
| 56 | REPO -.->|Code Review / PR| TEAM[Team Members] | ||
| 57 | |||
| 58 | classDef ws fill:#e3f2fd,stroke:#1976d2,stroke-width:1px | ||
| 59 | classDef git fill:#fff3cd,stroke:#b85c00,stroke-width:1px | ||
| 60 | classDef team fill:#c8e6c9,stroke:#2e7d32,stroke-width:1px | ||
| 61 | class WS,WS2 ws | ||
| 62 | class REPO git | ||
| 63 | class DEV,TEAM team | ||
| 64 | {{/mermaid}} | ||
| 65 | |||
| 66 | == Best Practices == | ||
| 67 | |||
| 68 | * **Branching-Strategie** definieren — z.B. (% style="font-family:monospace" %)main(%%) fuer Produktion, (% style="font-family:monospace" %)dev(%%) fuer Entwicklung, Feature-Branches fuer einzelne Items. | ||
| 69 | * **PAT regelmaessig rotieren** — feingranulare Tokens haben ein Ablaufdatum; vor Ablauf erneuern. | ||
| 70 | * **2FA ist Pflicht** — ohne 2FA verweigert die Organisation den Beitritt. | ||
| 71 | * **Commits sinnvoll dokumentieren** — Workspace-Items werden als JSON / YAML / Notebooks committed; gute Messages sparen Reviewer-Zeit. | ||
| 72 | |||
| 73 | == Related pages == | ||
| 74 | |||
| 75 | * [[Fabric (Hub)>>doc:IT-Wiki.02-Tools.Fabric.WebHome]] | ||
| 76 | * [[Fabric security for admins>>doc:IT-Wiki.06-Security-und-Compliance.Fabric-security-for-admins.WebHome]] — beschreibt das verbundene SPL-Tele-GitHub-Repository und Deployment-Pipelines | ||
| 77 | |||
| 78 | ---- | ||
| 79 | |||
| 80 | == Verwandte Themen == | ||
| 81 | |||
| 82 | //Kuratiert — kann direkt im Editor ergänzt werden:// | ||
| 83 | |||
| 84 | * [[FAQ>>doc:IT-Wiki.02-Tools.Fabric.FAQ.WebHome]] | ||
| 85 | * [[Fabric Notebooks>>doc:IT-Wiki.02-Tools.Fabric.Fabric-Notebooks.WebHome]] | ||
| 86 | * [[Fabric for power users>>doc:IT-Wiki.02-Tools.Fabric.Fabric-for-techies.WebHome]] | ||
| 87 | |||
| 88 | {{include reference="IT-Wiki.Makros.Verwandte-Themen.WebHome"/}} | ||
| 89 | |||
| 90 | ---- | ||
| 91 | **Status:** Migriert — Team-Review ausstehend · **Owner:** //(festlegen)// · **Letzter Review:** 2026-06-11 |