Reclamación de maniquíes para GitHub Enterprise Importer

Después de la migración, puedes asignar el historial de una identidad de marcador de posición, o un maniquí, a un miembro de la organización.

¿Quién puede utilizar esta característica?

Organization owners can reclaim mannequins.

En este artículo

Acerca de los maniquíes

Después de ejecutar una migración con GitHub Enterprise Importer, toda la actividad del usuario en el repositorio migrado (excepto las confirmaciones de Git) se atribuye a identidades de marcador de posición denominadas maniquíes.

Cada maniquí solo tiene un nombre para mostrar, que procede del nombre para mostrar en el repositorio de origen. Los maniquíes no pertenecen a la organización ni tienen acceso al repositorio. Los maniquíes siempre usan el mismo avatar, un octocat fantasma, e incluyen una etiqueta de maniquíes después del nombre para mostrar.

Captura de pantalla del encabezado de un comentario de incidencia. El creador del comentario se etiqueta como maniquí y la etiqueta "Maniquí" está resaltada en naranja oscuro.

Puedes reasignar el historial de cada maniquí a un miembro de la organización con la GitHub CLI o en el explorador. Si usas la datos GitHub CLI, puedes reclamar maniquíes de forma masiva.

La reclamación es opcional y se puede producir en cualquier momento después de que finalice una migración. Por este motivo, puedes permitir que el equipo empiece a trabajar en repositorios migrados antes de la reclamación.

Los maniquíes no se usan para la atribución de confirmaciones de Git. Para más información sobre la atribución de confirmaciones, consulta "Administración de la autoría para confirmaciones de confirmación" a continuación.

Reclamación de maniquíes

Puedes reclamar maniquíes con la GitHub CLI (recomendado) o el explorador.

De forma predeterminada, la reclamación de un maniquí enviará una invitación de atribución al usuario de destino.

El usuario de destino puede optar por aceptar o rechazar la invitación. Después de que un usuario acepte una invitación de atribución, todas las contribuciones anteriormente asignadas al maniquí se atribuirán al usuario en su lugar. En futuras migraciones a la misma organización, las contribuciones del mismo maniquí se reclamarán automáticamente para el mismo usuario.

Si la organización usa Enterprise Managed Users y decides reclamar maniquíes con GitHub CLI, puedes omitir opcionalmente el proceso de invitación, reclamando inmediatamente el maniquí sin la aprobación del usuario.

Notas:

  • No puedes reclamar maniquís si has transferido un repositorio a otra organización. Si quieres transferir un repositorio a otra organización después de la migración, debes reclamar los maniquíes antes de la transferencia.
  • Al reclamar maniquíes, solo puedes dirigirte a los miembros de la organización existentes. Antes de intentar reclamar un maniquí, comprueba que el usuario de GitHub al que quieres invitar ya se ha agregado a la organización.

GitHub Enterprise Importer no migra el acceso de usuario a los repositorios. Después de reclamar maniquíes, si alguno de los usuarios todavía no tiene el acceso adecuado al repositorio por medio de la pertenencia al equipo, debes conceder a los usuarios acceso al repositorio de forma independiente. Para más información, vea "Administración del acceso de un usuario a un repositorio de la organización".

Reclamación de maniquíes con la GitHub CLI (recomendado)

Puede usar la GitHub CLI para reclamar maniquíes individualmente o de forma masiva. Para más información sobre cómo instalar y actualizar extensiones de migración para la datos GitHub CLI, consulta "Acerca de GitHub Enterprise Importer".

El comando exacto que debes usar depende de la extensión de la GitHub CLI que utilices.

Reclamación de maniquíes con la GEI extension

Si el origen de la migración es un producto de GitHub, puedes reclamar maniquíes con la GEI extension of the GitHub CLI.

  • Si todavía no has establecido una variable de entorno GH_PAT para una instancia de personal access token con acceso a la organización de destino, agrega --github-target-pat TOKEN a cada uno de los comandos siguientes y reemplaza TOKEN por el valor personal access token. Para los requisitos de personal access token, consulte “Administración del acceso para una migración entre productos de GitHub”.
  • Si vas a migrar a GHE.com, agrega --target-api-url TARGET-API-URL, donde TARGET-API-URL es la dirección URL de la API base para el subdominio de la empresa. Por ejemplo: https://api.octocorp.ghe.com.

  1. Opcionalmente, para reclamar maniquíes en masa, crea un archivo CSV que los asigne a miembros de la organización.

    • A fin de generar un archivo CSV con una lista de maniquíes para una organización, usa el comando gh gei generate-mannequin-csv y reemplaza DESTINATION por la organización de destino y FILENAME por un nombre de archivo para el archivo CSV resultante.

      Opcionalmente, para incluir maniquíes que ya se han reclamado, agregua la marca --include-reclaimed.

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

    • Edita el archivo CSV, y agrega el nombre de usuario del miembro de la organización que se corresponde a cada maniquí.

    • Guarde el archivo.

  2. Para reclamar maniquíes, usa el comando gh gei reclaim-mannequin.

    • Para reclamar maniquís de forma masiva con el archivo de asignación que has creado antes, reemplaza DESTINATION por la organización de destino y FILENAME por el nombre de archivo de asignación.

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

    • Para reclamar un maniquí individual, reemplaza DESTINATION por la organización de destino, MANNEQUIN por el inicio de sesión de maniquí y USERNAME por el nombre de usuario del miembro de la organización que se corresponda al maniquí.

      Si hay varios maniquíes con el mismo inicio de sesión, puedes reemplazar --mannequin-user MANNEQUIN por --mannequin-ID ID, y cambiar el id. por el del maniquí.

      Si la organización usa Enterprise Managed Users y deseas omitir la invitación de atribución para reclamar el maniquí inmediatamente, añade el argumento --skip-invitation.

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

De manera predeterminada, el miembro de la organización recibirá una invitación por correo electrónico y el maniquí no se reclamará hasta que el miembro acepte la invitación.

Reclamación de maniquíes con la ADO2GH extension

Si el origen de la migración es Azure DevOps, puedes reclamar maniquíes con la ADO2GH extension of the GitHub CLI.

  • Si todavía no has establecido una variable de entorno GH_PAT para una instancia de personal access token con acceso a la organización de destino, agrega --github-target-pat TOKEN a cada uno de los comandos siguientes y reemplaza TOKEN por el valor personal access token. Para los requisitos de personal access token, consulte “Administración del acceso para una migración desde Azure DevOps”.
  • Si vas a migrar a GHE.com, agrega --target-api-url TARGET-API-URL, donde TARGET-API-URL es la dirección URL de la API base para el subdominio de la empresa. Por ejemplo: https://api.octocorp.ghe.com.

  1. Opcionalmente, para reclamar maniquíes en masa, crea un archivo CSV que los asigne a miembros de la organización.

    • A fin de generar un archivo CSV con una lista de maniquíes para una organización, usa el comando gh ado2gh generate-mannequin-csv y reemplaza DESTINATION por la organización de destino y FILENAME por un nombre de archivo para el archivo CSV resultante.

      Opcionalmente, para incluir maniquíes que ya se han reclamado, agregua la marca --include-reclaimed.

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

    • Edita el archivo CSV, y agrega el nombre de usuario del miembro de la organización que se corresponde a cada maniquí.

    • Guarde el archivo.

  2. Para reclamar maniquíes, usa el comando gh ado2gh reclaim-mannequin.

    • Para reclamar maniquís de forma masiva con el archivo de asignación que has creado antes, reemplaza DESTINATION por la organización de destino y FILENAME por el nombre de archivo de asignación.

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

    • Para reclamar un maniquí individual, reemplaza DESTINATION por la organización de destino, MANNEQUIN por el inicio de sesión de maniquí y USERNAME por el nombre de usuario del miembro de la organización que se corresponda al maniquí.

      Si hay varios maniquíes con el mismo inicio de sesión, puedes reemplazar --mannequin-user MANNEQUIN por --mannequin-ID ID, y cambiar el id. por el del maniquí.

      Si la organización usa Enterprise Managed Users y deseas omitir la invitación de atribución para reclamar el maniquí inmediatamente, añade el argumento --skip-invitation.

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

De manera predeterminada, el miembro de la organización recibirá una invitación por correo electrónico y el maniquí no se reclamará hasta que el miembro acepte la invitación.

Reclamación de maniquíes en el explorador

  1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

  2. Junto a la organización, haga clic en Settings.

  3. En la sección "Acceso" de la barra lateral, haz clic en Importar/Exportar.

  4. A la derecha del maniquí que quieras reclamar, haz clic en Volver a atribuir.

  5. En el campo de búsqueda, escribe el nombre de usuario del miembro de la organización al que quieras atribuir las contribuciones de maniquí y, después, haz clic en el miembro.

    Nota: Solo puedes enviar invitaciones de atribución a cuentas de usuario que ya sean miembros de la organización.

  6. Haga clic en Invitar. De manera predeterminada, el miembro de la organización recibirá una invitación por correo electrónico y el maniquí no se reclamará hasta que el miembro acepte la invitación.

Visualización del estado de las invitaciones de atribución

Puedes ver el estado de todas las invitaciones de atribución para la organización.

  • Invitado: se ha enviado una invitación al usuario, pero aún no ha respondido a la invitación.
  • Completado: el usuario ha aceptado o se omitió el proceso de invitación. Se han reasignado las contribuciones del usuario.
  • Rechazado: el usuario ha elegido no ser acreditado por las contribuciones del maniquí.

  1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

  2. Junto a la organización, haga clic en Settings.

  3. En la sección "Acceso" de la barra lateral, haz clic en Importar/Exportar.

  4. En " Importar/Exportar", haz clic en Invitaciones de atribución.

    Captura de pantalla de la página "Importa/Exportar" de un repositorio. Una pestaña, con la etiqueta "Invitaciones de atribución", se resalta en color naranja oscuro.

Administración de la autoría para confirmaciones de Git

La autoría de las confirmaciones de Git no está asociada a los maniquíes y no se puede atribuir a los usuarios de GitHub mediante la reclamación de maniquíes. En su lugar, la autoría de la confirmación se atribuye a las cuentas de usuario en GitHub en función de la dirección de correo electrónico que se haya usado para crear la confirmación en Git.

En muchos casos, los usuarios pueden hacerse "commit" a sí mismos agregando la dirección de correo electrónico usada para hacer "commit" en su cuenta de usuario en GitHub. Para obtener más información, vea «Agregar una dirección de correo electrónico a tu cuenta de GitHub».

Sin embargo, si usa Enterprise Managed Users, los usuarios no pueden agregar direcciones de correo electrónico a su cuenta de usuario en GitHub y, por lo tanto, no podrán reasignar commit de Git. Solo los commit creados por la dirección de correo electrónico principal de un usuario en el proveedor de identidades (IdP) se atribuirán a cuentas de usuario administradas.

Además, no se pueden reasignar los commit creados por una dirección de correo electrónico noreply proporcionada por GitHub, ya que no se puede agregar manualmente una dirección de correo electrónico de noreply a una cuenta de usuario. Para obtener más información, vea «Configurar tu dirección de correo electrónico de confirmación».