Configuración de personalizaciones de usuario para cuadros de desarrollo

Puede personalizar microsoft Dev Box cargando un archivo de personalización de usuario. Los archivos de personalización de usuario le permiten configurar el cuadro de desarrollo con sus aplicaciones y configuraciones personales preferidas, por lo que puede empezar a codificar más rápido. En este artículo se explica cómo crear, probar y cargar un archivo de personalización de usuario desde la unidad local o el repositorio mediante Visual Studio (VS) Code. También aprenderá a validar el archivo y administrar la configuración de personalización de los proyectos.

Use personalizaciones en Microsoft Dev Box de dos maneras: las personalizaciones de equipo crean una configuración compartida para un equipo y las personalizaciones de usuario crean una configuración personal para un desarrollador individual. En la tabla siguiente se muestran las diferencias entre los dos tipos de personalizaciones.

Las personalizaciones de usuario ayudan a garantizar que los desarrolladores cumplan las barreras de protección de la empresa; solo las tareas personalizadas que se han aprobado previamente a través de un catálogo están disponibles para que los desarrolladores los usen en sus archivos de personalización. Los usuarios del cuadro de desarrollo estándar no pueden ejecutar tareas integradas de PowerShell y WinGet en un contexto del sistema, lo que impide la elevación de privilegios.

Las personalizaciones de usuario se pueden habilitar o deshabilitar en el nivel de proyecto. Al crear un proyecto, las personalizaciones de usuario están activadas de forma predeterminada.

Prerrequisitos

Para completar los pasos de este artículo:

• Configure un centro de desarrollo con una definición de equipo de desarrollo, un grupo de equipo de desarrollo y un proyecto de equipo de desarrollo para poder crear un cuadro de desarrollo.
• Únase al grupo de seguridad Usuarios de Dev Box para al menos un proyecto.
• Adjunte un catálogo al centro de desarrollo con las tareas que usa en el archivo de personalización. Si no tiene un catálogo, consulte Agregar y configurar un catálogo desde GitHub o Azure Repos.

Permisos necesarios para configurar personalizaciones

Para crear y aplicar personalizaciones a un cuadro de desarrollo, necesita los permisos siguientes:

Creación de un archivo de personalización de usuario

Crear y administrar archivos de personalización en VS Code. Use la extensión Microsoft Dev Box en VS Code para detectar tareas en el catálogo adjunto y probar el archivo de personalización.

1. Cree un cuadro de desarrollo para pruebas o use un cuadro de desarrollo existente.

2. En el cuadro de desarrollo de prueba, instale VS Code y, a continuación, instale la extensión Dev Box.

3. Descargue un archivo de personalización de YAML de ejemplo desde el repositorio de ejemplos y ábralo en VS Code.

4. Descubra las tareas disponibles en el catálogo mediante la paleta de comandos. Seleccione Ver> Paleta de comandos>Dev Box: enumerar tareas disponibles para este Dev Box.

   

5. Pruebe la personalización en VS Code mediante la paleta de comandos. En Ver>Paleta de comandos, seleccione >Dev Box: aplicar tareas de personalización.

   

6. El archivo de personalización se ejecuta y aplica las tareas especificadas a la caja de desarrollo para pruebas. Inspeccione los cambios y compruebe el terminal de VS Code en busca de errores o advertencias durante la ejecución de la tarea.

7. Una vez que el archivo de personalización se ejecute correctamente, cárguelo en el catálogo.

Opcional: Personalizar el cuadro de desarrollo mediante archivos de configuración de WinGet existentes

La configuración de WinGet usa un enfoque de configuración como código para definir los conjuntos únicos de valores de software y configuración necesarios para preparar el código del entorno de Windows. También puede usar estos archivos de configuración para configurar un cuadro de desarrollo mediante una tarea WinGet incluida en el catálogo de inicio rápido proporcionado por Microsoft.

En este ejemplo se muestra un archivo de personalización de cuadro de desarrollo que usa un archivo de Configuración de estado deseado (DSC) de WinGet existente.

tasks:
    - name: winget
      parameters:
          configure: "projectConfiguration.dsc.yaml"

Para más información, consulte Configuración de WinGet.

Creación de un cuadro de desarrollo mediante un archivo de personalización de usuario

Use un archivo de personalización individual cargándolo desde una unidad local cuando cree el cuadro de desarrollo o descárguelo desde un repositorio. Los archivos de personalización almacenados en un repositorio deben denominarse workload.yaml. Los archivos de personalización almacenados localmente para la carga deben denominarse myfilename.yaml.

Carga de un archivo

1. En el portal para desarrolladores, seleccione nuevo>cuadro de desarrollo nuevo.

2. En el panel Agregar un equipo de desarrollo, agregue detalles para el equipo de desarrollo.

3. Seleccione Aplicar personalizaciones y, a continuación, seleccione Continuar.

   

4. Seleccione Upload a customization file(s) (Cargar archivos de personalización), seleccione Add customizations from file (Agregar personalizaciones del archivo) y, a continuación, busque y seleccione el archivo myfilename.yaml .

   

5. Para comprobar que las tareas del archivo de personalizaciones se aplican correctamente, validelas antes de continuar. Seleccione Validar.

   

6. Revise el resumen de creación del cuadro de desarrollo y, a continuación, seleccione Crear.

   

Obtener un archivo de un repositorio

1. En el portal para desarrolladores, seleccione nuevo>cuadro de desarrollo nuevo.

2. En el panel Añadir un cuadro de desarrollo, agregue detalles para tu cuadro de desarrollo.

3. Seleccione Aplicar personalizaciones y, a continuación, seleccione Continuar.

   

4. Seleccione Cargar un archivo de personalización, seleccione Elegir un archivo de personalización de un repositorio y, a continuación, escriba la dirección URL del repositorio que almacena el archivo workload.yaml .

   

5. Para comprobar que las tareas del archivo de personalizaciones se aplicarán correctamente, validelas antes de continuar. Seleccione Validar.

   

6. Revise el resumen de creación del cuadro de desarrollo y, a continuación, seleccione Crear.

   

Deshabilitar personalizaciones de usuario

Las personalizaciones de usuario se controlan en el nivel de proyecto y están habilitadas de forma predeterminada. Puede deshabilitarlos durante o después de la creación del proyecto. Cuando está deshabilitado, los desarrolladores no pueden aplicar sus propios archivos de personalización a los nuevos cuadros de desarrollo. La habilitación de personalizaciones de usuario no omite los límites de protección de proyectos existentes; los desarrolladores solo pueden usar tareas proporcionadas en el catálogo adjunto y no pueden ejecutar tareas con privilegios elevados a menos que un administrador haya incluido explícitamente una tarea administrativa en el catálogo.

Deshabilitación de las personalizaciones de usuario a través de Azure Portal

1. Inicie sesión en Azure Portal.

2. En el cuadro de búsqueda, escriba proyectos. En la lista de resultados, seleccione Proyectos.

3. En la página Proyectos , seleccione el proyecto en el que desea deshabilitar las personalizaciones de usuario.

4. Vaya a Configuración> Configuración del cuadro de desarrollo.

   

5. Para deshabilitar las personalizaciones de usuario, desactive la casilla Habilitar y, a continuación, seleccione Aplicar.

Experiencia para desarrolladores en el portal para desarrolladores

Al deshabilitar las personalizaciones de usuario para un proyecto, los desarrolladores todavía pueden cargar un archivo de personalización de usuario durante la creación del cuadro de desarrollo, pero se produce un error en el proceso de validación y las personalizaciones no se aplican al cuadro de desarrollo.

Si crea un cuadro de desarrollo con personalizaciones de usuario en un proyecto en el que se deshabilitan las personalizaciones de usuario, verá lo siguiente en el portal para desarrolladores:

1. Un mensaje en el icono del nuevo cuadro de desarrollo muestra errores al aplicar personalizaciones.

   

2. Los detalles dicen que te pongas en contacto con tu administrador.

   

3. El entorno de desarrollo no incluye configuraciones personalizadas de usuario.

Contenido relacionado

• Personalizaciones de Microsoft Dev Box
• Configuración de la creación de imágenes del centro de desarrollo
• Agregar y configurar de un catálogo desde GitHub o Azure Repos