Aumentar la capacidad de almacenamiento

El proceso de asignación de nuevos recursos del sistema varía en función de la plataforma de virtualización y el tipo de recurso. Siempre deberás configurar el monitoreo y las alertas de los recursos clave del sistema. Para más información, consulta Supervisión de la instancia.

A medida que más usuarios se unan a tu instancia de GitHub Enterprise Server, es posible que tenga que cambiar el tamaño del volumen de almacenamiento. Consulta la documentación de tu plataforma de virtualización para obtener más información sobre ajuste de tamaño de almacenamiento.

Requisitos y recomendaciones

Requisitos mínimos recomendados

El almacenamiento raíz hace referencia al tamaño total del disco raíz de la instancia. El espacio disponible en el sistema de archivos raíz es el 50 % del almacenamiento total disponible en el disco raíz. Para más información, consulta Información general del sistema.

Aumentar el tamaño de partición de datos

1. Ajusta el disco de volumen existente del usuario utilizando las herramientas de tu plataforma de virtualización.

2. SSH en tu instancia de GitHub Enterprise Server Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Reemplace HOSTNAME por el nombre de host de la instancia, o el nombre de host o la dirección IP de un nodo. Para más información, consulta Acceder al shell administrativo (SSH).

   Shell

   ssh -p 122 admin@HOSTNAME
   

3. Pon el aparato en modo mantenimiento. Para más información, consulta Habilitar y programar el modo de mantenimiento.

4. Reinicie el dispositivo para detectar la nueva asignación de almacenamiento:

   sudo reboot
   

5. Ejecute el comando ghe-storage-extend para expandir el sistema de archivos /data/user:

   ghe-storage-extend
   

6. Asegúrate de que los servicios de sistema estén funcionando correctamente y luego sal del modo de mantenimiento. Para más información, consulta Habilitar y programar el modo de mantenimiento.

Reparación de errores del sistema de archivos

Si se produce un error en la comprobación del sistema de archivos durante ghe-storage-extend, siga estos pasos para repararlo.

Asegúrese de que el dispositivo está en modo de mantenimiento y que no se están ejecutando trabajos en segundo plano:

ghe-maintenance -s
ghe-resque-info

ghe-maintenance -s
ghe-resque-info

1. Detenga y active el volumen de usuario y, a continuación, ejecute una comprobación forzada del sistema de archivos (respuesta automática sí):

   Shell

   sudo systemctl stop ghe-user-disk
   VGNAME=$(sudo lvs --noheadings -o vg_name | grep ghe_storage_ | awk '{ print $1 }')
   sudo vgchange -ay "$VGNAME"
   sudo vgscan --mknodes
   sudo fsck -fy /dev/mapper/${VGNAME}-ghe_user_data
   

2. Vuelva a intentar el cambio de tamaño:

   Shell

   ghe-storage-extend
   

3. Vuelva a montar y compruebe el nuevo tamaño:

   Shell

   sudo systemctl start ghe-user-disk
   df -h /data/user
   

4. Reinicie y compruebe:

   Shell

   sudo reboot
   df -h /data/user
   

Aumentar el tamaño de partición raíz utilizando un nuevo aparato

1. Configura una nueva instancia GitHub Enterprise Server con un disco raíz más grande utilizando la misma versión que tu aparato actual. Para más información, consulta Configuración de una instancia de GitHub Enterprise Server.

2. Apague el dispositivo actual:

   sudo poweroff
   

3. Desconecta el disco de datos de tu aparato actual utilizando las herramientas de tu plataforma de virtualización.

4. Conecta el disco de datos al nuevo aparato con un disco raíz más grande.

Aumentar el tamaño de partición raíz utilizando un aparato existente

Antes de cambiar el tamaño de la partición raíz, determina si el dispositivo tiene una tabla de particiones GUID.

En las instancias creadas a partir de las versiones 3.14 y posteriores de GHES, siga las instrucciones para Aumentar el tamaño de la partición raíz en una tabla de particiones GUID.

En las instancias creadas a partir de versiones de GHES anteriores a la 3.14, siga las instrucciones para Aumentar el tamaño de la partición raíz en una tabla de particiones heredada.

Para comprobar el tipo de tabla de partición, ejecute el siguiente comando. El resultado debe ser gpt o msdos.

sudo lsblk -no pttype $(findmnt -no source /)

1. Conecta un nuevo disco a tu aparato GitHub Enterprise Server.
2. Ejecuta el comando lsblk para identificar el nombre del dispositivo del nuevo disco.

Aumentar el tamaño de la partición raíz en una tabla de particiones GUID

1. Copia de seguridad de la partición de arranque de EFI existente:

   sudo dd if=/dev/disk/by-label/EFIBOOT of=EFIBOOT.bak bs=1M
   

2. Ejecuta el comando parted para dar formato al disco, sustituyendo el nombre del dispositivo por /dev/xvdg:

   sudo parted /dev/xvdg mklabel gpt
   sudo parted -a optimal /dev/xvdg mkpart bios fat32 1MiB 2MiB
   sudo parted /dev/xvdg set 1 bios_grub on
   sudo parted -a optimal /dev/xvdg mkpart efi fat32 2MiB 512MiB
   sudo parted /dev/xvdg set 2 esp on
   sudo parted -a optimal /dev/xvdg mkpart primary 512MiB 50%
   sudo parted /dev/xvdg set 3 boot off
   sudo parted /dev/xvdg set 3 esp off
   sudo parted -a optimal /dev/xvdg mkpart primary 50% 100%
   

3. Si el dispositivo está configurado para la alta disponibilidad o la replicación geográfica, para detener la replicación, ejecuta el comando ghe-repl-stop en cada nodo de réplica:

   ghe-repl-stop
   

4. Para instalar el software GitHub Enterprise Server en el disco en que se acaba de hacer la partición, ejecuta el comando ghe-upgrade. Debes reemplazar PACKAGE-NAME.pkg por la ruta de acceso a un paquete de actualización específico de la plataforma que coincida con la versión de GitHub Enterprise Server que ya se está ejecutando en el dispositivo. No se puede usar un paquete de actualización de revisión universal, como github-enterprise-2.11.9.hpkg. Una vez que se complete el comando ghe-upgrade, los servicios de aplicación finalizarán de forma automática.

   ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg3
   

5. Ejecuta estos comandos en las particiones secundarias del disco recién agregado:

   sudo dd if=/dev/disk/by-label/EFIBOOT of=/dev/xvdg2 bs=1M
   sudo mkfs.ext4 -L fallback /dev/xvdg4
   

6. Apague el dispositivo:

   sudo poweroff
   

7. En el hipervisor, quita el disco raíz anterior y agrega el nuevo disco raíz en la misma ubicación del disco raíz anterior.

8. Inicie el dispositivo.

9. Asegúrate de que los servicios de sistema estén funcionando correctamente y luego sal del modo de mantenimiento. Para más información, consulta Habilitar y programar el modo de mantenimiento.

Si el dispositivo está configurado para alta disponibilidad o replicación geográfica, recuerde iniciar la replicación en cada nodo de réplica mediante ghe-repl-start después de actualizar el almacenamiento en todos los nodos.

Aumentar el tamaño de la partición raíz en una tabla de particiones heredada

1. Ejecuta el comando parted para dar formato al disco, sustituyendo el nombre del dispositivo por /dev/xvdg:

   sudo parted /dev/xvdg mklabel msdos
   sudo parted /dev/xvdg mkpart primary ext4 0% 50%
   sudo parted /dev/xvdg mkpart primary ext4 50% 100%
   

2. Si el dispositivo está configurado para la alta disponibilidad o la replicación geográfica, para detener la replicación, ejecuta el comando ghe-repl-stop en cada nodo de réplica:

   ghe-repl-stop
   

3. Para instalar el software GitHub Enterprise Server en el disco en que se acaba de hacer la partición, ejecuta el comando ghe-upgrade. Debes reemplazar PACKAGE-NAME.pkg por la ruta de acceso a un paquete de actualización específico de la plataforma que coincida con la versión de GitHub Enterprise Server que ya se está ejecutando en el dispositivo. No se puede usar un paquete de actualización de revisión universal, como github-enterprise-2.11.9.hpkg. Una vez que se complete el comando ghe-upgrade, los servicios de aplicación finalizarán de forma automática.

   ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1
   

4. Ejecuta el comando en la partición secundaria del disco recién agregado:

   sudo mkfs.ext4 -L fallback /dev/xvdg2
   

5. Apague el dispositivo:

   sudo poweroff
   

6. En el hipervisor, quita el disco raíz anterior y agrega el nuevo disco raíz en la misma ubicación del disco raíz anterior.

7. Inicie el dispositivo.

8. Asegúrate de que los servicios de sistema estén funcionando correctamente y luego sal del modo de mantenimiento. Para más información, consulta Habilitar y programar el modo de mantenimiento.

Si el dispositivo está configurado para alta disponibilidad o replicación geográfica, recuerde iniciar la replicación en cada nodo de réplica mediante ghe-repl-start después de actualizar el almacenamiento en todos los nodos.