Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Guía de inicio para GitHub Enterprise Server

Inicia con la configuración y administración de tu instancia de GitHub Enterprise Server.

Esta guía te mostrará cómo configurar, ajustar y administrar tu instancia de GitHub Enterprise Server como un administrador de empresas.

GitHub proporciona dos formas para desplegar GitHub Enterprise.

  • Nube de GitHub Enterprise
  • GitHub Enterprise Server

GitHub hospeda a Nube de GitHub Enterprise. Puedes desplegar y hospedar a GitHub Enterprise Server en tu propio centro de datos o en un proveedor de servicios en la nube que sea compatible.

Para ver un resumen de cómo funciona GitHub Enterprise Server, consulta la sección "Resumen del sistema".

Parte 1: Instalar GitHub Enterprise Server

Para iniciar con GitHub Enterprise Server, necesitarás crear tu cuenta empresarial, instalar la instancia, utilizar la Consola de Administración para la configuración inicial, configurar tu instancia y administrar la facturación.

1. Crear tu cuenta empresarial

Antes de que instales GitHub Enterprise Server, puedes crear una cuenta empresarial en GitHub.com contactando al Equio de Ventas de GitHub. Una cuenta empresarial en GitHub.com es útil para facturar y compartir características con GitHub.com a través de GitHub Connect. Para obtener más información, consulta "Acerca de las cuentas de empresa".

2. Instalar GitHub Enterprise Server

Para iniciar con GitHub Enterprise Server, necesitarás instalar el aplicativo en una plataforma de virtualización que tú elijas. Para obtener más información, consulta "Configurar una instancia del GitHub Enterprise Server."

3. Utilizar la consola de administración

Utilizarás la consola de administración para recorrer el proceso de configuración inicial cuando lances tu instancia de GitHub Enterprise Server por primera vez. También puedes utilizar la consola de administración para administrar los ajustes de instancia tales como la licencia, dominio, autenticación y TLS. Para obtener más información, consulta la sección "Acceder a la consola de administración".

4. Configurar tu instancia de GitHub Enterprise Server

Adicionalmente a la Consola de Administración, puedes utilizar el tablero de administrador de sitio y el shell administrativo (SSH) para administrar tu instancia de GitHub Enterprise Server. Por ejemplo, puedes configurar las aplicaciones y límites de tasa, ver reportes y utilizar utilidades de línea de comandos. Para obtener más información, consulta la sección "Configurar tu empresa".

Puedes utilizar los ajustes de red predeterminados que utiliza GitHub Enterprise Server a través del protocolo de configuración de host dinámico (DHCP), o también puedes configurar los ajustes de red utilizando la consola de la máquina virtual. También puedes configurar un servidor proxy o reglas de firewall. Para obtener más información, consulta la sección "Configurar los ajustes de red".

5. Configurar la disponibilidad alta

Puedes configurar a tu instancia de GitHub Enterprise Server para tener disponibilidad alta para minimizar el impacto de los fallos de hardware e interrupciones de red. Para obtener más información, consulta la sección "Configurar la disponibilidad alta".

6. Configurar una instancia de preparación

También puedes configurar una instancia de pruebas para las modificaciones, planear la recuperación de desastres y probar las actualizaciones antes de aplicarlas a tu instancia de GitHub Enterprise Server. Para obtener más información, consulta "Configurar una instancia de preparación."

7. Designar respaldos y recuperación de desastres

Para proteger tus datos de producción, puedes configurar los respaldos automatizados de tu instancia de GitHub Enterprise Server con Utilidades de respaldo del servidor de GitHub Enterprise. Para obtener más información, consulta "Configurar copias de seguridad en tu aparato"

8. Administrar la facturación para tu empresa

La facturación para todas las organizaciones e instancias de GitHub Enterprise Server conectadas a tu cuenta empresarial se agregará en un cargo de facturación único para todos tus servicios de pago de GitHub.com. Los propietarios y gerentes de facturación de las empresas pueden acceder y administrar los ajustes de facturación de las cuentas empresariales. Para obtener más información, consulta "Administrar la facturación para tu empresa".

Parte 2: Organizar y administrar tu equipo

Como propietario empresarial o administrador, puedes administrar los ajustes a nivel de usuario, repositorio, equipo y organización. Puedes administrar a los miembros de tu empresa, crear y administrar organizaciones, configurar políticas para la administración de repositorios y crear y administrar equipos.

1. Adminsitrar a los miembros de tu instancia de GitHub Enterprise Server

Puedes administrar los ajustes y la actividad de auditoría para los miembros de tu instancia de GitHub Enterprise Server. Puedes promover a un miembro de la empresa para que sea un adminsitrador de sitio, administrar usuarios inactivos, ver la bitácora de auditoría para la actividad de usuario y personalizar los mensajes que verán los miembros empresariales. Para obtener más información, consulta la sección "Administrar usuarios en tu empresa".

2. Crear organizaciones

Puedes crear organizaciones nuevas en tu instancia de GitHub Enterprise Server para que reflejen la estructura de tu grupo o compañía. Para obtener más información, consulta la sección "Crear una organización nueva desde cero".

3. Agregar miembros a las organizaciones

Puedes agregar miembros a las organizaciones en tu instancia de GitHub Enterprise Server mientras seas propietario de una de las organizaciones que quieres administrar. También puedes configurar la visibilidad de la membrecía de la organización. Para obtener más información, consulta las secciones "Agregar personas a tu organización" y "Configurar la visibilidad para la membresía de la organización".

4. Crear equipos

Los equipos son grupos de miembros de organizaciones a los que se pueden otorgar permisos a repositorios específicos como un grupo. Puedes crear equipos individuales o niveles múltiples de equipos anidados en cada una de tus organizaciones. Para obtener más información, consulta las secciones "Crear equipos" y "Agregar personas a los equipos".

5. Configurar niveles de permiso de organización y repositorio

Te recomendamos proporcionar una cantidad limitada de miembros en cada organización y rol de propietario de organización, lo cual proporciona acceso administrativo completo para ellas. Para obtener más información, consulta ´la sección "Niveles de permisos para una organización".

En el caso de las organizaciones en donde tienes permisos administrativos, también puedes personalizar el acceso a cada repositorio con niveles de permiso granulares. Para obtener más información, consulta la sección "Niveles de permisos del repositorio para una organización".

6. Requerir políticas de administración de repositorios

Como propietario de empresa, puedes configurar políticas de administración de repositorios para todas las organizaciones de tu instancia de GitHub Enterprise Server o permitir que las políticas se configuren por separado en cada organización. Para obtener más información consulta la sección "Requerir políticas de administración de repositorios en tu empresa".

Parte 3: Compilar de forma segura

Para aumentar la seguridad de tu instancia de GitHub Enterprise Server, puedes configurar la autenticación para los miembros empresariales, utilizar herramientas y registro en bitácoras de auditoría para permanecer en cumplimiento, configurar las características de seguridad y análisis para tus organizaciones y, opcionalmente, habilitar la GitHub Advanced Security.

1. Autenticar a los miembros empresariales

Puedes utilizar el método de autenticación integrado en GitHub Enterprise Server o puedes elegir entre un proveedor de autenticación establecido, tal como CAS, LDAP o SAML, para integrar tus cuentas existentes y administrar centralmente el acceso de los usuarios a tu instancia de GitHub Enterprise Server. Para obtener más información, consulta la sección "Autenticar usuarios en tu instancia de GitHub Enterprise Server".

También puedes requerir la autenticación bifactorial para cada una de tus organizaciones. Para obtener más información, consulta la sección "Requerir la autenticación bifactorial en una organización".

2. Mantenerse en cumplimiento

Puedes implementar las verificaciones de estado requeridas y confirmar las verificaciones para hacer cumplir los estándares de cumplimiento de tu organización y automatizar los flujos de trabajo de cumplimiento. También puedes utilizar la bitácora de auditoría de tu organización para revisar las acciones que realiza tu equipo. Para obtener más información, consulta las secciones "Requerir la política con ganchos de pre-recepción" y "Generar bitácoras de auditoría".

3. Habilitar las características de la GitHub Advanced Security

Puedes mejorar tu licencia de GitHub Enterprise Server para que incluya la GitHub Advanced Security. Esto proporciona características adicionales que ayudan a los usuarios a encontrar y arreglar problemas de seguridad en su código, tales como el escaneo de secretos y de código. Para obtener más información, consulta la sección "GitHub Advanced Security para tu empresa".

Parte 4: Personalizar y automatizar el trabajo de tu empresa en GitHub

Puedes personalizar y automatizar el trabajo de las organizaciones en tu empresa con GitHub y las OAuth Apps, la API de GitHub, GitHub Actions, el Registro del paquete de GitHub y las Páginas de GitHub.

1. Crear GitHub Apps y OAuth Apps

Puedes crear integraciones con la API de GitHub, tal como las GitHub Apps o OAuth Apps, para utilizarlas en las organizciones de tu empresa para complementar y extender tus flujos de trabajo. Para obtener más información, consulta "Acerca de las apps."

2. Utilizar la API de GitHub

Hay dos versiones de la API de GitHub: la API de REST y la API de GraphQL. Puedes utilizar las API de GitHub para automatizar tareas comunes, respaldar tus datos o crear integraciones que proporcione GitHub Enterprise Server. Para obtener más información, consulta la sección "Acerca de las API de GitHub".

3. Crear GitHub Actions

Con las GitHub Actions, puedes automatizar y personalizar el flujo de desarrollo de tu instancia de GitHub Enterprise Server en GitHub Enterprise Server. Puedes crear tus propias acciones y usar y personalizar acciones compartidas por la comunidad GitHub. Para obtener más información, consulta la sección "Aprende sobre GitHub Actions".

Para obtener más información sobre cómo habilitar y configurar las GitHub Actions en GitHub Enterprise Server, consulta la sección "Iniciar con GitHub Actions para GitHub Enterprise Server".

4. Publicar y administrar el Registro del paquete de GitHub

Registro del paquete de GitHub es un servicio de alojamiento de paquete de software que te permite alojar tus paquetes de software de forma privada o pública y usar paquetes como dependencias en tus proyectos. Para obtener más información, consulta la sección "Introducción al Registro del paquete de GitHub".

Para obtener más información sobre cómo habilitar y configurar el Registro del paquete de GitHub para tu instancia de GitHub Enterprise Server, consulta la sección "Iniciar con el Registro del paquete de GitHub para tu empresa".

5. Uso de Páginas de GitHub

Páginas de GitHub es un servicio de hospedaje de sitios estáticos que toma archivos de HTML, CSS y JavaScript directamente desde un repositorio y publica un sitio web. Puedes habilitar o inhabilitar las Páginas de GitHub para tus miembros empresariales a nivel de organización. Para obtener más información, consulta las secciones "Configurar las Páginas de GitHub para tu empresa" y "Acerca de las Páginas de GitHub".

Parte 5: Conectarse con otros recursos de GitHub

Puedes utilizar GitHub Connect para compartir recursos.

Si eres el propietario tanto de una instancia de GitHub Enterprise Server como de cuenta de organización o de empresa de Nube de GitHub Enterprise, puedes habilitar GitHub Connect. GitHub Connect te permite compartir flujos de trabajo y características específicos entre tu instancia de GitHub Enterprise Server y Nube de GitHub Enterprise, tales como la búsqueda unificada y las contribuciones. Para obtener más información, consulta "Conectar GitHub Enterprise Server a Nube de GitHub Enterprise."

Parte 6: Utilizar los recursos de apoyo y aprendizaje de GitHub

Los miembros de tu empresa pueden aprender más sobre Git y sobre GitHub con nuestros recursos para aprender y puedes obtener el apoyo que necesitas cuando configures y administres tu instancia de GitHub Enterprise Server con GitHub Enterprise Support.

1. Aprender con Laboratorio de aprendizaje de GitHub

Los miembros de tu empresa pueden aprender habilidades nuevas completando proyectos divertidos y realistas en su propio repositorio de GitHub con Laboratorio de aprendizaje de GitHub. Cada curso es una lección didáctica que creó la comunidad de GitHub y que la enseña el amigable bot del Laboratorio de Aprendizaje.

Para obtener más información, consulta la sección "Recursos de aprendizaje de Git y de GitHub".

2. Trabajar con GitHub Enterprise Support

GitHub Enterprise Server incluye el acceso a Soporte para GitHub Enterprise. Soporte para GitHub Enterprise puede ayudarte a solucionar los problemas que se presenten en GitHub Enterprise Server. También puedes elegir registrarte para las características adicionales del Soporte Premium de GitHub. Para obtener más información, consulta la sección "Acerca Soporte para GitHub Enterprise".