Skip to main content
Wir veröffentlichen regelmäßig Aktualisierungen unserer Dokumentation, und die Übersetzung dieser Seite ist möglicherweise noch nicht abgeschlossen. Aktuelle Informationen findest du in der englischsprachigen Dokumentation.
All products
Migrationen

Freigeben von Mannequins für GitHub Enterprise Importer

In diesem Artikel

Nach der Migration kannst du einem Mitglied deiner Organisation den Verlauf einer Platzhalteridentität oder eines Mannequins zuweisen.

Wer kann dieses Feature verwenden?

Organization owners can reclaim mannequins.

Hinweis: Der GitHub Enterprise Importer liegt derzeit als öffentliche Betaversion vor und kann noch geändert werden.

Informationen zu Mannequins

Nachdem du eine Migration mit dem GitHub Enterprise Importer ausgeführt hast, werden alle Benutzeraktivitäten im migrierten Repository (mit Ausnahme von Git-Commits) Platzhalteridentitäten zugeordnet, die als Mannequins bezeichnet werden.

Jedes Mannequin hat nur einen Anzeigenamen, der vom Anzeigenamen im Quellrepository stammt. Mannequins haben keinen Organisationsmitgliedschaft und keinen Repositoryzugriff. Mannequins verwenden immer den gleichen Avatar, ein Geister-Octocat, und sie enthalten eine Mannequinbezeichnung, die dem Anzeigenamen entspricht.

Screenshot des Headers eines Issuekommentars. Der/die Ersteller*in des Kommentars ist als Mannequin bezeichnet, und die Bezeichnung „Mannequin“ ist dunkelorange umrandet.

Du kannst den Verlauf für jedes Mannequin einem Organisationsmitglied neu zuordnen, indem du eine Zuordnungseinladung mit der GitHub CLI oder im Browser übermittelst. Wenn du die GitHub CLI verwendest, kannst du Mannequins in einem Massenvorgang freigeben. Du kannst auch den Status aller Zuordnungseinladungen anzeigen. Nachdem die Person die Einladung angenommen hat, wird das Mannequin freigegeben.

Die Freigabe ist optional und kann jederzeit nach Abschluss einer Migration erfolgen. Aus diesem Grund kannst du deinem Team erlauben, schon vor der Freigabe mit der Arbeit in migrierten Repositorys zu beginnen.

Mannequins werden nicht für die Zuordnung von Git-Commits verwendet. Weitere Informationen zur Commitzuordnung findest du weiter unten unter Verwalten der Ersteller*innen für Git-Commits.

Freigeben von Mannequins

Du kannst ein Mannequin freigeben, indem du entweder mit der GitHub CLI oder im Browser eine Zuordnungseinladung an ein Organisationsmitglied übermittelst.

Hinweis: Du kannst Zuordnungseinladungen nur an Organisationsmitglieder senden. Bevor du versuchst, ein Mannequin freizugeben, solltest du überprüfen, ob der oder die GitHub-Benutzer*in, den bzw. die du einladen möchtest, bereits der Organisation hinzugefügt wurde.

Das Mitglied kann die Einladung annehmen oder ablehnen. Nachdem ein Mitglied eine Zuordnungseinladung angenommen hat, werden alle Beiträge, die zuvor dem Mannequin zugeordnet waren, dem Mitglied zugeordnet. Bei zukünftigen Migrationsvorgängen zur gleichen Organisation werden alle Beiträge vom selben Mannequin automatisch für dasselbe Mitglied freigegeben.

GitHub Enterprise Importer migriert nicht den Benutzerzugriff auf Repositorys. Wenn nach der Freigabe von Mannequins eines der Mitglieder nicht bereits durch seine Teammitgliedschaft über den erforderlichen Zugriff auf das Repository verfügt, musst du den Mitgliedern den Zugriff auf das Repository separat zuweisen. Weitere Informationen findest du unter Verwalten des Zugriffs einer Einzelperson auf ein Organisationsrepository.

Du kannst Mannequins mit der GitHub CLI (empfohlen) oder im Browser freigeben.

Freigeben von Mannequins mit der GitHub CLI (empfohlen)

Du kannst die GitHub CLI verwenden, um Mannequins einzeln oder als Batch freizugeben. Weitere Informationen zum Installieren und Aktualisieren von Migrationserweiterungen für die GitHub CLI findest du unter Migrieren von Repositorys mit GitHub Enterprise Importer.

Der genaue Befehl, den du verwenden musst, hängt davon ab, welche Erweiterung der GitHub CLI du verwendest.

Freigeben von Mannequins mit der GEI extension

Wenn deine Migrationsquelle ein GitHub-Produkt ist, kannst du Mannequins mit der GEI extension of the GitHub CLI freigeben.

Wenn du noch keine Umgebungsvariable GH_PAT für ein personal access token mit Zugriff auf die Zielorganisation hast, fügen in jedem der folgenden Befehle --github-target-pat TOKEN hinzu, und ersetze TOKEN durch das personal access token. Weitere Informationen zu den Anforderungen an personal access token findest du unter Verwalten des Zugriffs für GitHub Enterprise Importer.

  1. Um optional Mannequins in einem Massenvorgang freizugeben, erstellst du eine CSV-Datei, die Mannequins Organisationsmitgliedern zuordnet.

    • Um eine CSV-Datei mit einer Liste der Mannequins für eine Organisation zu generieren, verwendest du den Befehl gh gei generate-mannequin-csv, und ersetzt DESTINATION durch die Zielorganisation und FILENAME durch einen Dateinamen für die resultierende CSV-Datei.

      Um optional bereits beanspruchte Mannequins einzuschließen, fügst du das Flag --include-reclaimed hinzu.

      Shell
      gh gei generate-mannequin-csv --github-target-org DESTINATION --output FILENAME.csv

    • Bearbeite die CSV-Datei, und füge den Benutzernamen des Organisationsmitglieds hinzu, das den einzelnen Mannequins entspricht.

    • Speicher die Datei.

  2. Verwende den Befehl gh gei reclaim-mannequin, um Mannequins freizugeben.

    • Um Mannequins gleichzeitig mit der zuvor erstellten Zuordnungsdatei freizugeben, ersetzt du DESTINATION durch die Zielorganisation und FILENAME durch den Dateinamen der Zuordnungsdatei.

      Shell
      gh gei reclaim-mannequin --github-target-org DESTINATION --csv FILENAME.csv

    • Um ein einzelnes Mannequin freizugeben, ersetzt du DESTINATION durch die Zielorganisation, MANNEQUIN durch die Anmeldung des Mannequins und USERNAME durch den Benutzernamen des Organisationsmitglieds, das dem Mannequin entspricht.

      Wenn es mehrere Mannequins mit der gleichen Anmeldung gibt, kannst du --mannequin-user MANNEQUIN durch --mannequin-ID ID und ID durch die ID des Mannequins ersetzen.

      Shell
      gh gei reclaim-mannequin --github-target-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME

  3. Das Organisationsmitglied erhält per E-Mail eine Einladung, und das Mannequin wird erst freigegeben, wenn das Mitglied die Einladung akzeptiert.

Freigeben von Mannequins mit der ADO2GH extension

Wenn deine Migrationsquelle Azure DevOps ist, kannst du Mannequins mit der ADO2GH extension of the GitHub CLI freigeben.

Wenn du noch keine Umgebungsvariable GH_PAT für ein personal access token mit Zugriff auf die Zielorganisation hast, fügen in jedem der folgenden Befehle --github-target-pat TOKEN hinzu, und ersetze TOKEN durch das personal access token. Weitere Informationen zu den Anforderungen an personal access token findest du unter Verwalten des Zugriffs für GitHub Enterprise Importer.

  1. Um optional Mannequins in einem Massenvorgang freizugeben, erstellst du eine CSV-Datei, die Mannequins Organisationsmitgliedern zuordnet.

    • Um eine CSV-Datei mit einer Liste der Mannequins für eine Organisation zu generieren, verwendest du den Befehl gh ado2gh generate-mannequin-csv, und ersetzt DESTINATION durch die Zielorganisation und FILENAME durch einen Dateinamen für die resultierende CSV-Datei.

      Um optional bereits beanspruchte Mannequins einzuschließen, fügst du das Flag --include-reclaimed hinzu.

      Shell
      gh ado2gh generate-mannequin-csv --github-org DESTINATION --output FILENAME.csv

    • Bearbeite die CSV-Datei, und füge den Benutzernamen des Organisationsmitglieds hinzu, das den einzelnen Mannequins entspricht.

    • Speicher die Datei.

  2. Verwende den Befehl gh ado2gh reclaim-mannequin, um Mannequins freizugeben.

    • Um Mannequins gleichzeitig mit der zuvor erstellten Zuordnungsdatei freizugeben, ersetzt du DESTINATION durch die Zielorganisation und FILENAME durch den Dateinamen der Zuordnungsdatei.

      Shell
      gh ado2gh reclaim-mannequin --github-org DESTINATION --csv FILENAME.csv

    • Um ein einzelnes Mannequin freizugeben, ersetzt du DESTINATION durch die Zielorganisation, MANNEQUIN durch die Anmeldung des Mannequins und USERNAME durch den Benutzernamen des Organisationsmitglieds, das dem Mannequin entspricht.

      Wenn es mehrere Mannequins mit der gleichen Anmeldung gibt, kannst du --mannequin-user MANNEQUIN durch --mannequin-ID ID und ID durch die ID des Mannequins ersetzen.

      Shell
      gh ado2gh reclaim-mannequin --github-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME

  3. Das Organisationsmitglied erhält per E-Mail eine Einladung, und das Mannequin wird erst freigegeben, wenn das Mitglied die Einladung akzeptiert.

Freigeben von Mannequins im Browser

  1. Klicke in der oberen rechten Ecke von GitHub Enterprise Server auf dein Profilfoto, und klicke dann auf Deine Organisationen.

    Screenshot des Dropdownmenüs unter dem Profilbild von @octocat. „Deine Organisationen“ ist in dunklem Orange eingerahmt. 2. Klicke neben der Organisation auf Einstellungen.

    Screenshot der Organisation „octo-org“ mit dunkelorange umrandeter Schaltfläche „Einstellungen“. 1. Wähle auf der Randleiste im Abschnitt „Zugriff“ die Option Importieren/Exportieren aus.

  2. Wähle rechts neben der Mannequin, das du freigeben möchtest, die Option Neu zuordnen aus.

  3. Gib im Suchfeld den Benutzernamen des Organisationsmitglieds ein, dem du die Beiträge des Mannequins zuordnen möchtest, und wähle dann das Mitglied aus.

    Hinweis: Du kannst Zuordnungseinladungen nur an Benutzerkonten senden, die bereits Mitglieder der Organisation sind.

  4. Klicke auf Einladen.

  5. Das Organisationsmitglied erhält per E-Mail eine Einladung, und das Mannequin wird erst freigegeben, wenn das Mitglied die Einladung akzeptiert.

Anzeigen des Status deiner Zuordnungseinladungen

Du kannst den Status aller Zuordnungseinladungen für deine Organisation anzeigen.

  • Eingeladen: Der/die Benutzer*in hat die Einladung noch nicht beantwortet.
  • Abgeschlossen: Der/die Benutzer*in hat die Einladung angenommen, und die Beiträge wurden neu zugeordnet.
  • Abgelehnt: Der/die Benutzer*in hat sich gegen die Anerkennung der Beiträge des Mannequins entschieden.

  1. Klicke in der oberen rechten Ecke von GitHub Enterprise Server auf dein Profilfoto, und klicke dann auf Deine Organisationen.

    Screenshot des Dropdownmenüs unter dem Profilbild von @octocat. „Deine Organisationen“ ist in dunklem Orange eingerahmt. 2. Klicke neben der Organisation auf Einstellungen.

    Screenshot der Organisation „octo-org“ mit dunkelorange umrandeter Schaltfläche „Einstellungen“. 1. Wähle auf der Randleiste im Abschnitt „Zugriff“ die Option Importieren/Exportieren aus.

  2. Wähle unter „ Import/Export“ die Option Zuordnungseinladungen aus.

    Screenshot der Seite „Import/Export“ für ein Repository. Die Registerkarte „Zuordnungseinladungen“ ist dunkelorange umrandet.

Verwalten der Ersteller*innen für Git-Commits

Mannequins werden nicht als Ersteller von Git-Commits geführt und können nicht durch eine Freigabe GitHub-Benutzer*innen zugeordnet werden. Stattdessen wird die Commiterstellung Benutzerkonten in GitHub basierend auf der E-Mail-Adresse zugeordnet, die zum Erstellen des Commits in Git verwendet wurde.

In vielen Fällen können Benutzer*innen Commits sich selbst zuordnen, indem sie die E-Mail-Adresse hinzufügen, die zum Erstellen des Commits für ihr Benutzerkonto auf GitHub verwendet wird. Weitere Informationen findest du unter Eine E-Mail-Adresse zum GitHub-Konto hinzufügen.

Bei Verwendung von Enterprise Managed Users können Benutzer*innen ihrem Benutzerkonto auf GitHub hingegen keine E-Mail-Adressen hinzufügen und Git-Commits daher nicht neu zuordnen. Nur Commits, die von der primären E-Mail-Adresse eines Benutzers bzw. einer Benutzerin in deinem Identitätsanbieter (IdP) erstellt wurden, werden für verwaltete Benutzerkonten zugeordnet.

Darüber hinaus können Commits, die von einer von GitHub bereitgestellten E-Mail-Adresse vom Typ noreply erstellt wurden, nicht neu zugeordnet werden, da du einem Benutzerkonto keine E-Mail-Adresse vom Typ noreply manuell hinzufügen kannst. Weitere Informationen findest du unter E-Mail-Adresse für Commits festlegen.