Skip to main content

Restricción del período de retención para codespaces

Puedes establecer un período de retención máximo para los codespaces que pertenezcan a tu organización.

¿Quién puede utilizar esta característica?

To manage retention constraints for an organization's codespaces, you must be an owner of the organization.

Las organizaciones que tengan planes de GitHub Team y GitHub Enterprise pueden pagar por la utilizacion de miembros y colaboradores de GitHub Codespaces. Así, las organizaciones podrán acceder a configuraciones y directivas para administrar codespaces pagados por la organización. 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».

Información general

Los GitHub Codespaces se eliminan automáticamente una vez que se hayan detenido y hayan permanecido inactivos durante un número definido de días. El período de retención de cada codespace se establece cuando se crea el codespace y no cambia. El período de retención predeterminado es de 30 días.

Los usuarios de GitHub pueden establecer un período de retención personal de menos de 30 días para los codespaces que crean. Para obtener más información, vea «Configuración de la eliminación automática de los codespaces».

Como propietario de la organización, es posible que te interese configurar restricciones sobre el período máximo de retención de los codespaces creados para los repositorios propiedad de la organización. Esto puede ayudarte a limitar los costos de almacenamiento asociados a los codespaces que se detienen y se dejan sin usar hasta que se eliminan automáticamente. Para más información sobre los cargos de almacenamiento, consulta "Acerca de la facturación de GitHub Codespaces". Puedes establecer un período de retención máximo para todos o algunos repositorios específicos propiedad de tu organización.

Note

Establecer una directiva de retención máxima para un repositorio impide que los usuarios excluyan un codespace de la eliminación automática. La opción "Mantener codespace" no estará disponible para los codespaces creados para ese repositorio. Para obtener más información, vea «Configuración de la eliminación automática de los codespaces».

Configurar políticas específicas para los repositorios y a lo largo de la organización

Cuando crees una política, decide si se aplica a todos los repositorios de la organización o solo a algunos específicos. Si creas una directiva para toda la organización con una restricción de retención de codespace, las restricciones de retención de las directivas dirigidas a repositorios específicos deben ser más cortas que la restricción configurada para toda la organización o no tendrán ningún efecto. Se aplica el periodo de retención más corto, en una directiva para toda la organización, una directiva dirigida a repositorios específicos o el periodo de retención predeterminado en la configuración personal de alguien.

Si agregas una directiva para toda la organización con una restricción de retención, debes establecer el período de retención en el más largo que sea aceptable. Después, puedes agregar otras directivas que establezcan la retención máxima en un período más corto para repositorios concretos de la organización.

Nota: Las directivas de Codespaces solo se aplican a los codespaces que paga tu organización. Si alguien crea un codespace para un repositorio de tu organización por su cuenta, dicho codespace no estará sujeto a estas políticas. Para obtener más información, vea «Selección de quién posee y paga los codespaces de una organización».

Adición de una directiva para establecer el período de retención máximo de codespace

  1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

  2. Junto a la organización, haga clic en Settings.

  3. En la sección "Código, planificación y automatización" de la barra lateral, selecciona Codespaces y, después, haz clic en Directivas.

  4. En la página "Directivas de codespaces", haga clic en Crear directiva.

  5. Ingresa un nombre para tu política nueva.

  6. Haz clic en Agregar restricción y elige Período de retención.

  7. Haz clic en para editar la restricción.

  8. Escribe el número máximo de días que los codespaces pueden permanecer detenidos antes de que se eliminen automáticamente y, luego, haz clic en Guardar.

    Captura de pantalla de una lista desplegable con un campo con la etiqueta "Valor máximo" establecido en 8 días. Debajo se muestran los botones "Cancelar" y "Guardar".

    Note

    • Un día, en este contexto, es un período de 24 horas, comenzando en la hora del día en que se detuvo el codespace.
    • El intervalo válido es de 0 a 30 días.
    • Establecer el período en 0 dará lugar a que los codespaces se eliminen inmediatamente cuando se detengan o cuando se haya agotado el tiempo de espera debido a la inactividad.
  9. De forma predeterminada, la directiva se establece para aplicarse a todos los repositorios; si deseas que se aplique solo a algunos de los repositorios de la organización, haz clic en Todos los repositorios y, a continuación, haz clic en Repositorios seleccionados en el menú desplegable.

    Captura de pantalla de la lista desplegable de selección del repositorio, en la que se muestran las opciones "Todos los repositorios" y "Repositorios seleccionados".

    Nota: Si vas a agregar una restricción a una directiva existente que ya contiene la restricción "Máximo de codespaces por usuario", no podrás aplicar la directiva a los repositorios seleccionados. Esto se debe a que la restricción "Máximo de codespaces por usuario" siempre se aplica a todos los repositorios de la organización.

    Con la opción Repositorios seleccionados seleccionada:

    1. Haga clic en .

      Captura de pantalla del icono de configuración (un símbolo de engranaje) a la izquierda de un botón con la etiqueta "Repositorios seleccionados".

    2. Selecciona los repositorios a los cuales quieres que aplique esta política.

    3. En la parte inferior de la lista de repositorios, haga clic en Select repositories.

      Captura de pantalla de una lista de repositorios, cada uno con una casilla. Hay tres repositorios seleccionados.

  10. Si quieres agregar otra restricción a la directiva, haz clic en Agregar restricción y elige otra restricción. Para obtener información sobre otras restricciones, consulta:

  11. Cuando hayas terminado de agregar restricciones a la directiva, haz clic en Guardar.

La directiva se aplicará a todos los nuevos codespaces que se puedan facturar a tu organización. La restricción del período de retención solo se aplica a la creación del codespace.

Editar una política

Puedes editar una directiva existente. Por ejemplo, puede que te interese agregar restricciones a una directiva o quitarlas.

La restricción de período de retención solo se aplica a los codespaces cuando se crean. La edición de una directiva no tiene ningún efecto sobre los codespaces existentes.

  1. Mostrar la página de "Políticas del Codespaces". Para más información, consulta "Adición de una directiva para establecer un período máximo de retención de codespace".
  2. Haz clic en el nombre de la política que quieres editar.
  3. Junto a la restricción "Período de retención", haz clic en .
  4. Realice los cambios necesarios y haga clic en Save.

Borrar una política

Puedes eliminar una directiva en cualquier momento. La eliminación de una directiva no tiene ningún efecto sobre los codespaces existentes.

  1. Mostrar la página de "Políticas del Codespaces". Para más información, consulta "Adición de una directiva para establecer un período máximo de retención de codespace".

  2. Haz clic en el botón de borrar a la derecha de la política que quieras borrar.

  3. Haz clic en a la derecha de la directiva que quieres eliminar.

    Captura de pantalla de una directiva con el botón Eliminar (icono de papelera) resaltado con un contorno naranja oscuro.