> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-de/einstellungen/git-integrationen/ein-github-repository-verbinden.md).
# Ein GitHub-Repository verbinden
##  Übersicht
Dieser Artikel zeigt Ihnen, wie Sie Ihr GitHub-Repository mit DevOps verbinden, damit in DevOps-Branches verwaltete Salesforce-Metadaten automatisch mit Ihrem GitHub-Repository synchronisiert werden. Dadurch wird sichergestellt, dass Ihre Branches, Commits und Pull Requests vollständig in Ihrem Git-basierten Versionskontrollsystem nachverfolgt werden.
{% hint style="info" %}
#### GitHub-Personal-Access-Tokens
DevOps verbindet sich mit einem GitHub-Repository mithilfe eines Personal Access Tokens. Sie können entweder einen **Classic** Token oder einen **feingranularen** Token verwenden, abhängig von den Anforderungen Ihres Unternehmens. Die folgenden Anweisungen decken beide Methoden ab, aber Sie müssen nur einen Tokentyp erstellen.
{% endhint %}
## GitHub-Voraussetzungen
{% stepper %}
{% step %}
### Repository
Die DevOps-zu-GitHub-Integration synchronisiert alle Branches, Commits und Pull Requests mit einem einzelnen GitHub-Repository. Dieses Repository kann öffentlich oder privat sein und einer Organisation oder einem einzelnen Benutzer gehören.
Der folgende Screenshot zeigt ein privates Repository **flosum-devops-example** das Teil der **Flosum-Example** Organisation ist.
{% endstep %}
{% step %}
### Personal Access Token - Classic
{% hint style="info" %}
Ein **Classic** Token gilt für jedes Repository, auf das Ihr GitHub-Konto zugreifen kann, und benötigt nur zwei Berechtigungen. Die folgenden Anweisungen erklären, wie Sie einen erstellen.
{% endhint %}
1. Melden Sie sich bei Ihrem GitHub-Konto an.
2. Klicken Sie oben rechts auf Ihr Profilbild, um das Dropdown-Menü zu öffnen.
3. Klicken Sie auf **Einstellungen**.
4. Zugriff **Entwicklereinstellungen > Persönliche Zugriffstokens > Tokens (classic)**.
5. Klicken Sie auf das **Neuen Token generieren** Dropdown-Menü.
6. Klicken Sie auf **Neuen Token generieren (klassisch)**.
7. Geben Sie im **Hinweis** Textfeld eine Beschreibung für den Token ein.
8. Klicken Sie auf das **Ablauf** Dropdown-Menü und wählen Sie das Datum aus, an dem der Token ablaufen soll.
9. Wählen Sie die folgenden **Berechtigungen**:
1. **repo**
2. **workflow**
10. Klicken Sie auf **Token generieren** am unteren Rand der Seite.
11. Kopieren Sie den Token und bewahren Sie ihn sicher auf. Sie benötigen diesen Token, wenn Sie DevOps mit Ihrem GitHub-Konto verbinden.
{% endstep %}
{% step %}
### Personal Access Token - Fine-Grained
{% hint style="info" %}
Ein **feingranularen** Token ist auf die Repositories und Berechtigungen beschränkt, die Sie auswählen, sodass DevOps einen eingeschränkteren Zugriff erhält als ein **Classic** Token. Die folgenden Anweisungen erklären, wie Sie einen erstellen.
{% endhint %}
1. Melden Sie sich bei Ihrem GitHub-Konto an.
2. Klicken Sie oben rechts auf Ihr Profilbild, um das Dropdown-Menü zu öffnen.
3. Klicken Sie auf **Einstellungen**.
4. Zugriff **Entwicklereinstellungen > Persönliche Zugriffstokens > Feingranulare Tokens**.
5. Klicken Sie auf **Neuen Token generieren**.
6. Geben Sie im **Tokennamen** Textfeld eine Beschreibung für den Token ein.
7. Klicken Sie auf das **Ressourceninhaber** Dropdown-Menü den Benutzer oder die Organisation aus, der bzw. die das Repository besitzt, für das dieser Token gedacht ist.
8. Klicken Sie auf das **Ablauf** Dropdown-Menü und wählen Sie das Datum aus, an dem der Token ablaufen soll.
9. Unter **Repository-Zugriff**, wählen Sie **Nur ausgewählte Repositories** aus, um den Geltungsbereich dieses Tokens auf nur die von Ihnen ausgewählten Repositories zu beschränken.
{% hint style="info" %}
Sie können auch **Alle Repositories**, aber der Token hat dann Zugriff auf alle neuen Repositories, die dem **Ressourceninhaber**.
Wählen Sie nicht **Öffentliche Repositories**. Diese Option gewährt Nur-Lese-Zugriff, und die DevOps-GitHub-Integration erfordert Lese- und Schreibberechtigungen.
{% endhint %}
10. Klicken Sie auf das **Repositories auswählen** Dropdown-Menü und aktivieren Sie alle Repositories, die in diesen Token aufgenommen werden sollen.
11. Unter **Berechtigungen**, klicken Sie auf **Berechtigungen hinzufügen** um jede der Berechtigungen in der folgenden Tabelle hinzuzufügen.
12. Setzen Sie das **Zugriff** Dropdown-Menü für jede Berechtigung so, dass es der Spalte Zugriff in der folgenden Tabelle entspricht.
| Berechtigung | Zugriff |
|---|
| Verwaltung | Lesen und schreiben |
| Inhalte | Lesen und schreiben |
| Metadaten | Nur Lesen |
| Webhooks | Lesen und schreiben |
{% hint style="info" %}
Die **Metadaten** Berechtigung wird automatisch hinzugefügt, wenn eine andere Berechtigung hinzugefügt wird.
{% endhint %}
13. Klicken Sie auf **Token generieren**.
14. Überprüfen Sie die Token-Einstellungen im Bestätigungsdialog und klicken Sie auf **Token generieren**.
15. Kopieren Sie den Token und bewahren Sie ihn sicher auf. Sie benötigen diesen Token, wenn Sie DevOps mit Ihrem GitHub-Konto verbinden.
{% endstep %}
{% endstepper %}
## DevOps mit GitHub verbinden
{% stepper %}
{% step %}
### Greifen Sie auf die Git-Integrations-Einstellungen zu
1. Klicken Sie auf **Git-Integration** unter dem **Einstellungen** Abschnitt im Menü der linken Seitenleiste.
2. Klicken Sie auf das **Einstellungen** Registerkarte.
{% endstep %}
{% step %}
### GitHub verbinden
1. Klicken Sie auf das **Diensttyp** Dropdown-Menü.
2. Wählen Sie **GitHub**.
3. Im **Organisation** Textfeld geben Sie den Namen der GitHub-Organisation ein, der das Repository gehört, mit dem Sie eine Verbindung herstellen. Lassen Sie das Feld leer, wenn Sie eine Verbindung zu einem Repository herstellen, das Ihrem GitHub-Benutzerkonto gehört.
{% hint style="info" %}
#### Repository-Pfad
Der GitHub-Repository-Pfad, mit dem die Integration eine Verbindung herzustellen versucht, hängt davon ab, ob das **Organisation** Feld einen Wert enthält.
Wenn das **Organisation** Feld einen Wert enthält, lautet der Repository-Pfad:
* `github.com/{Organization}/{Repository name}`
Wenn das **Organisation** Feld leer ist, lautet der Repository-Pfad:
* `github.com/{Username}/{Repository name}`
{% endhint %}
4. Im **Benutzername** Textfeld geben Sie den GitHub-Benutzernamen ein, mit dem Sie diese Integration verbinden.
5. Im **Token** Textfeld geben Sie den GitHub-Personal-Access-Token ein, den Sie im obigen Abschnitt erstellt haben.
6. Im **Repository-Name** Textfeld geben Sie den Namen des GitHub-Repositorys ein, mit dem Sie eine Verbindung herstellen.
7. Klicken Sie auf **Verbinden**.
8. Wenn die Git-Integration erfolgreich eine Verbindung zu Ihrem GitHub-Repository herstellt, wird eine Erfolgsmeldung angezeigt. Die **GitHub** Verbindung führt dann die Organisation auf und zeigt ihren Status als **Verbunden**.
{% hint style="warning" %}
Wenn die Verbindung der Git-Integration fehlschlägt, überprüfen Sie die Fehlermeldung, um die Ursache zu ermitteln. Sobald das Problem behoben ist, versuchen Sie erneut, eine Verbindung herzustellen.
{% endhint %}
{% endstep %}
{% step %}
### GitHub-Synchronisierung
Sobald die Verbindung hergestellt ist, werden alle DevOps-Branches mit dem GitHub-Repository synchronisiert. Sie können den Synchronisierungsfortschritt in den **Aktivitäten** Registerkarte.
{% endstep %}
{% step %}
### GitHub-Repository
Der folgende Screenshot zeigt ein Beispiel eines GitHub-Repositorys, das mit DevOps verbunden und synchronisiert ist.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.flosum.com/devops/devops-de/einstellungen/git-integrationen/ein-github-repository-verbinden.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
