Skip to main content

Restricting the retention period for codespaces

You can set a maximum retention period for any codespaces owned by your organization.

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

Acerca de GitHub Codespaces está disponible para las organizaciones que utilizan GitHub Team o Nube de GitHub Enterprise. Para obtener más información, consulta la sección "Productos de GitHub".

Resumen

Codespaces are automatically deleted after they have been stopped and have remained inactive for a defined number of days. The retention period for each codespace is set when the codespace is created and does not change.

Everyone who has access to Acerca de GitHub Codespaces can configure a retention period for the codespaces they create. The initial setting for this default retention period is 30 days. Individual users can set this period within the range 0-30 days. For more information, see "Configuring automatic deletion of your codespaces."

As an organization owner, you may want to configure constraints on the maximum retention period for codespaces created for the repositories owned by your organization. This can help you to limit the storage costs associated with codespaces that are stopped and then left unused until they are automatically deleted. For more information about storage charges, see "About billing for Acerca de GitHub Codespaces." You can set a maximum retention period for all, or for specific, repositories owned by your organization.

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

Cuando creas una política, eliges si esta aplica a todos los repositorios de tu organización o solo a algunos específicos. If you create an organization-wide policy with a codespace retention constraint, then the retention constraints in any policies that are targeted at specific repositories should be shorter than the restriction configured for the entire organization, or they will have no effect. The shortest retention period - in an organization-wide policy, a policy targeted at specified repositories, or the default retention period in someone's personal settings - is applied.

If you add an organization-wide policy with a retention constraint, you should set the retention period to the longest acceptable period. You can then add separate policies that set the maximum retention to a shorter period for specific repositories in your organization.

Adding a policy to set a maximum codespace retention period

  1. En la esquina superior derecha de GitHub.com, haz clic en tu foto de perfil y luego en Tus organizaciones. Tus organizaciones en el menú de perfil

  2. Junto a la organización, haz clic en Configuración. El botón de configuración

  3. In the "Code, planning, and automation" section of the sidebar, select Codespaces then click Policies.

  4. En la página de "Políticas de los codespaces", haz clic en Crear política.

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

  6. Click Add constraint and choose Retention period.

    Add a constraint for retention periods

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

    Editar la restricción de tiempo de espera

  8. Enter the maximum number of days codespaces can remain stopped before they are automatically deleted, then click Save.

    Set the retention period in days

    Notas:

    • A day, in this context, is a 24-hour period, beginning at the time of day when the codespace was stopped.
    • The valid range is 0-30 days.
    • Setting the period to 0 will result in codespaces being immediately deleted when they are stopped, or when they timeout due to inactivity.
  9. En el área de "Cambiar destino de la política", haz clic en el botón desplegable.

  10. Elige y asea Todos los repositorios o Repositorios seleccionados para determinar a cuáles aplicará esta política.

  11. Si eliges Repositorios seleccionados:

    1. Da clic en .

      Editar los ajustes para la política

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

    3. En la parte inferior de la lista de repositorios, haz clic en Seleccionar repositorios.

      Selecciona los repositorios para esta política

  12. Si quieres agregar otra restricción a la política, haz clic en Agregar restricción y elige otra de ellas. Para obtener información sobre otras restricciones, consulta las secciones "Restringir el acceso a los tipos de máquina", "Restringir la visibilidad de los puertos reenviados" y "Restringir el periodo de inactividad".

  13. After you've finished adding constraints to your policy, click Save.

The policy will be applied to all new codespaces that are created.

Editar una política

Puedes editar una política existente. Por ejemplo, puede que quieras agregar o eliminar restricciones hacia o desde una política.

The retention period constraint is only applied to codespaces when they are created. Editing a policy has no effect on existing codespaces.

  1. Muestra la página de "Políticas del Codespace". For more information, see "Adding a policy to set a maximum codespace retention period."
  2. Haz clic en el nombre de la política que quieres editar.
  3. Haz los cambios requeridos y luego haz clic en Guardar.

Borrar una política

You can delete a policy at any time. Deleting a policy has no effect on existing codespaces.

  1. Muestra la página de "Políticas del Codespace". Para obtener más información, consulta la sección "Agregar una política para configurar un periodo de retención máximo de codespaces".

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

    El botón de borrar para una política