Freigeben von Mannequins für GitHub Enterprise Importer

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 mit GitHub CLI oder im Browser neu zuordnen. Wenn du die GitHub CLI verwendest, kannst du Mannequins in einem Massenvorgang freigeben.

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 Mannequins mit der GitHub CLI (empfohlen) oder im Browser freigeben.

Freigeben von Mannequins mit der GitHub CLI (empfohlen)
Freigeben von Mannequins im Browser

Standardmäßig sendet das Zurückfordern eines Mannequins eine Zuordnungseinladung an den Zielbenutzer.

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

Wenn Ihre Organisation Enterprise Managed Users verwendet und Sie sich dafür entscheiden, Mannequins mit GitHub CLI zurückzufordern, können Sie optional den Einladungsprozess überspringen und den Mannequin ohne Zustimmung des Benutzers sofort zurückfordern.

Note

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 Zurückfordern von Mannequins können Sie nur vorhandene Organisationsmitglieder ansprechen. 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.

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

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 Informationen zu 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
Freigeben von Mannequins mit der ADO2GH extension

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. Informationen zu personal access token-Anforderungen 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

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
```
```
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.
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
```
```
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
```
```
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 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. Informationen zu personal access token-Anforderungen finden Sie unter „Verwalten des Zugriffs für eine Migration von Azure DevOps“.
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

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
```
```
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.
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
```
```
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
```
```
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 im Browser

Wählen Sie in der oberen rechten Ecke von GitHub Ihr Profilfoto aus, und klicken Sie dann auf Ihre Organisationen.
Klicke neben der Organisation auf Einstellungen.
Wähle auf der Randleiste im Abschnitt „Zugriff“ die Option Importieren/Exportieren aus.
Wähle rechts neben der Mannequin, das du freigeben möchtest, die Option Neu zuordnen aus.
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.

Note

Du kannst Zuordnungseinladungen nur an Benutzerkonten senden, die bereits Mitglieder der Organisation sind.
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 Zuordnungseinladungen

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.

Wählen Sie in der oberen rechten Ecke von GitHub Ihr Profilfoto aus, und klicken Sie dann auf Ihre Organisationen.
Klicke neben der Organisation auf Einstellungen.
Wähle auf der Randleiste im Abschnitt „Zugriff“ die Option Importieren/Exportieren aus.
Wähle unter „ Import/Export“ die Option Zuordnungseinladungen aus.

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.