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 Mannequins und Benutzeraktivitäten.

Zurückgewinnen von Mannequins

Sie können Mannequins mit GitHub CLI (empfohlen) oder dem Browser freigeben.

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 finden Sie unter Den Zugriff einer Person auf ein Repository einer Organisation verwalten.

Freigeben von Mannequins mit der GitHub CLI (empfohlen)

Sie können mit der GitHub CLI Mannequins einzeln oder in Massen freigeben. 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.

Freigeben von Mannequins mit der GEI extension

Wenn Ihre Migrationsquelle ein GitHub-Produkt ist, können Sie 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. 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.

Freigeben von Mannequins mit der 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. Anforderungen personal access token finden Sie unter Zugriff verwalten.
  • 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.

Freigeben von Mannequins mit der 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 Enterprise Managed Users verwenden, können Benutzer ihrem Benutzerkonto in 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 verwaltete Benutzerkonten zugeordnet.

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.