Configuración de los límites de frecuencia

Acerca de los límites de frecuencia para GitHub Enterprise Server

Para evitar el uso excesivo de recursos en tu instancia de GitHub Enterprise Server que podrían afectar a la disponibilidad o al rendimiento de la instancia para todos los usuarios, puedes configurar los límites de frecuencia. Los límites de frecuencia son configurables para GitHub Enterprise Server APIs y GitHub Actions.

Implementa los límites de frecuencia cuidadosamente y comunícate con frecuencia con los usuarios a medida que ajustes los límites. Para evitar interrumpir el trabajo de los usuarios, GitHub recomienda empezar con límites de frecuencia permisivos y ajustar gradualmente los límites para adaptarlos a tu entorno.

También puedes configurar los límites de frecuencia para los intentos de autenticación en Consola de administración. Para obtener más información, vea «Administración del acceso a la Consola de administración».

Habilitación de límites de frecuencia para GitHub Enterprise Server APIs

Un número excesivo de solicitudes a GitHub Enterprise Server APIs puede afectar a la disponibilidad y al rendimiento de la instancia. Para obtener más información sobre cómo afectan los límites de velocidad para la API a los usuarios, consulta "Límites de volumen de la API de REST".

Puede excluir una lista de usuarios de los límites de frecuencia de API mediante la utilidad ghe-config en el shell administrativo. Para obtener más información, vea «Utilidades de la ea de comandos».

1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haga clic en .

2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

3. En la barra lateral " Administrador del sitio", haz clic en Consola de administración .

4. En "Limitación de frecuencia", seleccione Habilitar limitación de frecuencia de API HTTP.

5. Escribe los límites para las solicitudes autenticadas y no autenticadas para cada API o acepta los límites predeterminados que aparecen completados.

6. En la barra lateral "Configuración" , haga clic en Guardar configuración.

   Nota: Al guardar la configuración en la Consola de administración se restablecen los servicios de sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

7. Espera que se complete la fase de configuración.

Habilitar los límites de tasa secundarios

Si se establecen límites de frecuencia secundarios, se protege el nivel general de servicio en tu instancia de GitHub Enterprise Server.

1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haga clic en .

2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

3. En la barra lateral " Administrador del sitio", haz clic en Consola de administración .

4. En "Limitación de frecuencia", seleccione Habilitar limitación de frecuencia secundaria.

5. Escribe límites para las solicitudes totales, límite de CPU y límite de CPU para búsquedas, o acepta los límites predeterminados que aparecen completados.

6. En la barra lateral "Configuración" , haga clic en Guardar configuración.

   Nota: Al guardar la configuración en la Consola de administración se restablecen los servicios de sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

7. Espera que se complete la fase de configuración.

Habilitación de los límites de frecuencia para Git

Si un miembro del personal de GitHub lo ha recomendado, puedes aplicar límites de frecuencia de Git por red de repositorios o por identificador de usuario. Los límites de tasa de Git se expresan en operaciones simultáneas por minuto y se adaptan en función de la carga de CPU actual.

1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haga clic en .

2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

3. En la barra lateral " Administrador del sitio", haz clic en Consola de administración .

4. En "Limitación de frecuencia", seleccione Habilitar limitación de frecuencia de Git.

5. En "Límite de red del repositorio", escribe un límite para cada red del repositorio.

6. En "Límite de identificador de usuario", escribe un límite para cada identificador de usuario.

7. En la barra lateral "Configuración" , haga clic en Guardar configuración.

   Nota: Al guardar la configuración en la Consola de administración se restablecen los servicios de sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

8. Espera que se complete la fase de configuración.

Configuración de límites de frecuencia para GitHub Actions

Puedes aplicar un límite de frecuencia a las ejecuciones de flujo de trabajo de GitHub Actions. Para obtener más información sobre GitHub Actions, consulta "Acerca de las GitHub Actions para las empresas".

Acerca de los límites de frecuencia para GitHub Actions

Tu instancia GitHub Enterprise Server asigna cada trabajo de flujo de trabajo GitHub Actions a un ejecutor. Si la instancia no puede asignar inmediatamente un trabajo a un ejecutor disponible, el trabajo esperará en una cola hasta que un ejecutor esté disponible. Si GitHub Actions experimenta una carga elevada de forma sostenida, la cola puede realizar copias de seguridad y el rendimiento de tu instancia de GitHub Enterprise Server podría empeorar.

Para evitar esta degradación del rendimiento, puedes configurar un límite de frecuencia para GitHub Actions. Este límite de frecuencia se expresa en ejecuciones de trabajos por minuto. GitHub Enterprise Server calcula y aplica el límite de frecuencia para la suma total de todas las ejecuciones de trabajo en la instancia. Si las ejecuciones superan el límite de frecuencia, las ejecuciones adicionales darán un error en lugar de entrar en la cola. El siguiente error aparecerá en las anotaciones de la ejecución.

Has superado el límite de frecuencia de las solicitudes de ejecución de flujo de trabajo. Espera antes de reintentar la ejecución.

Un límite de frecuencia adecuado protege tu instancia de GitHub Enterprise Server frente al uso anómalo de GitHub Actions sin interferir con las operaciones diarias. El umbral exacto depende de los recursos disponibles de la instancia y del perfil de carga general. Para obtener más información sobre los requisitos de hardware de GitHub Actions, consulta "Iniciar con GitHub Actions para GitHub Enterprise Server".

De forma predeterminada, el límite de frecuencia para GitHub Actions está deshabilitado. Dado que GitHub Enterprise Server puede controlar picos temporales de uso sin degradación del rendimiento, este límite de frecuencia está pensado para protegerse frente a una carga elevada sostenida. Se recomienda dejar deshabilitado el límite de frecuencia a menos que estés experimentando problemas de rendimiento. En algunos casos, Soporte de GitHub puede recomendar que habilites un límite de frecuencia para GitHub Actions.

Habilitación o deshabilitación de los límites de frecuencia para GitHub Actions

1. 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 obtener más información, vea «Acceder al shell administrativo (SSH)».

   Shell

   ssh -p 122 admin@HOSTNAME
   

2. Para habilitar y configurar el límite de frecuencia, ejecuta los dos comandos siguientes, reemplazando RUNS-PER-MINUTE por el valor de su elección.

   ghe-config actions-rate-limiting.enabled true
   ghe-config actions-rate-limiting.queue-runs-per-minute RUNS-PER-MINUTE
   

3. Para deshabilitar el límite de frecuencia después de habilitarlo, ejecuta el siguiente comando.

   ghe-config actions-rate-limiting.enabled false
   

4. Para aplicar la configuración, ejecuta el siguiente comando.

   ghe-config-apply
   

5. Espera que se complete la fase de configuración.