Skip to main content

Configurar una especificación mínima para las máquinas de los codespaces

Puedes evitar que los tipos de máquina con recursos insuficientes se usen en los GitHub Codespaces de tu repositorio.

Who can use this feature

People with write permissions to a repository can create or edit the codespace configuration.

GitHub Codespaces está disponible para las organizaciones que usen GitHub Team o GitHub Enterprise Cloud. GitHub Codespaces también está disponible como versión beta limitada para usuarios individuales en los planes GitHub Free y GitHub Pro. Para más información, vea "Productos de GitHub".

Información general

Cada codespace que crees se hospeda en una máquina virtual independiente, y normalmente puedes elegir entre diferentes tipos de máquinas virtuales. Cada tipo de máquina tiene recursos diferentes (CPU, memoria, almacenamiento) y, de forma predeterminada, se usa el tipo de máquina con los recursos mínimos. Para obtener más información, consulte "Cambio del tipo de máquina para el codespace".

Si tu proyecto necesita cierto nivel de potencia de cómputo, puedes configurar GitHub Codespaces para que solo los tipos de máquina que cumplan con estos requisitos se puedan usar de forma predeterminada o los puedan seleccionar los usuarios. Esta configuración se realiza en un archivo devcontainer.json.

Importante: El acceso a algunos tipos de máquina puede estar restringido en el nivel de organización. Habitualmente, esto se hace para prevenir que las personas elijan máquinas con recursos superiores, las cuales se cobran en tazas más altas. Si tu repositorio se ve afectado por la política de tipos de máquina a nivel organizacional, debes asegurarte de que no configures una especificación mínima que impida que las personas seleccionen los tipos de máquina disponibles que necesitan. Para obtener más información, consulte "Restringir el acceso a los tipos de máquina".

Configurar una especificación de máquina mínima

  1. Los GitHub Codespaces del repositorio se configuran en un archivo devcontainer.json. Si el repositorio aún no contiene un archivo devcontainer.json, agregue uno ahora. Consulta "Adición de una configuración de contenedor de desarrollo al repositorio".

  2. Edite el archivo devcontainer.json y agregue una propiedad hostRequirements como esta:

    JSON
    "hostRequirements": {
       "cpus": 8,
       "memory": "8gb",
       "storage": "32gb" 
    }

    Puede especificar una de las opciones o todas: cpus, memory y storage.

    Para verificar las especificaciones de los tipos de máquina de GitHub Codespaces que actualmente están disponibles para tu repositorio, realiza el proceso de crear un codespace hasta que veas la elección de tipos de máquina. Para obtener más información, consulte "Crear un codespace".

  3. Guarda el archivo y confirma tus cambios a la rama requerida del repositorio.

    Ahora, cuando crees un codespace para esta rama del repositorio y vayas a las opciones de configuración de creación, solo podrás seleccionar tipos de máquina que coincidan con los recursos que especificaste o los excedan.

    Caja de diálogo que muestra una selección limitada de tipos de máquina

Información adicional