Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Personalización de GitHub Codespaces para la cuenta

Puedes personalizar GitHub Codespaces mediante un repositorio dotfiles en GitHub o por medio de la sincronización de la configuración.

Acerca de personalizar los Codespaces

Cuando utilizas cualquier ambiente de desarrollo, personalizar las configuraciones y herramientas de acuerdo con tus preferencias y flujos de trabajo es un paso importante. GitHub Codespaces permite dos formas principales de personalizar tus codespaces.

  • Sincronización de ajustes: puedes sincronizar los ajustes de Visual Studio Code entre la aplicación de escritorio y el cliente web de VS Code.
  • Dotfiles: puede usar un repositorio dotfiles para especificar scripts, preferencias de shell y otras configuraciones.

La personalización de GitHub Codespaces se aplica a cualquier codespace que crees.

Los mantenendores de proyecto también pueden definir una configuración predeterminada que aplique a cada codespace para un repositorio que cree alguien más. Para obtener más información, consulte "Introducción a los contenedores de desarrollo".

Sincronización de ajustes

La sincronización de ajustes te permite sincronizar configuraciones tales como configuraciones, métodos abreviados de teclado, fragmentos de código, extensiones y estados de IU entre máquinas e instancias de VS Code. Para más información, consulta "Sincronización de la configuración" en la documentación de VS Code.

Al habilitar la Sincronización de la configuración en una instancia de VS Code, como la aplicación para escritorio de VS Code de tu portátil, la configuración de esa instancia se almacena en la nube. Desde la nube, la configuración se extrae en todos los espacios de código nuevos en el momento de la creación y se sincroniza continuamente con los espacios de código existentes en los que está habilitada la Sincronización de la configuración.

Si la Sincronización de la configuración está habilitada o no de forma predeterminada en un espacio de código dependerá de la configuración existente y de si abres el espacio de código en el explorador o en la aplicación de escritorio VS Code.

  • Si abres un codespace en el explorador, la sincronización de configuración siempre está deshabilitada al principio. Esto significa que la transferencia de la configuración se realiza en una dirección y solo una vez: GitHub Codespaces extrae la configuración almacenada en la nube en el codespace en el momento de la creación, pero las actualizaciones que realices en la configuración del codespace no se propagan a la nube, por lo que no se reflejan en ningún otro codespace. Igualmente, las actualizaciones que realices en la configuración en otro lugar no se reflejarán en el codespace.
  • Si abres un codespace en la aplicación de escritorio VS Code, la sincronización de configuración permanece habilitada en el codespace si la has habilitado previamente para la aplicación. Las actualizaciones que realices en la configuración se insertan en la nube, por lo que se reflejan en los codespaces nuevos y en los ya existentes en los que está habilitada la sincronización de configuración. Si realizas actualizaciones de la configuración en otras instancias de VS Code en las que está habilitada la sincronización de configuración, estas actualizaciones se reflejan en el codespace.

Si trabajas en un codespace en el que la sincronización de configuración está deshabilitada, puedes habilitarla para insertar los cambios realizados en la configuración en la nube, o bien extraer los cambios más recientes en la configuración que hayas realizado en otro lugar.

Habilitación de la sincronización de configuración

Nota: Solo debes habilitar la sincronización de configuración en los codespaces creados a partir de repositorios de confianza. Para más información, consulta "Seguridad en GitHub Codespaces".

  1. En VS Code, en la parte inferior de la barra de actividad, selecciona y haz clic en Activar la sincronización de configuración… .

  2. En la lista desplegable, selecciona la configuración que quieras sincronizar.

    Captura de pantalla de las opciones de configuración de sincronización

  3. Haz clic en Iniciar sesión y activar y, después, selecciona la cuenta con la que quieras sincronizar la configuración.

Cuando hayas iniciado sesión, la instancia de VS Code en la que trabajes se actualizará inmediatamente para mostrar la configuración sincronizada más reciente.

Deshabilitación de la sincronización de configuración

Puedes deshabilitar la sincronización de configuración para detenerla hacia y desde una instancia de VS Code.

De manera predeterminada, al deshabilitar la sincronización de configuración, los nuevos codespaces siguen usando la configuración en caché desde la última vez que se haya insertado en la nube. Si los codespaces todavía se crean con la configuración en caché y quieres volver a usar la configuración predeterminada de VS Code en ellos, puedes borrar la caché en la nube al deshabilitar la sincronización de configuración.

  1. Si la sincronización de configuración está actualmente deshabilitada en la instancia de VS Code, primero debes habilitarla. Para obtener instrucciones, consulta "Habilitación de la sincronización de configuración".

  2. En la parte inferior de la barra de actividades, selecciona y haz clic en Sincronización de configuración es Activado.

  3. En la lista desplegable, haz clic en Sincronización de configuración: Desactivar.

    Captura de pantalla de la opción Desactivar sincronización de configuración en VS Code

  4. Para borrar la configuración en caché, selecciona Desactivar sincronización en todos los dispositivos y borrar los datos de la nube en el cuadro de diálogo.

    Captura de pantalla del cuadro de diálogo Desactivar sincronización de configuración

  5. Haz clic en Desactivar.

Dotfiles

Los dotfile son archivos y carpetas de sistemas similares a Unix que comienzan con . y que controlan la configuración de aplicaciones y shells en el sistema. Puedes alamacenar y administrar tus dotfiles en un repositorio en GitHub. Para obtener consejos y tutoriales sobre qué incluir en el repositorio de dotfile, vea Dotfile en GitHub.

Tu repositorio dotfiles puede incluir los alias de tu shell y tus preferencias, cualquier herramienta que quieras instalar o cualquier otra personalización del codespace que quieras hacer.

Puedes configurar GitHub Codespaces para usar dotfiles desde cualquier repositorio que poseas si seleccionas ese repositorio en la configuración personal de GitHub Codespaces.

Cuando crea un codespace nuevo, GitHub clona su repositorio de dotfiles seleccionado hacia el ambiente del codespace, y busca uno de los siguientes archivos para configurar el ambiente.

  • install.sh
  • install
  • bootstrap.sh
  • bootstrap
  • script/bootstrap
  • setup.sh
  • setup
  • script/setup

Si no se encuentra ninguno de estos archivos, los archivos o carpetas del repositorio dotfiles seleccionado que empiezan por . se enlazan de forma simbólica al directorio ~ o $HOME del codespace.

Cualquier cambio al repositorio de dotfiles que seleccionaste se aplicará únicamente a cada codespace nuevo y no afectará a ningún codespace existente.

Nota: Actualmente, en Codespaces no se admite la personalización de la configuración con ámbito de usuario para VS Code con el repositorio dotfiles. Puede establecer la configuración predeterminada Área de trabajo y Repositorio remoto [Codespaces] para un proyecto específico en el repositorio del proyecto. Para obtener más información, consulte "Introducción a los contenedores de desarrollo".

Habilitar tu repositorio de dotfiles para Codespaces

Puedes utilizar el repositorio de dotfiles seleccionado para personalizar tu entorno de GitHub Codespaces. Una vez que elijas tu repositorio de dotfiles, puedes agregar tus scripts, preferencias y configuraciones a este. Después, necesitarás habilitar tus dotfiles desde tu página personal de ajustes de GitHub Codespaces.

Advertencia: Los dotfile tienen la capacidad de ejecutar scripts arbitrarios, que podrían contener código malicioso o inesperado. Antes de instalar un repositorio de dotfiles, te recomendamos verificar los scripts para asegurarte de que no realicen acciones inesperadas.

  1. En la esquina superior derecha de cualquier página, haga clic en la foto del perfil y, luego, en Settings (Configuración).

    Icono Settings (Parámetros) en la barra de usuario 1. En la sección "Código, planificación y automatización" de la barra lateral, haga clic en Codespaces.

  2. En "Dotfiles", selecciona Instalar dotfiles automáticamente para que GitHub Codespaces instale los dotfiles de forma automática en cada codespace que crees. Instalación de dotfiles

  3. Elige el repositorio desde el cual quieras instalar dotfiles. Selección de un repositorio de dotfiles

Puedes agregar más scripts, preferencias o archivos de configuración a tu repositorio de dotfiles o editar los archivos existentes cuando lo desees. Solo los codespaces nuevos tomarán los cambios a los ajustes.

Si el codespace no puede seleccionar las opciones de configuración de los dotfiles, consulta "Solución de problemas de opciones de personalización para GitHub Codespaces".

Otros ajustes disponibles

También puedes personalizar GitHub Codespaces con opciones adicionales en tu configuración personal:

Información adicional