Skip to main content

Crear un entorno de gancho de pre-recepción

Para ejecutar los ganchos de pre-recepción, usa el entorno de pre-recepción predeterminado o crea un entorno personalizado.

Un entorno previo a la recepción para GitHub Enterprise Server es un entorno chroot de Linux. Dado que los ganchos de pre-recepción se ejecutan en todos los eventos de extracción, deberían ser rápidos y livianos. Normalmente, el entorno necesario para tales verificaciones será mínimo.

GitHub Enterprise Server proporciona un entorno predeterminado que incluye estos paquetes: awk, bash, coreutils, curl, find, gnupg, grep, jq y sed.

Si su entorno no cumple con uno de los requisitos específicos, como compatibilidad con un idioma determinado, puede crear y cargar su propio entorno chroot en Linux de 64 bits.

La versión de Git que se usa en el entorno de enlace previo a la recepción debe ser al menos 2.11 o, si usa libgit2, debe usar al menos la versión 0.18. Si usa otra implementación de Git, esta debe admitir rutas de acceso relativas en el archivo info/alternates.

Crear un entorno de gancho de pre-recepción mediante Docker

Puedes usar una herramienta de administración de contenedores de Linux para crear un entorno de gancho de pre-recepción. En este ejemplo se usa Alpine Linux y Docker.

  1. Asegúrese de que Docker está instalado localmente.

  2. Cree el archivo Dockerfile.alpine que contiene esta información:

    FROM alpine:latest
    RUN apk add --no-cache git bash
    
  3. Desde el directorio de trabajo que contiene Dockerfile.alpine, compile una imagen:

    $ docker build -f Dockerfile.alpine -t pre-receive.alpine .
    > Sending build context to Docker daemon 12.29 kB
    > Step 1 : FROM alpine:latest
    >  ---> 8944964f99f4
    > Step 2 : RUN apk add --no-cache git bash
    >  ---> Using cache
    >  ---> 0250ab3be9c5
    > Successfully built 0250ab3be9c5
    
  4. Crea un contenedor:

    docker create --name pre-receive.alpine pre-receive.alpine /bin/true
    
  5. Exporte el contenedor Docker a un archivo tar comprimido en gzip:

    docker export pre-receive.alpine | gzip > alpine.tar.gz
    

    Este archivo alpine.tar.gz está listo para cargarse al dispositivo GitHub Enterprise Server.

Crear un entorno de gancho de pre-recepción mediante chroot

  1. Cree un entorno chroot de Linux.

  2. Cree un archivo tar comprimido en gzip del directorio chroot.

    cd /path/to/chroot
    tar -czf /path/to/pre-receive-environment.tar.gz .
    

    Notas:

    • No incluya las rutas de acceso iniciales del directorio de los archivos en el archivo tar, tales como /path/to/chroot.
    • /bin/sh debe existir y ser ejecutable como punto de entrada al entorno chroot.
    • A diferencia de los chroots tradicionales, el entorno de chroot para enlaces previos a la recepción no requiere el directorio dev.

Para obtener más información sobre cómo crear un entorno chroot, vea "Chroot" en la Wiki de Debian, "BasicChroot" de Community Help Wiki de Ubuntu o "Instalar Alpine Linux en un entorno chroot" en la Wiki de Alpine Linux.

Cargar un entorno de pre-recepción en GitHub Enterprise Server

  1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Configuración de empresa.

    Captura de pantalla del menú desplegable que aparece al hacer clic en la foto de perfil en GitHub Enterprise Server. La opción "Configuración de Enterprise" está resaltada en un contorno naranja oscuro.

  2. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Configuración.

  3. En " Configuración", haz clic en Enlaces.

  4. Haga clic en Manage environments (Administrar entornos).

  5. Haga clic en Add environment (Agregar entorno).

  6. En el campo "Nombre del entorno", escribe el nombre deseado.

  7. En el campo "Cargar entorno desde una dirección URL", escribe la dirección URL del archivo *.tar.gz que contiene el entorno.

  8. Haga clic en Add environment (Agregar entorno).

Cargar un entorno de pre-recepción mediante el shell administrativo

  1. Cargue un archivo *.tar.gz legible que contenga su entorno a un host web y copie la URL o transfiera el archivo al dispositivo GitHub Enterprise Server mediante scp. Al usar scp, es posible que tenga que ajustar los permisos del archivo *.tar.gz para que sea legible en todo el mundo.

  2. Conecta con el shell administrativo.

  3. Usa el comando ghe-hook-env-create y escriba el nombre que quiera para el entorno como primer argumento, y la ruta de acceso local completa o la dirección URL de un archivo *.tar.gz que contenga su entorno como segundo argumento.

    admin@ghe-host:~$ ghe-hook-env-create AlpineTestEnv /home/admin/alpine.tar.gz
    > Pre-receive hook environment 'AlpineTestEnv' (2) has been created.