Crear un entorno de gancho de pre-recepción

Un entorno de pre-recepción para Servidor de GitHub Enterprise es un entorno Linux chroot. Dado que los ganchos de pre-recepción ejecutan cada evento de extracción, deberían ser rápidos y livianos. El entorno necesario para tales verificaciones habitualmente será mínimo.

Servidor de GitHub Enterprise brinda un entorno predeterminado que incluye estos paquetes: awk, bash, coreutils, curl, find, gnupg, grep, jq, sed.

Si tu entorno no cumple con uno de los requisitos específicos, como respaldo para un idioma en particular, puedes crear y cargar tu propio entorno chroot en Linux de 64 bits.

En esta guía

• Crear un entorno de gancho de pre-recepción mediante Docker
• Crear un entorno de gancho de pre-recepción mediante chroot
• Cargar un entorno de pre-recepción en Servidor de GitHub Enterprise
• Cargar un entorno de pre-recepción mediante el shell administrativo

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. Este ejemplo usa Alpine Linux y Docker.

1. [Verifica que Docker esté instalado] (https://www.docker.com/) de manera local.

2. Crea el archivo Dockerfile.alpine-3.3 que contiene esta información:

   FROM gliderlabs/alpine:3.3
   RUN apk add --no-cache git bash

3. From the working directory that contains Dockerfile.alpine-3.3, build an image:

   $ docker build -f Dockerfile.alpine-3.3 -t pre-receive.alpine-3.3 .
   > Sending build context to Docker daemon 12.29 kB
   > Step 1 : FROM gliderlabs/alpine:3.3
   >  ---> 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-3.3 pre-receive.alpine-3.3 /bin/true

5. Exporta el contenedor Docker a un archivo tar comprimido como gzip:

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

   Este archivo alpine-3.3.tar.gz está listo para subirse al aparato Servidor de GitHub Enterprise.

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

1. Crea un entorno chroot en Linux.

2. Crea un archivo tar comprimido como gzip del directorio chroot:

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

   For more information about creating a chroot environment see "Chroot" from the Debian Wiki, "BasicChroot" from the Ubuntu Community Help Wiki, or "Installing Alpine Linux in a chroot" from the Alpine Linux Wiki.

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

1. In the upper-right corner of any page, click .

   

2. In the left sidebar, click Business.

   

3. Under your business account's name, click Settings.

   

4. En la barra lateral izquierda, haz clic en Hooks (Ganchos).

   

5. Haz clic en Manage environments (Administrar entornos).

   

6. Haz clic en Add environment (Agregar entorno).

   

7. Escribe el nombre que desees en el campo Environment name (Nombre del entorno).

   

8. Escribe la URL del archivo *.tar.gz que contiene tu entorno.

   

9. Haz clic en Add environment (Agregar entorno).

   

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

1. Carga un archivo *.tar.gz legible que contenga tu entorno a un host web y copia la URL o transfiere el archivo al aparato Servidor de GitHub Enterprise mediante scp. Al usar scp, es posible que necesites ajustar los permisos del archivo *.tar.gz para que todos puedan leerlo.

2. Conecta con el shell administrativo.

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

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