Información general
Habitualmente, cuando creas un codespace, se te ofrece una selección de especificaciones para la máquina que lo ejecutará. Puedes elegir el tipo de máquina que se acople mejor a tus necesidades. Para obtener más información, vea «Creación de un codespace para un repositorio».
Si pagas por utilizar GitHub Codespaces, entonces tu elección de tipo de máquina afectará cuánto se te factura. El coste del proceso de un codespace es proporcional al número de núcleos de procesador del tipo de máquina que elijas. Por ejemplo, el coste del proceso de usar un codespace durante una hora en una máquina de 16 núcleos es ocho veces mayor que en una máquina de dos núcleos. Para más información sobre los precios, consulta "Acerca de la facturación de GitHub Codespaces".
Como propietario de organización, podrías querer configurar restricciones en los tipos de máquina que están disponibles. Por ejemplo, si el trabajo en tu organización no requiere de una potencia de cómputo o espacio de almacenamiento significativos, puedes eliminar las máquinas con muchos recursos de la lista de opciones que las personas pueden elegir. Para ello, define una o más políticas en la configuración de GitHub Codespaces de la organización.
Comportamiento cuando configuras una restricción de tipo de máquina
Si hay espacios de codespaces que ya no se ajustan a una directiva definida, estos codespaces seguirán funcionando hasta que se detengan o agoten el tiempo de espera. Cuando el usuario intenta reanudar el codespace, se muestra un mensaje que le indica que el tipo de máquina seleccionado actualmente ya no está permitido para esta organización y le pide que elija un tipo de máquina alternativo.
Si eliminas tipos de máquina con especificaciones más altas que la configuración de GitHub Codespaces requiere para un repositorio individual de tu organización, no se podrá crear un codespace en dicho repositorio. Cuando alguien intente crear un codespace, verá un mensaje que indica que no hay tipos de máquina válidos disponibles que cumplan los requisitos de la configuración de GitHub Codespaces del repositorio.
Nota: Cualquiera que pueda editar el archivo de configuración devcontainer.json
en un repositorio puede establecer una especificación mínima para las máquinas que se pueden usar para los codespaces. Para obtener más información, vea «Configurar una especificación mínima para las máquinas de los codespaces».
Si el hecho de configurar una política para los tipos de máquina impide el uso de GitHub Codespaces para un repositorio en particular, hay dos opciones:
- Puedes ajustar tus políticas para que eliminen específicamente las restricciones del repositorio afectado.
- Cualquiera que tenga un codespace al cuál ya no puedan acceder debido a la política nueva puede exportar su codespace a una rama. Esta rama contendrá todos los cambios de su codespace. Pueden abrir un codespace nuevo en esta rama con un tipo de máquina compatible o trabajar en ella localmente. Para obtener más información, vea «Exportar los cambios a una rama».
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. Si configuras una política a lo largo de la organización, entonces cualquier política que configures para los repositorios individuales debe de caer dentro de las restricciones que se configuraron a nivel organizacional. El agregar políticas hace que la elección de máquinas sea más restrictiva, no menos.
Por ejemplo, podrías crear una política en toda la organización, la cual restrinja los tipos de máquina a aquellos de 2 o 4 núcleos. Entonces podrás configurar una política para el repositorio "A" que lo restrinja a máquinas de 2 núcleos. El configurar una política para un repositorio "A", la cual lo restrinja a máquinas de 2, 4 u 8 núcleos, daría como resultado una elección de solo máquinas de 2 y 4 núcleos, ya que la política organizacional previene el acceso a máquinas de 8 núcleos.
Si agregas una política a nivel organizacional, deberías configurarla en la elección de tipos de máquina más grande que deberá estar disponible para cualquier repositorio de tu organización. Entonces podrás agregar las políticas específicas para los repositorios y así restringir aún más la elecció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».
Agregar una política para limitar los tipos de máquina disponibles
-
En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.
-
Junto a la organización, haga clic en Settings.
-
En la sección "Código, planificación y automatización" de la barra lateral, selecciona Codespaces y, después, haz clic en Directivas.
-
En la página "Directivas de codespaces", haga clic en Crear directiva.
-
Ingresa un nombre para tu política nueva.
-
Haga clic en Add constraint y elija Machine types.
-
Haz clic en para editar la restricción y luego borra la selección de cualquier tipo de máquina que no quieras que estén disponibles.
-
Haz clic fuera del cuadro de diálogo para cerrarlo.
-
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.
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:
-
Haga clic en .
-
Selecciona los repositorios a los cuales quieres que aplique esta política.
-
En la parte inferior de la lista de repositorios, haga clic en Select repositories.
-
-
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:
- "Restricción del número de codespaces facturados a la organización que puede crear un usuario"
- "Restricción de la imagen base para codespaces"
- "Restricción de la visibilidad de los puertos reenviados"
- "Restricción del período de tiempo de espera de inactividad"
- "Restricción del período de retención para codespaces"
-
Cuando hayas terminado de agregar restricciones a la directiva, haz clic en Guardar.
La directiva se aplicará a todos los codespaces nuevos que se facturen a tu organización. La restricción de tipo de máquina también se aplica a los codespaces existentes cuando alguien intenta reiniciar un codespace detenido o volver a conectarse a un codespace activo.
Editar una política
Puedes editar una directiva existente. Por ejemplo, puede que te interese agregar restricciones a una directiva o quitarlas.
- Mostrar la página de "Políticas del Codespaces". Para obtener más información, consulte "Agregar una política para limitar los tipos de máquina disponibles".
- Haz clic en el nombre de la política que quieres editar.
- Junto a la restricción "Tipos de máquina", haz clic en .
- Realice los cambios necesarios y haga clic en Save.
Borrar una política
-
Mostrar la página de "Políticas del Codespaces". Para obtener más información, consulte "Agregar una política para limitar los tipos de máquina disponibles".
-
Haz clic en a la derecha de la directiva que quieres eliminar.