Skip to main content

Personalizar GitHub Codespaces para tu cuenta

Puedes personalizar Acerca de GitHub Codespaces utilizando un repositorio de dotfiles en GitHub o utilizando la sincronización de ajustes.

Acerca de GitHub Codespaces está disponible para las organizaciones que utilizan GitHub Team o Nube de GitHub Enterprise. Para obtener más información, consulta la sección "Productos de GitHub".

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. Codespaces permite dos formas principales de personalizar tus codespaces.

  • Sincronización de ajustes - Puedes utilizar y compartir los ajustes de Visual Studio Code entre Codespaces y otras instancias de Visual Studio Code.
  • Dotfiles – Puedes utilizar un repositorio de dotfiles para especificar scripts, preferencias de shell y otras configuraciones.

La personalización de Codespaces 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, consulta la sección "Configurar Codespaces para tu proyecto".

Sincronización de ajustes

La configuración de ajustes te permite compartir configuraciones tales como configuraciones, atajos de teclado, fragmentos de código, extensiones y estados de IU entre máquinas e instancias de Visual Studio Code.

Para habilitar la Sincronización de Ajustes, en la esquina inferior izquierda de la Barra de Actividad, selecciona y haz clic en Encender la Sincronización de Ajustes…. En la caja de diálogo, selecciona los ajustes que te gustaría sincronizar.

La opción de sincronización de ajustes en el menú de administración

Para obtener más información, consulta la Guía de sincronización de ajustes en la documentación de Visual Studio Code.

Dotfiles

Los Dotfiles son archivos y carpetas de sistemas parecidos a Unix que comienzan con . y que controlan la configuración de aplicaciones y shells de tu sistema. Puedes alamacenar y administrar tus dotfiles en un repositorio en GitHub. Para obtener consejos y tutoriales sobre qué incluir en tu repositorio de dotfiles, consulta la sección de GitHub does dotfiles.

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 los Codespaces para que utilicen los dotfiles de cualquier repositorio que te pertenezca si seleccionas el repositorio en tus ajustes personales de Codespaces.

Cuando creas un codespace nuevo, GitHub clona tu repositorio 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 o carpetas en el repositorio de dotfiles que seleccionaste comenzando con ., estos se enlazan simbólicamente al directorio de ~ o $HOME de un 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, Codespaces no es compatible con la personalización de la configuración de Usuario para el editor de Visual Studio Code con tu repositorio de dotfiles. Puedes configurar ajustes predeterminados de Workspace y Remote [Codespaces] para un proyecto específico en el repositorio de éste. Para obtener más información, consulta la sección "Introducción a los contenedores dev".

Habilitar tu repositorio de dotfiles para Codespaces

Puedes utilizar tu repositorio de dotfiles seleccionado para personalizar tu ambiente de 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 Codespaces.

Advertencia: Dotfiles tiene la capacidad de ejecutar scripts arbitrarios, lo cual podría contener código malicioso 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, da clic en tu foto de perfil y después da clic en Configuración.

    Icono Settings (Parámetros) en la barra de usuario

  2. En la sección de "Código, planeación y automatización" de la barra lateral, haz clic en Codespaces.

  3. Debajo de "Dotfiles"; selecciona Instalar los dotfiles automáticamente para que Codespaces instale tus dotfiles automáticamente en cada codespace nuevo que crees. Instalar dotfiles

  4. Elige el repositorio desde el cual quieras instalar dotfiles. Seleccionar 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 tu codespace no puede recoger los ajustes de configuración de los dotfiles, consulta la sección "Solucionar problemas de dotfiles para Codespaces".

Otros ajustes disponibles

También puedes personalizar los Codespaces utilizando ajustes de Codespaces adicionales:

Leer más