Enterprise Server 3.21 ist derzeit als Release Candidate verfügbar.

Freigeben von Mannequins für GitHub Enterprise Importer

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.

In diesem Artikel

          Nachdem Sie eine Migration mit GitHub Enterprise Importer oder Enterprise Live Migrations ausgeführt haben, werden alle Benutzeraktivitäten im migrierten Repository (mit Ausnahme von Git Commits) Platzhalteridentitäten zugeordnet, die als Mannequins bezeichnet werden. Weitere Informationen finden Sie unter [AUTOTITLE](/migrations/overview/mannequins-and-user-activity).

Zurückgewinnen von Mannequins

Sie können Mannequins mit GitHub CLI (empfohlen) oder dem Browser zurückgewinnen.

Hinweis

  • Du kannst Mannequins nicht zurückfordern, nachdem du ein Repository auf eine andere Organisation übertragen hast. Wenn du ein Repository nach der Migration auf eine andere Organisation übertragen möchtest, musst du die Mannequins vor der Übertragung zurückfordern.
  • Beim Wiederherstellen von Mannequins können Sie nur vorhandene Organisationsmitglieder anvisieren. Bevor Sie versuchen, ein Mannequin zurückzufordern, stellen Sie sicher, dass der GitHub Benutzer, den Sie einladen möchten, bereits zur Organisation hinzugefügt wurde.
          GitHub Enterprise Importer migriert keinen Benutzerzugriff auf Repositorys. Nach der Zurückgewinnung der Mannequins, wenn keiner der Benutzer bereits über die Teammitgliedschaft den erforderlichen Zugriff auf das Repository hat, musst du den Benutzern den Zugriff auf das Repository separat zuweisen. Weitere Informationen findest du unter [Verwalten des Zugriffs einer Person auf ein Organisationsrepository](/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository).

Wiederherstellen von Mannequins mit den GitHub CLI (empfohlen)

Sie können die GitHub CLI Mannequins einzeln oder in Massen zurückfordern. Weitere Informationen zum Installieren und Aktualisieren von Migrationserweiterungen für GitHub CLI finden Sie unter Informationen zu GitHub Enterprise Importer.

Der genaue Befehl, den Sie verwenden müssen, hängt davon ab, welche Erweiterung GitHub CLI Sie verwenden.

Zurückfordern von Mannequins mit dem GEI extension

Wenn Ihre Migrationsquelle ein (GitHub) Produkt ist, können Sie Mannekins mit dem GEI extension of the GitHub CLI zurückgewinnen.

  • 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. Anforderungen personal access token finden Sie unter Verwalten des Zugriffs für eine Migration zwischen GitHub-Produkten.
  • Wenn du zu GHE.com migrierst, füge --target-api-url TARGET-API-URL hinzu, wobei TARGET-API-URL die Basis-API-URL für die Unterdomäne deines Unternehmens ist. Beispiel: https://api.octocorp.ghe.com

  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.

      Wenn deine Organisation Enterprise Managed Users verwendet und du die Zuordnungseinladung überspringen möchtest, um das Mannequin sofort zurückzugeben, füge das Argument --skip-invitation hinzu.

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

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

Rückgewinnung von Mannequins mit dem ADO2GH extension

Wenn Ihre Migrationsquelle Azure DevOps ist, können Sie Mannequins mit dem ADO2GH extension of the GitHub CLI zurückfordern.

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

  • Wenn du zu GHE.com migrierst, füge --target-api-url TARGET-API-URL hinzu, wobei TARGET-API-URL die Basis-API-URL für die Unterdomäne deines Unternehmens ist. Beispiel: https://api.octocorp.ghe.com

  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.

      Wenn deine Organisation Enterprise Managed Users verwendet und du die Zuordnungseinladung überspringen möchtest, um das Mannequin sofort zurückzugeben, füge das Argument --skip-invitation hinzu.

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

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

Rückgewinnung von Mannequins mit dem BBS2GH extension

Wenn Ihre Migrationsquelle Bitbucket Server ist, können Sie Mannequins mit dem BBS2GH extension of the GitHub CLI zurückgewinnen.

  • 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. Anforderungen personal access token finden Sie unter Verwalten des Zugriffs für eine Migration von Bitbucket Server.
  • Wenn du zu GHE.com migrierst, füge --target-api-url TARGET-API-URL hinzu, wobei TARGET-API-URL die Basis-API-URL für die Unterdomäne deines Unternehmens ist. Beispiel: https://api.octocorp.ghe.com

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

      Wenn deine Organisation Enterprise Managed Users verwendet und du die Zuordnungseinladung überspringen möchtest, um das Mannequin sofort zurückzugeben, füge das Argument --skip-invitation hinzu.

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

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

Zurückerlangen von Mannequins im Browser

  1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

  2. Wählen Sie eine Organisation aus, indem Sie darauf klicken.

  3. Klicke unter dem Organisationsnamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  4. Klicke im Abschnitt „Access“ der Randleiste auf Import/Export.

  5. Wähle rechts neben dem Mannequin, das du zurückerhalten möchtest, die Option Neu zuordnen aus.

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

  7. Klicke auf Einladen. Standardmäßig erhält das Organisationsmitglied per E-Mail eine Einladung, und das Mannequin wird erst freigegeben, wenn das Mitglied die Einladung akzeptiert.

Anzeigen des Status deiner Attributionseinladungen

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

  • Eingeladen: Dem Benutzer wurde eine Einladung gesendet, er hat jedoch noch nicht auf die Einladung geantwortet.
  • Abgeschlossen: Der Benutzer hat den Vorgang angenommen, oder der Einladungsprozess wurde übersprungen. Die Beiträge des Benutzers wurden neu zugeordnet.
  • Abgelehnt: Der/die Benutzer*in hat sich gegen die Anerkennung der Beiträge des Mannequins entschieden.

  1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

  2. Wählen Sie eine Organisation aus, indem Sie darauf klicken.

  3. Klicke unter dem Organisationsnamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  4. Klicke im Abschnitt „Access“ der Randleiste auf Import/Export.

  5. Klicken Sie unter " Importieren/Exportieren" auf "Attributionseinladungen".

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

Verwalten der Ersteller*innen für Git-Commits

Die Autorenschaft von Git-Commits ist nicht mit Mannequins verknüpft und kann Benutzern nicht durch GitHub das Zurückfordern von Mannequins zugeordnet werden. Stattdessen wird die Commit-Autorenschaft Benutzerkonten auf der Grundlage der E-Mail-Adresse zugeordnet, die beim Erstellen des Commits in Git verwendet wurde GitHub.

In vielen Fällen können Benutzer Commits ihnen selbst zuordnen, indem sie die E-Mail-Adresse, die beim Erstellen des Commits verwendet wurde, ihrem Benutzerkonto auf GitHub hinzufügen. Weitere Informationen finden Sie unter Hinzufügen einer E-Mail-Adresse zu Ihrem GitHub Konto.

Wenn Sie jedoch verwenden Enterprise Managed Users, können Benutzer ihrem Benutzerkonto GitHub keine E-Mail-Adressen hinzufügen und können daher Git-Commits nicht erneut zuweisen. Nur Commits, die von der primären E-Mail-Adresse eines Benutzers bei Ihrem Identitätsanbieter (IdP) erstellt werden, werden an verwaltete Benutzerkonten zugeschrieben.

Darüber hinaus können Commits, die von einer GitHubbereitgestellten noreply E-Mail-Adresse erstellt wurden, nicht neu zugeordnet werden, da Sie einem Benutzerkonto keine E-Mail-Adresse manuell hinzufügen noreply können. Weitere Informationen finden Sie unter E-Mail-Adresse für Commits festlegen.