{"meta":{"title":"Creación de un codespace para un repositorio","intro":"Puedes crear un codespace para una rama en un repositorio para desarrollar en línea.","product":"Codespaces","breadcrumbs":[{"href":"/es/codespaces","title":"Codespaces"},{"href":"/es/codespaces/developing-in-a-codespace","title":"Desarrollar en un codespace"},{"href":"/es/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository","title":"Creación de un codespace para un repositorio"}],"documentType":"article"},"body":"# Creación de un codespace para un repositorio\n\nPuedes crear un codespace para una rama en un repositorio para desarrollar en línea.\n\n## Acerca de la creación de un codespace para un repositorio\n\nPuede crear un codespace en GitHub, en Visual Studio Code o utilizando el GitHub CLI. Usa las pestañas de este artículo a fin de mostrar instrucciones para cada una de estas formas de crear un codespace.\n\nPuede usar GitHub Codespaces en su cuenta personal de GitHub, con la cuota de uso gratuito que se incluye cada mes para las cuentas de los planes Gratis y Pro. Para seguir usando GitHub Codespaces más allá del almacenamiento y del uso de proceso mensuales incluidos, proporciona la información de pago y establece un límite de gasto. Consulta [facturación de GitHub Codespaces](/es/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces).\n\nLas organizaciones pueden permitir que los miembros y colaboradores externos creen y usen codespaces a costa de la organización. Para más información, consulta [Selección de quién posee y paga los codespaces de una organización](/es/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization).\n\nLa capacidad de crear codespaces a partir de repositorios que posea la organización depende de varios factores, como la visibilidad del repositorio y la configuración de la organización o su empresa principal. Para más información, consulta [Solucionar problemas de creación y borrado de codespaces](/es/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces#no-access-to-create-a-codespace).\n\nSi vas a iniciar un nuevo proyecto, es posible que desees crear un codespace a partir de una plantilla y publicar en un repositorio en GitHub más tarde. Para obtener más información, consulta [Creación de un codespace a partir de una plantilla](/es/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template).\n\nSi creas un codespace desde un repositorio, este se asociará a una rama específica, que no puede estar vacía. Puedes crear más de un codespace por repositorio o incluso por rama.\n\nPuedes ver todos los codespaces disponibles que has creado en la página “Tus codespaces”. Para mostrar esta página, en la esquina superior izquierda de GitHub, selecciona y después haz clic en ** Codespaces**. Esto te lleva a [github.com/codespaces](https://github.com/codespaces).\n\n### Proceso de creación de codespace\n\nCuando creas un codespace, se llevan a cabo varios pasos para crear y conectarte a tu entorno de desarrollo.\n\n* Paso 1: Se le asignan una máquina virtual (MV) y almacenamiento a su codespace.\n* Paso 2: Se crea el contenedor y se clona tu repositorio.\n* Paso 3: Puedes conectarte al codespace.\n* Paso 4: Codespace sigue con la configuración post creación.\n\nPara más información sobre lo que sucede al crear un codespace, consulta [Análisis en profundidad de GitHub Codespaces](/es/codespaces/about-codespaces/deep-dive).\n\nPara más información sobre el ciclo de vida de un codespace, consulta [Ciclo de vida de un codespace](/es/codespaces/about-codespaces/understanding-the-codespace-lifecycle).\n\nSi quieres usar ganchos de Git para tu espacio de código, debes configurarlos mediante los scripts de ciclo de vida `devcontainer.json`, como `postCreateCommand`. Estos se ejecutan durante el paso 4 anterior. Para obtener más información sobre los scripts de ciclo de vida, consulta la [especificación de los contenedores de desarrollo](https://containers.dev/implementors/json_reference/#lifecycle-scripts) en el sitio web de los contenedores de desarrollo. Como el contenedor de desarrollador de codespace se crea después de clonar el repositorio, cualquier [directorio de plantilla de Git](https://git-scm.com/docs/git-init#_template_directory) configurado en la imagen de contenedor no se aplicará al codespace. En su lugar, los hooks deben instalarse una vez creado el codespace.\n\nPuedes editar código, depurar y utilizar comandos de Git mientras desarrollas en un codespace con VS Code. Para más información, consulta la [documentación de VS Code](https://code.visualstudio.com/docs).\n\nPara acelerar la creación de codespaces, los administradores de repositorios pueden habilitar precompilaciones de GitHub Codespaces para un repositorio. Para más información, consulta [Acerca de las precompilaciones de GitHub Codespaces](/es/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds).\n\n## Creación de un codespace para un repositorio\n\n
\n\n1. En GitHub, navegue hasta la página principal del repositorio.\n\n2. En el nombre del repositorio, seleccione el menú desplegable de la rama, que se etiqueta con el nombre de la rama actual y, a continuación, haga clic en la rama para la que desea crear un espacio de código.\n\n ![Captura de pantalla del menú desplegable de la rama expandida, enumerando varias ramas. El menú desplegable \"tronco\", etiquetado con un icono de rama, está resaltado con un contorno naranja.](/assets/images/help/codespaces/branch-drop-down.png)\n\n3. Haz clic en el botón ** Code** y, a continuación, haz clic en la pestaña **Codespaces**.\n\n Se muestra un mensaje en la parte inferior del cuadro de diálogo que le indica quién pagará por el codespace.\n\n ![Captura de pantalla del cuadro de diálogo Codespaces. El mensaje que muestra quién pagará por el codespace está resaltado con un contorno naranja oscuro.](/assets/images/help/codespaces/who-will-pay.png)\n\n4. Crea el codespace, ya sea con las opciones predeterminadas o después de configurar las opciones avanzadas:\n\n * **Uso de las opciones predeterminadas**\n\n Para crear un codespace con las opciones predeterminadas, haz clic en .

\n\n * **Configurar opciones avanzadas**\n\n Para configurar opciones avanzadas para el codespace, como un tipo de máquina diferente o un archivo determinado `devcontainer.json`:\n\n 1. En la parte superior derecha de la pestaña **Codespaces**, selecciona y haz clic en **Nuevo con opciones**.\n\n ![Captura de pantalla de la lista desplegable de opciones en la pestaña \"Codespaces\", con la opción \"Nuevo con opciones\".](/assets/images/help/codespaces/default-machine-type.png)\n\n 2. En la página de opciones del codespace, elige tus opciones preferidas en los menús desplegables.\n\n ![Captura de pantalla de la página de opciones avanzadas con botones para \"Rama\", \"Configuración del contenedor de desarrollo\", \"Región\" y \"Tipo de máquina\".](/assets/images/help/codespaces/advanced-options.png)\n\n La página de opciones también puede mostrar los nombres de uno o varios secretos que se recomienda crear en la configuración de Codespaces. Para obtener más información, consulta [Secretos recomendados](#recommended-secrets).\n\n > \\[!NOTE]\n >\n > * Puedes marcar la página de opciones para poder crear rápidamente un codespace para este repositorio y esta rama.\n > * La página proporciona una manera rápida de crear un codespace para cualquier repositorio y rama. Puedes acceder a esta página rápidamente escribiendo `codespace.new` en la barra de direcciones del explorador.\n > * Para obtener más información sobre el archivo de configuración de contenedores de desarrollo, consulta [Introducción a los contenedores dev](/es/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n > * Para más información sobre los tipos de máquina, consulta [Cambiar el tipo de máquina de tu codespace](/es/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types).\n > * La elección de los tipos de máquina disponibles puede estar limitada por varios factores. Estos pueden incluir una directiva configurada para la organización o una especificación mínima del tipo de máquina para el repositorio. Para más información, consulta [Restringir el acceso a los tipos de máquina](/es/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) y [Establecer una especificación mínima para máquinas de codespace](/es/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines).\n\n 3. Haga clic en **Crear codespace**.\n\n## Secretos recomendados\n\nLos nombres de los secretos definidos por el usuario se pueden mostrar en la página de opciones avanzadas al crear un codespace. Esto ocurrirá si se han especificado secretos recomendados en la configuración del contenedor de desarrollo que has seleccionado. Para más información, consulta [Especificación de secretos recomendados para un repositorio](/es/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/specifying-recommended-secrets-for-a-repository).\n\nScreenshot of the \"Create codespace\" page with four recommended secrets highlighted with a dark orange outline.\n\nSe recomienda escribir valores para estos secretos de entorno de desarrollo, cuando se te pida que lo hagas, ya que es probable que el proyecto necesite valores para ellos. Sin embargo, no es necesario proporcionar valores para crear un codespace. Puedes establecer estos secretos en el codespace si lo prefieres.\n\nSi escribe un valor para un secreto recomendado, el secreto estará disponible en el nuevo codespace. Al hacer clic en **Crear codespace**, el secreto también se agrega a la configuración personal para Codespaces, por lo que no tendrás que escribir un valor para el secreto en el futuro al crear un codespace para este repositorio.\n\nSi el nombre de un secreto se muestra con una casilla que no está disponible para seleccionarla y no hay ningún cuadro de entrada, se debe a que ya tienes un secreto de este nombre configurado en la configuración personal para Codespaces y lo has asociado a este repositorio. Si has creado un secreto de este nombre pero no lo has asociado a este repositorio, la casilla estará disponible para seleccionar y, al hacerlo, puedes actualizar la configuración para agregar la asociación.\n\nSi deseas cambiar el valor de un secreto preseleccionado, puedes hacerlo desde la configuración personal de Codespaces en [github.com/settings/codespaces](https://github.com/settings/codespaces). Para más información, consulta [Administración de secretos específicos de la cuenta para GitHub Codespaces](/es/codespaces/managing-your-codespaces/managing-your-account-specific-secrets-for-github-codespaces).\n\n
\n\n
\n\nDespués de que conecte su cuenta de GitHub a la extensión de GitHub Codespaces, puede crear un codespace nuevo. Para obtener más información sobre la extensión de GitHub Codespaces, consulta el [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces).\n\n1. En VS Code, en la barra de actividad, haz clic en el icono de Explorador remoto.\n\n ![Captura de pantalla de la barra Actividades. El icono de la barra lateral \"Explorador remoto\" (un rectángulo superpuesto por un círculo) está resaltado con un contorno naranja.](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)\n\n > \\[!NOTE]\n > Si el Explorador remoto no se muestra en la barra de actividad:\n >\n > 1. Abra la paleta de comandos. Por ejemplo, presionando el Comando+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux).\n > 2. Escriba: `details`.\n > 3. Haz clic en **Codespaces: Detalles**.\n\n2. Mantén el puntero sobre la barra lateral \"Explorador remoto\" y haz clic en .\n\n ![Captura de pantalla de la barra lateral \"Explorador remoto\" para GitHub Codespaces. La información sobre herramientas \"Crear nuevo codespace\" aparece junto al botón de signo más.](/assets/images/help/codespaces/create-codespace-vscode.png)\n\n3. En el cuadro de texto, escribe el nombre del repositorio en el que quieres desarrollar y selecciónalo.\n\n ![Captura de pantalla de \"octo-org/he\" escrito en el cuadro de texto y una lista de cuatro repositorios que comienzan con esta cadena.](/assets/images/help/codespaces/choose-repository-vscode.png)\n\n Se muestra un mensaje en el lado derecho de las solicitudes posteriores que te indican quién pagará por el codespace.\n\n ![Captura de pantalla de un mensaje para una rama, con el mensaje \"Uso pagado por hubwriter\".](/assets/images/help/codespaces/who-will-pay-vscode.png)\n\n4. Da clic en la rama en la que quieras desarrollar.\n\n5. Si se te pide que elijas un archivo de configuración de contenedor de desarrollo, selecciona un archivo en la lista.\n\n6. Elige el tipo de máquina que quieres utilizar.\n\n > \\[!NOTE]\n > La elección de los tipos de máquina disponibles puede estar limitada por varios factores. Estos pueden incluir una directiva configurada para la organización o una especificación mínima del tipo de máquina para el repositorio. Para más información, consulta [Restringir el acceso a los tipos de máquina](/es/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) y [Establecer una especificación mínima para máquinas de codespace](/es/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines).\n\n
\n\n
\n\n> \\[!NOTE]\n> Para más información sobre GitHub CLI, consulta [Acerca de GitHub CLI](/es/github-cli/github-cli/about-github-cli).\n\nPara crear un codespace, use el subcomando `gh codespace create`.\n\n```shell\ngh codespace create\n```\n\nSe te pedirá que elijas un repositorio. Se muestra un mensaje que le indica quién pagará por el codespace. Luego, se te pedirá que elijas una rama, un archivo de configuración de contenedor de desarrollo (si hay más de uno disponible) y un tipo de máquina (si hay más de uno disponible).\n\nComo alternativa, puedes utilizar marcadores para especificar algunas o todas las opciones:\n\n```shell\ngh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE\n```\n\nEn este ejemplo, reemplaza `owner/repo` por el identificador del repositorio. Reemplace a `branch` por el nombre de la rama o el hash SHA completo de la confirmación que quiera que se extraiga inicialmente en el codespace. Si usa la marca `-r` sin la marca `b`, el codespace se crea a partir de la rama predeterminada.\n\nReemplaza `path` por la ruta de acceso al archivo de configuración de contenedor de desarrollo que desees usar para el nuevo codespace. Si omites este marcador y hay más de un tipo de archivo de contenedor de desarrollo disponible, se te pedirá que lo elijas en una lista. Para más información sobre el archivo de configuración de contenedores de desarrollo, consulta [Introducción a los contenedores dev](/es/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n\nReemplace `machine-type` por un identificador válido para un tipo de máquina disponible. Los identificadores son cadenas como: `basicLinux32gb` y `standardLinux32gb`. El tipo de máquinas que están disponibles depende del repositorio, la cuenta personal y la ubicación. Si ingresas un tipo de máquina no disponible o inválido, los tipos disponibles se mostrarán en el mensaje de error. Si omites este marcador y hay más de un tipo de máquina disponible, se te pedirá elegirlo de una lista.\n\nPara obtener los detalles completos de las opciones de este comando, consulta [el manual de GitHub CLI](https://cli.github.com/manual/gh_codespace_create).\n\n
\n\n## Información adicional\n\n* [Apertura de un codespace existente](/es/codespaces/developing-in-a-codespace/opening-an-existing-codespace)\n* [Facilitación de la rápida creación y reanudación de codespaces](/es/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/facilitating-quick-creation-and-resumption-of-codespaces)\n* [Puntos de conexión de la API de REST para organizaciones de Codespaces](/es/rest/codespaces/organizations)"}