Skip to main content

Configuración de la eliminación automática de los codespaces

Los codespaces inactivos se eliminan automáticamente. Puedes elegir cuánto tiempo se conservan los codespaces detenidos, hasta un máximo de 30 días.

De forma predeterminada, los GitHub Codespaces se eliminan automáticamente una vez que se hayan detenido y hayan permanecido inactivos durante 30 días.

Sin embargo, dado que GitHub Codespaces incurre en cargos de almacenamiento, es posible que prefieras reducir el período de retención cambiando el período predeterminado en la configuración personal de GitHub Codespaces. Para más información sobre los cargos de almacenamiento, consulta "Acerca de la facturación de GitHub Codespaces".

Nota: Independientemente de si has establecido o no un período de retención de codespace personal, es una buena idea adquirir el hábito de eliminar codespaces que ya no necesite. Para obtener más información, vea «Borrar un codespace».

La eliminación automática se produce independientemente de si un codespace contiene cambios no subidos. Para evitar la eliminación automática de un codespace, simplemente abre el codespace de nuevo. El período de retención se restablece cada vez que te conectas a un codespace y la cuenta atrás de retención se reinicia cuando se detiene el codespace.

Si un repositorio pertenece a una organización, es posible que el propietario de la organización haya establecido un período de retención para toda la organización. Si este período es menor que el período de retención predeterminado en la configuración personal, el período de retención de la organización se aplicará a los codespaces que cree para este repositorio. Para obtener más información, vea «Restricción del período de retención para codespaces».

Cada codespace tiene su propio período de retención. Por lo tanto, puedes tener codespaces con diferentes períodos de retención. Por ejemplo, si:

  • Has creado un codespace, has cambiado el período de retención predeterminado y, a continuación, has creado otro codespace.
  • Has creado un codespace con GitHub CLI y has especificado un período de retención diferente.
  • Has creado un codespace para un repositorio propiedad de la organización que tiene un período de retención configurado en la organización. La propiedad de los espacios de código que crees se muestra en la página "Tus codespaces".

Nota: El período de retención se especifica en días. Un día representa un período de 24 horas, comenzando en la hora del día en que se detiene un codespace.

Establecimiento de un período de retención predeterminado para los codespaces

  1. En la esquina superior derecha de cualquier página, haga clic en la foto del perfil y, luego, en Settings (Configuración).

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. En la sección "Código, planificación y automatización" de la barra lateral, haz clic en Codespaces.

  3. En "Período de retención predeterminado", escribe el número de días para los que deseas que se conserven los codespaces, de forma predeterminada, una vez detenidos.

    Captura de pantalla de la configuración "Período de retención predeterminado", actualmente establecida en 1 día. Junto al número de días está el botón "Guardar".

    Puedes establecer el período de retención predeterminado entre 0 y 30 días.

    Advertencia: establecer el período en 0 dará lugar a que los codespaces se eliminen inmediatamente cuando los detengas, o cuando se haya agotado el tiempo de espera debido a la inactividad. Para obtener más información, vea «Configuración del periodo de tiempo de espera para GitHub Codespaces».

  4. Haga clic en Save(Guardar).

Al crear un codespace con GitHub CLI, puedes invalidar este valor predeterminado. Si creas un codespace en una organización que especifica un período de retención más corto, el valor de nivel de organización invalida la configuración personal.

Si estableces un período de retención de más de un día, se te enviará una notificación por correo electrónico un día antes de su eliminación.

Comprobación del tiempo restante hasta la eliminación automática

Puedes comprobar si un codespace se va a eliminar automáticamente en breve.

Cuando un codespace inactivo se aproxima al final de su período de retención, se indica en la lista de codespaces en GitHub en https://github.com/codespaces.

Captura de pantalla de una lista de tres codespaces. La tercera de ellas tiene la etiqueta "Expiración en 4 días", resaltada con un contorno naranja oscuro.

Evitar la eliminación automática de codespaces

Es posible que tengas un codespace que desees conservar durante más tiempo que el período de retención definido en la configuración personal. Puedes hacerlo mediante la opción "Mantener codespace". Al seleccionar esta opción, el codespace se conservará indefinidamente hasta que lo elimines manualmente.

Nota: La opción "Mantener codespace" no está disponible para los codespaces propiedad de la organización afectados por una directiva de retención de la organización.

Los codespaces incurren en costos de almacenamiento o consumen la asignación de almacenamiento incluida si el codespace es propiedad de tu cuenta personal de GitHub. Por lo tanto, debes tener en cuenta las implicaciones de costo de almacenar codespaces indefinidamente. Para obtener más información, vea «Acerca de la facturación de GitHub Codespaces».

  1. En la esquina superior izquierda de GitHub.com, selecciona y haz clic en **Codespaces ** para acceder a la página de “Tus codespaces” en github.com/codespaces.

  2. A la derecha del codespace que quieres excluir de la eliminación automática, haz clic en y después en Mantener codespace.

    Captura de pantalla del menú desplegable de un codespace activo. La opción "Mantener codespace" tiene una información sobre herramientas que indica "Expira 10 días después del apagado".

Los codespaces que has excluido de la eliminación automática se indican en la lista de codespaces con el icono de marcador ().

Captura de pantalla de una sección de la lista de codespaces, que muestra un espacio de código etiquetado con el icono de marcador.

Establecimiento de un período de retención para un codespace

Si tienes GitHub CLI instalado, puedes usarlo para trabajar con GitHub Codespaces. A fin de obtener instrucciones de instalación para GitHub CLI, vea el repositorio de GitHub CLI.

Para establecer el período de tiempo del codespace, usa la marca --retention-period con el subcomando codespace create. Especifica el período en días. El período debe estar comprendido entre 0 y 30 días.

gh codespace create --retention-period DAYS

Si no especificas un período de retención al crear un codespace, se usará el período de retención predeterminado o un período de retención de la organización, dependiendo de cuál sea menor. Para obtener información sobre la configuración del periodo de retención predeterminado, haz clic en la pestaña "Explorador web" de esta página.

Para más información sobre GitHub CLI, consulta "Acerca del CLI de GitHub".

Configuración del período de retención

Puedes establecer el período de retención predeterminado en el explorador web, en GitHub.com. De manera alternativa, si usas GitHub CLI para crear un codespace, puedes establecer un período de retención para ese codespace determinado. Para más información, haz clic en la pestaña correspondiente arriba.

Comprobación de si los codespaces se eliminarán automáticamente pronto

Puede comprobar, en la aplicación de escritorio Visual Studio Code, si un codespace se va a eliminar automáticamente pronto.

  1. En VS Code, en la barra de actividad, haz clic en el icono de Explorador remoto.

    Captura de pantalla de la barra Actividades. El icono de la barra lateral "Explorador remoto" (un rectángulo superpuesto por un círculo) está resaltado con un contorno naranja.

    Nota: Si el Explorador remoto no se muestra en la barra de actividad:

    1. Abra la paleta de comandos. Por ejemplo, presionando el Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux).
    2. Escriba: details.
    3. Haz clic en Codespaces: Detalles.
  2. Elige GitHub Codespaces en el menú desplegable situado en la parte superior derecha del explorador remoto, si aún no está seleccionado.

  3. En "GITHUB CODESPACES", coloca el puntero sobre el codespace que te interesa. Se muestra un cuadro emergente que informa sobre el codespace.

    Si el codespace está cerca del final de su período de retención, se incluye una línea que indica cuándo expira este período.

    Captura de pantalla de la barra lateral "Explorador remoto". En el menú contextual de un codespace, "Expira en 19 días" aparece resaltado con un contorno naranja.

Información adicional