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

En este artículo

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

Sin embargo, dado que 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 Codespaces. Para más información sobre los cargos de almacenamiento, consulta Acerca de la facturación de Codespaces.

Nota:

Independientemente de si has establecido o no un período de retención personal para los codespaces, es una buena idea adquirir el hábito de eliminar los codespaces que ya no necesites. Consulta 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. Consulta 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 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.

  1. En la esquina superior derecha de cualquier página en , haga clic en la fotografía de perfil y luego en Configuración.

  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. Consulta Configuración del periodo de tiempo de espera para Codespaces.

  4. Haga clic en Save(Guardar).

Al crear un codespace con 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.

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 en https://.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.

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 "Keep 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 . Por lo tanto, debes tener en cuenta las implicaciones de costo de almacenar codespaces indefinidamente. Consulta Acerca de la facturación de Codespaces.

  1. En la esquina superior izquierda de , seleccione y haga clic en **Codespaces ** para acceder a la página de "Sus codespaces" en .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.

Si tienes CLI instalado, puedes usarlo para trabajar con Codespaces. A fin de obtener instrucciones de instalación para CLI, vea el repositorio de 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.

Nota:

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

Puede establecer el período de retención predeterminado en el explorador web, en . De manera alternativa, si usas 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.

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 Codespaces en el menú desplegable situado en la parte superior derecha del explorador remoto, si aún no está seleccionado.

  3. En " 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.