Skip to main content

Administración de precompilaciones

Puedes revisar, modificar y eliminar las configuraciones de precompilación del repositorio.

¿Quién puede utilizar esta característica?

La configuración de nivel de repositorio de GitHub Codespaces está disponible para todos los repositorios que pertenecen a cuentas personales.

En el caso de los repositorios pertenecientes a organizaciones, la configuración de nivel de repositorio de GitHub Codespaces está disponible para las organizaciones en los planes GitHub Team y GitHub Enterprise. Para acceder a la configuración, la organización o su empresa primaria deben haber agregado un método de pago y haber establecido un límite de gasto para GitHub Codespaces. Para obtener más información, vea «Selección de quién posee y paga los codespaces de una organización» y «Planes de GitHub».

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. Consulte "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.

Captura de pantalla de la página "Configuración de precompilación". Se muestran dos configuraciones de precompilación. El botón "Ver salida" de una configuración está resaltado.

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

Captura de pantalla de la salida del flujo de trabajo de precompilación en la pestaña "Acciones" de GitHub.

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.

Captura de pantalla del menú desplegable de opciones de una configuración, que se muestra haciendo clic en un botón etiquetado con tres puntos. La opción "Ver ejecuciones" está seleccionada.

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

Captura de pantalla de la lista "Precompilaciones de codespaces" que muestra un historial de ejecución para los flujos de trabajo de precompilación.

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.

    Captura de pantalla del menú desplegable de opciones de una configuración, que se muestra al hacer clic en un botón etiquetado con tres puntos. La opción "Editar" está seleccionada.

  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.

    Captura de pantalla de una página de autorización para una configuración de precompilación. En esta solicitud se muestran tres permisos.

    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.

    Captura de pantalla del menú desplegable de opciones de una configuración, que se muestra haciendo clic en un botón etiquetado con tres puntos. La opción "Deshabilitar ejecuciones" está seleccionada.

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

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

Nota: para encontrar una lista de los repositorios que contienen una precompilación, obtén una copia del “informe de uso”.

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.

    Captura de pantalla del menú desplegable de opciones de una configuración, que se muestra al hacer clic en un botón etiquetado con tres puntos. La opción "Eliminar" está seleccionada.

  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.

    Captura de pantalla del menú desplegable de opciones de una configuración, que se muestra haciendo clic en un botón etiquetado con tres puntos. La opción "Desencadenador manual" está seleccionada.

Información adicional