Sacar el máximo partido del uso incluido

Las cuentas GitHub personales incluyen una cuota de GitHub Codespaces cada mes.

Hay dos tipos de uso de Codespaces: proceso y almacenamiento. Durante el período de facturación mensual, al usar Codespaces, el uso de proceso y almacenamiento se deduce de la cuota de uso gratuito que se incluye en la cuenta GitHub personal, hasta que se consuma el proceso o el almacenamiento. Una vez alcanzado uno de esos límites, el uso de GitHub Codespaces estará restringido, a menos que hayas configurado un límite de gasto y un método de pago. No podrás crear nuevos codespaces ni abrir codespaces existentes, que se te cobrarían, hasta que renueves la cuota. Si tienes acceso a repositorios que pertenecen a una organización que paga por el uso de GitHub Codespaces, es posible que todavía puedas crear codespaces para esos repositorios.

La cantidad de uso gratuito que se proporciona en tu cuenta personal cada mes está diseñada para permitirte realizar contribuciones de código abierto, o para trabajar en proyectos secundarios, de forma gratuita. No está pensada para que sea suficiente para hacer el trabajo diario de forma gratuita.

Acerca del proceso de Codespaces

El proceso de Codespaces se cuenta en horas de núcleo, que es la suma del tiempo que un codespace está activo, multiplicado por el multiplicador del tipo de máquina del codespace: por ejemplo, un multiplicador de 2 para una máquina de 2 núcleos o un multiplicador de 8 para una máquina de 8 núcleos. Un codespace se activa al crearlo o iniciarlo. Un codespace deja de estar activo cuando se detiene o se elimina, o cuando se detiene o se elimina automáticamente.

El tiempo de espera de inactividad predeterminado, que detiene un codespace después de un período de inactividad, es de 30 minutos. Puedes reducirlo si fuera necesario. Para más información, consulta la sección "Acerca de la facturación por el uso de proceso" de "Acerca de la facturación de GitHub Codespaces".

Acerca del almacenamiento de Codespaces

Puedes ver el uso de almacenamiento de cada uno de los codespaces en la página "Tus codespaces" en github.com/codespaces.

Con fines de facturación, el almacenamiento de Codespaces se cuenta en GB-meses. Se trata de una medida acumulativa del almacenamiento total que consume cada codespace desde la creación hasta la eliminación, además del almacenamiento para las precompilaciones. Para más información, consulta la sección "Facturación para el uso del almacenamiento" de "Acerca de la facturación de GitHub Codespaces".

¿Dónde se fue mi almacenamiento mensual?

La eliminación de espacios de código que no uses evitará el uso innecesario del almacenamiento gratuito incluido en tu cuenta personal. Sin embargo, si has configurado ajustes de precompilación, el almacenamiento incluido puede seguir disminuyendo durante el ciclo de facturación mensual.

Aunque las precompilaciones no aparecen en la página "Sus codespaces", las precompilaciones creadas para un repositorio consumen almacenamiento incluso si actualmente no tiene ningún codespace para ese repositorio. Para evitar esto, puede eliminar las configuraciones de precompilaciones configuradas. Para obtener más información, vea «Acerca de las precompilaciones de GitHub Codespaces» y «Administración de precompilaciones».

Descripción del uso de Codespaces

Puedes comprobar el uso acumulativo de GitHub Codespaces para el ciclo de facturación mensual actual en la configuración de GitHub. Para obtener más información, vea «Visualización del uso de GitHub Codespaces».

Puedes expandir la sección "Horas de uso" y "Almacenamiento" para obtener más información, por ejemplo, para ver la cantidad de almacenamiento consumido que se usaron en las precompilaciones.

Para obtener información más específica (por ejemplo, si quieres saber qué repositorios tienen precompilaciones que consumen almacenamiento), puedes generar un informe de uso. El informe de uso es un archivo CSV que se te envía por correo electrónico. Para más información sobre cómo generar un informe de uso, consulta "Visualización del uso de GitHub Codespaces".

Para ver el uso de Codespaces, filtra el informe de modo que muestre solo las filas que mencionan "Codespaces" en la columna Product.

Uso de almacenamiento para el contenedor de desarrollo base

Si no agregas una configuración de contenedor de desarrollo al repositorio, o si la configuración no especifica una imagen que se va a usar, GitHub crea un contenedor a partir de una imagen de Linux predeterminada. El almacenamiento de contenedores de desarrollo base creados a partir de la imagen predeterminada de Linux es gratuito y no consume el almacenamiento incluido. El uso del almacenamiento solo se basará en los archivos del repositorio y los archivos que agregues posteriormente al codespace, incluidas las extensiones de VS Code. Si usas una imagen base alternativa, el contenedor resultante y todos los archivos del codespace se contarán como almacenamiento usado. Para obtener información sobre lo que se incluye en la imagen de Linux predeterminada, consulta el repositorio devcontainers/images.

Puedes comprobar qué imagen se usó para crear el contenedor de desarrollo de un codespace. En el terminal del codespace, ejecuta este comando.

devcontainer-info

devcontainer-info

Si el contenedor de desarrollo del codespace actual se creó a partir de la imagen predeterminada, la salida de este comando contendrá la siguiente información.

- Definition ID: universal
- Source code repository: https://github.com/devcontainers/images

Sugerencias sobre cómo maximizar la utilización del uso permitido

• Los codespaces consumen el uso de proceso mientras se ejecutan. Si no usas un codespace, detener el codespace evita el uso de proceso innecesario. Para obtener más información, vea «Detención e inicio de un codespace».

• Puedes reducir el tiempo de espera de inactividad de Codespaces en la configuración personal a menos de los 30 minutos predeterminados. Esto acortará el período de inactividad antes de que los codespaces se detengan automáticamente. Esto puede significar un ahorro en el uso del proceso. Para obtener más información, vea «Configuración del periodo de tiempo de espera para GitHub Codespaces».

• Los codespaces consumen almacenamiento mientras existen. Deberías eliminar un codespace que hayas terminado de usar y sepas que no volverás a usar. Para obtener más información, vea «Borrar un codespace».

  Nota: Al eliminar un codespace, no se reducirá la cantidad de almacenamiento usada para el mes de facturación actual, ya que se trata de una cifra acumulativa.

• Configura el período de retención para asegurarte de que los codespaces que te olvides de eliminar se eliminan automáticamente. El período de retención predeterminado es de 30 días. Para obtener más información, vea «Configuración de la eliminación automática de los codespaces».

• Las extensiones de Visual Studio Code consumen almacenamiento. Asegúrate de que solo instalas las extensiones que necesites. Para averiguar cuánto espacio usan las extensiones, ejecuta este comando en el codespace.

  Shell

  du -h -s ~/.vscode-remote/extensions
  

• Supervisa el uso de proceso y almacenamiento; para ello, ve la página de facturación en GitHub.com, https://github.com/settings/billing, y revisa las cifras de la sección "Codespaces".

  Nota: El almacenamiento se calcula cada hora y se agrega al uso de almacenamiento existente. Por lo tanto, el almacenamiento consumido es acumulativo durante el ciclo de facturación mensual. Esto significa que, durante el período de facturación, el valor que ves en la página de facturación solo aumentará o seguirá siendo el mismo. El uso se restablecerá a cero cuando se inicie un nuevo ciclo de facturación. La eliminación de un codespace, o una precompilación, no reducirá la cifra de uso del mes actual, pero reducirá la velocidad a la que se acumula el uso de almacenamiento.

• Asegúrese de que usas precompilaciones solo para tantas versiones y regiones como sea necesario. Para obtener más información, vea «Acerca de las precompilaciones de GitHub Codespaces» y «Acerca de la facturación de GitHub Codespaces».

  Nota: Si se agota el uso de almacenamiento incluido, se deshabilitarán las nuevas precompilaciones hasta que configure un límite de gasto o se renueve la cuota de uso incluida.

• Si has configurado precompilaciones en la configuración de un repositorio, pero no usas GitHub Codespaces para ese repositorio, considera la posibilidad de eliminar la configuración de precompilación para evitar que ese repositorio consuma innecesariamente la asignación de almacenamiento incluida. Al eliminar una configuración de precompilación, se eliminan todas las precompilaciones asociadas, lo que reduce el consumo de almacenamiento desde ese momento. Para obtener más información, vea «Administración de precompilaciones».

  Puedes comprobar si hay configuraciones de precompilación en la página "Codespaces" de la configuración de un repositorio. Para obtener más información, vea «Configuración de precompilaciones».

  Como alternativa, puedes comprobar qué repositorios tienen precompilaciones revisando un informe de uso. Para obtener más información, consulta "Descripción del uso de Codespaces" más arriba.

• El almacenamiento de contenedores creados a partir de la imagen predeterminada de Linux para codespaces es gratuito y no reduce el almacenamiento incluido. Por lo tanto, puedes evitar que el contenedor de desarrollo consuma la asignación de almacenamiento mediante la imagen predeterminada en la configuración del contenedor de desarrollo, en lugar de especificar una imagen más especializada. Para más información, consulta "Introducción a los contenedores dev" y "Uso de almacenamiento para el contenedor de desarrollo base" anteriormente.