Ctrlk
Kundensupport
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

GitHub-Voraussetzungen

1

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.

2

Personal Access Token - Classic

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.

  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.

3

Personal Access Token - Fine-Grained

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.

  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.

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.

  1. Klicken Sie auf das Repositories auswählen Dropdown-Menü und aktivieren Sie alle Repositories, die in diesen Token aufgenommen werden sollen.

  2. Unter Berechtigungen, klicken Sie auf Berechtigungen hinzufügen um jede der Berechtigungen in der folgenden Tabelle hinzuzufügen.

  3. 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

Die Metadaten Berechtigung wird automatisch hinzugefügt, wenn eine andere Berechtigung hinzugefügt wird.

  1. Klicken Sie auf Token generieren.

  2. Überprüfen Sie die Token-Einstellungen im Bestätigungsdialog und klicken Sie auf Token generieren.

  3. Kopieren Sie den Token und bewahren Sie ihn sicher auf. Sie benötigen diesen Token, wenn Sie DevOps mit Ihrem GitHub-Konto verbinden.

DevOps mit GitHub verbinden

1

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.

2

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.

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}

  1. Im Benutzername Textfeld geben Sie den GitHub-Benutzernamen ein, mit dem Sie diese Integration verbinden.

  2. Im Token Textfeld geben Sie den GitHub-Personal-Access-Token ein, den Sie im obigen Abschnitt erstellt haben.

  3. Im Repository-Name Textfeld geben Sie den Namen des GitHub-Repositorys ein, mit dem Sie eine Verbindung herstellen.

  4. Klicken Sie auf Verbinden.

  5. 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.

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.

3

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.

4

GitHub-Repository

Der folgende Screenshot zeigt ein Beispiel eines GitHub-Repositorys, das mit DevOps verbunden und synchronisiert ist.

VorherigeÜberblick über Git-Integrationen
NächsteGit-Synchronisierungsaktivität anzeigen

Zuletzt aktualisiert

War das hilfreich?