Administración de precompilaciones

Acerca de la administración de precompilaciones

Los precompilaciones que configuras para un repositorio se crean y actualizan mediante un flujo de trabajo de GitHub Actions, administrado por el servicio GitHub Codespaces.

Según los valores de una configuración de precompilación, el flujo de trabajo para actualizar la precompilación se puede desencadenar mediante estos eventos:

• Creación o actualización de la configuración de precompilación
• Inserción de una confirmación o una solicitud de incorporación de cambios en una rama configurada para tener precompilaciones
• Cambio de cualquiera de los archivos de configuración del contenedor de desarrollo
• Una programación definida en la configuración de precompilación
• Desencadenamiento manual del flujo de trabajo

Los valores de la configuración de precompilación determinan qué eventos desencadenan automáticamente una actualización de la precompilación. Para obtener más información, vea «Configuración de precompilaciones».

Los usuarios con acceso de administrador a un repositorio pueden comprobar el progreso de las configuraciones de precompilaciones, editarlas y eliminarlas.

Para buscar todos los repositorios que hospedan una configuración de precompilación, debe obtener una copia del informe de uso siguiendo los pasos que se indican en “Visualización del uso de GitHub Codespaces”.

Visualización del progreso de las precompilaciones

Puedes ver el estado actual de la ejecución de flujo de trabajo más reciente para cada configuración de precompilación que haya configurado en la página GitHub Codespaces de la configuración del repositorio. Por ejemplo, "Actualmente en ejecución" o "Última ejecución hace 1 hora".

A fin de ver la salida del registro para la ejecución más reciente del flujo de trabajo de precompilación, haga clic en Ver salida.

Esto muestra la salida de la ejecución más reciente del flujo de trabajo en la pestaña Acciones.

Como alternativa, para ver todas las ejecuciones de flujo de trabajo de precompilación asociadas a la rama especificada, selecciona el menú desplegable y haz clic en Ver ejecuciones.

Esto muestra el historial de ejecución de flujo de trabajo para las precompilaciones de la rama asociada.

Edición de una configuración de precompilación

1. En la página Codespaces de la configuración del repositorio, haga clic en los puntos suspensivos situados a la derecha de la configuración de precompilación que quiera editar.

2. En el menú desplegable, haga clic en Editar.

   

3. Realice los cambios necesarios en la configuración de precompilación y, después, haga clic en Actualizar.

   Si la configuración del contenedor de desarrollo para el repositorio especifica permisos para acceder a otros repositorios, se te mostrará una página de autorización. Para obtener más información sobre cómo se especifica esto en el archivo devcontainer.json, consulte "Administración del acceso a otros repositorios dentro del codespace".

   Haz clic en para ver los detalles de los permisos solicitados.

   

   Haz clic en Autorizar y continuar para conceder estos permisos para la creación de precompilaciones. Como alternativa, puedes hacer clic en Continuar sin autorizar, pero, si lo haces, es posible que los codespaces creados a partir de las precompilaciones resultantes no funcionen correctamente.

   Nota: También se pedirá que concedan estos permisos a los usuarios que creen codespaces que usan esta precompilación.

Deshabilitación de una configuración de precompilación

Si desea pausar la actualización de precompilaciones para una configuración, puede deshabilitar las ejecuciones de flujos de trabajo para la configuración. Deshabilitar las ejecuciones de flujos de trabajo para una configuración de precompilación no elimina ninguna precompilación creada previamente para dicha configuración y, como resultado, se seguirán generando codespaces a partir de una precompilación existente.

Deshabilitar las ejecuciones de flujos de trabajo para una configuración de precompilación resulta útil si necesitas investigar errores en la creación de precompilaciones.

1. En la página Codespaces de la configuración del repositorio, haz clic en los puntos suspensivos situados a la derecha de la configuración de precompilación que quieres deshabilitar.

2. En el menú desplegable, haz clic en Deshabilitar ejecuciones.

   

3. Para confirmar que quieres deshabilitar esta configuración, haz clic en Aceptar.

Eliminación de una configuración de precompilación

Al eliminar una configuración de precompilación también se eliminan todas las precompilaciones creadas anteriormente para esa configuración. Como resultado, poco después de eliminar una configuración, las precompilaciones generadas por esa configuración ya no estarán disponibles al crear un codespace.

Después de eliminar una configuración de precompilación, las ejecuciones de flujo de trabajo para esa configuración que se han puesto en cola o que se han iniciado se seguirán ejecutando. Se mostrarán en el historial de ejecución de flujo de trabajo, junto con las ejecuciones de flujo de trabajo completadas anteriormente.

1. En la página Codespaces de la configuración del repositorio, haga clic en los puntos suspensivos situados a la derecha de la configuración de precompilación que quiera eliminar.

2. En el menú desplegable, haga clic en Eliminar.

   

3. Haga clic en Aceptar para confirmar la eliminación.

Desencadenamiento manual de precompilaciones

Puede ser útil desencadenar manualmente una ejecución de flujo de trabajo para una configuración de precompilación. Por lo general, esto solo es necesario si va a depurar un problema con el flujo de trabajo para una configuración de precompilación.

1. En la página Codespaces de la configuración del repositorio, haga clic en los puntos suspensivos situados a la derecha de la configuración de precompilación cuyo flujo de trabajo quiera desencadenar.

2. En el menú desplegable, haga clic en Desencadenador manual.

   

Información adicional

• "Solución de problemas de precompilaciones"