Inicio rápido: Creación de un equipo de desarrollo mediante personalizaciones de equipo

En este inicio rápido, creará un equipo de desarrollo mediante personalizaciones de equipo de Microsoft Dev Box. Esta característica usa un archivo de definición de imágenes para permitirle crear equipos de desarrollo personalizados de forma coherente para el equipo de desarrollo y proporcionar un entorno personalizado para los proyectos.

Requisitos previos

Creación de la definición de una imagen

Para crear un cuadro de desarrollo con personalizaciones, debe crear un archivo de definición de imagen. El archivo de definición de imagen es un archivo YAML que contiene las personalizaciones que desea aplicar al cuadro de desarrollo. Puede usar el archivo de definición de imagen de ejemplo en este inicio rápido como punto de partida.

Habilitar catálogos a nivel de proyecto

Debe habilitar catálogos de nivel de proyecto en el nivel del centro de desarrollo para poder agregar un catálogo a un proyecto.

1. En Azure Portal, vaya al centro de desarrollo.

2. En el menú del servicio, en Configuración, seleccione Configuración del Centro de desarrollo.

3. En Catálogos de nivel de proyecto, seleccione Habilitar catálogos por proyecto y, a continuación, seleccione Aplicar.

   

Agregar un catálogo a tu proyecto

Las secciones siguientes le guiarán por estas tareas:

1. Bifurque el repositorio de catálogo de ejemplo en la organización de GitHub.
2. Configure las opciones de sincronización para sincronizar el catálogo con el proyecto.
3. Agregue el repositorio como catálogo.

Bifurcar el repositorio de catálogo de ejemplo

1. Abra el repositorio de catálogo de ejemplo.

2. Seleccione Bifurcar>crear una nueva bifurcación para bifurcar el repositorio en la organización de GitHub.

   

Configuración de la sincronización de catálogos

1. Vuelva a Azure Portal.

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

3. Seleccione el proyecto al que desea agregar el catálogo.

4. En el menú de la izquierda, seleccioneCatálogos de configuración>.

5. Seleccione Configuración de sincronización.

   

6. En el panel Configuración de sincronización :

   • Si se borran las definiciones de imagen , selecciónela y seleccione Guardar.
   • Si las definiciones de imagen ya están seleccionadas, seleccione Cancelar.

   

Adición del repositorio como catálogo

1. En la página Catálogos, seleccione Agregar.

2. En el panel Agregar catálogo, escriba o seleccione los siguientes valores:

   Campo	Valor
   Nombre	Escriba un nombre para el catálogo.
   Origen del catálogo	Seleccione GitHub.
   Tipo de autenticación	Seleccione Aplicación de GitHub.

3. Seleccione el vínculo Configurar los repositorios.

   

4. Si se le pide, autentíquese en GitHub.

5. En la página Centro de desarrollo de Microsoft, seleccione Configurar.

   

6. Seleccione la organización de GitHub que contenga el repositorio que quiera agregar como catálogo. Para poder instalar esta aplicación, la organización debe ser de su propiedad.

   

7. En la página Instalar Microsoft DevCenter , seleccione Solo repositorios, seleccione el repositorio que desea agregar como catálogo y, a continuación, seleccione Guardar.

   

   Puede seleccionar varios repositorios para agregarlos como catálogos. Debe agregar cada repositorio como un catálogo independiente, tal y como se describe en la siguiente sección de este inicio rápido.

8. Vuelva a Azure Portal.

9. En el panel Agregar catálogo , seleccione Iniciar sesión con GitHub.

10. En el panel Agregar catálogo, escriba la siguiente información y seleccione Agregar:

    Campo	Valor
    repo	Seleccione el repositorio que contiene la definición de la imagen. Ejemplo: eShop
    Rama	Seleccione la rama. Ejemplo: main
    Folder path (Ruta de acceso a la carpeta)	Seleccione la carpeta que contiene subcarpetas que contienen las definiciones de imagen. Ejemplo: .devcenter/catalog/image-definitions

11. En el panel Catálogos , compruebe que aparece el catálogo. Si la conexión se realiza correctamente, la columna Estado muestra el valor Sincronización correcta.

    

12. Compruebe que las definiciones de imagen están sincronizadas correctamente. En el menú de la izquierda, seleccione Administrar>definiciones de imagen. En este ejemplo, verá dos definiciones de imagen:

    • backend-dev : esta imagen es una imagen de Microsoft Visual Studio + Tools en Windows 11, adecuada para el entorno de ingeniería de back-end de eShop.
    • frontend-dev : esta imagen es una imagen de Microsoft Visual Studio + Tools en Windows 11, adecuada para el entorno de ingeniería de front-end de eShop.

    

Creación de un grupo de cuadros de desarrollo para la definición de imagen

Para hacer que el archivo de personalización, imagedefintion.yaml, sea accesible al crear equipos de desarrollo, especifíquelo como la definición de un grupo.

Para crear un grupo de cuadros de desarrollo asociado a un proyecto:

1. En Azure Portal.

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

3. Abra el proyecto en el que quiere crear el grupo de equipos de desarrollo.

4. En el menú de la izquierda, seleccione Administrar> gruposde cuadros de desarrollo.

5. En la página Grupos de cuadros de desarrollo , seleccione Crear.

6. En el panel Crear un grupo de equipos de desarrollo, escriba los siguientes valores:

   Configuración	Valor
   Nombre	Escriba un nombre descriptivo para el grupo. El nombre del grupo es visible para que los desarrolladores seleccionen al crear cuadros de desarrollo, por lo que se incluyen el propósito y la región del grupo. El nombre debe ser único dentro de un proyecto. Ejemplo: contoso-frontend-westUS
   Definición	En la sección definición de imagen de la lista, seleccione una definición de imagen. Ejemplo: contoso-catalog/frontend-dev
   Proceso	Seleccione los recursos de proceso para los cuadros de desarrollo del grupo. Ejemplo: 8 vCPU, 32 GB de RAM
   Almacenamiento	Seleccione las opciones de almacenamiento de los cuadros de desarrollo del grupo. Ejemplo: SSD de 256 GB
   Hibernación	La hibernación se admite cuando la imagen de origen y el tamaño de proceso son compatibles con la hibernación.
   Conexión de red	1. Seleccione Implementar en una red hospedada por Microsoft. 2. Seleccione una región de implementación para los cuadros de desarrollo. Elija una región cercana a los usuarios del cuadro de desarrollo para obtener la experiencia de usuario óptima. Ejemplo: Oeste de EE. UU.
   Licencias	Active esta casilla para confirmar que la organización tiene licencias de Ventaja híbrida de Azure que desean aplicarse a los equipos de desarrollo de este grupo.

   

7. Seleccione Crear.

8. Compruebe que el grupo de equipos de desarrollo nuevo aparece en la lista. Es posible que deba actualizar la pantalla.

Azure Portal implementa el grupo de equipos de desarrollo y ejecuta comprobaciones de estado para asegurarse de que la imagen y la red cumplan con los criterios de validación de los equipos de desarrollo.

Creación de un equipo de desarrollo desde el grupo de cuadros de desarrollo

Al crear un equipo de desarrollo a partir de un grupo de cuadros de desarrollo, la definición de imagen se aplica al cuadro de desarrollo. El equipo de desarrollo se crea con las personalizaciones especificadas en el archivo de definición de imagen.

Para crear un equipo de desarrollo en el portal para desarrolladores de Microsoft Dev Box, siga estos pasos:

1. Inicie sesión en el portal para desarrolladores de Microsoft Dev Box.

2. Seleccione Nuevo>Nuevo equipo de desarrollo.

3. En Agregar un equipo de desarrollo, escriba los valores siguientes:

   Configuración	Valor
   Nombre	Escriba un nombre para el equipo de desarrollo. Los nombres de cuadro de desarrollo deben ser únicos dentro de un proyecto. Ejemplo: contoso-frontend-dev-box
   Proyecto	En el portal para desarrolladores se enumeran los proyectos a los que tiene acceso. Seleccione el proyecto que necesita en la lista.
   Grupo de equipos de desarrollo	En el portal para desarrolladores se enumeran todos los grupos de cuadros de desarrollo del proyecto seleccionado. Seleccione el grupo adecuado para su trabajo. Elija un grupo de equipos de desarrollo cerca de usted para conseguir la latencia mínima.
   Aplicar personalizaciones	Deje esta casilla desactivada. Se usa para aplicar personalizaciones de usuario. En este artículo ha configurado personalizaciones de equipo.

   Después de realizar las selecciones, la página muestra la siguiente información:

   • Indica si se admite o no la hibernación.
   • Notificación de que el proceso de creación del equipo de desarrollo puede tardar 25 minutos o más.

4. Seleccione Crear para empezar a crear el equipo de desarrollo.

5. Para realizar un seguimiento del progreso de la creación, use el icono del equipo de desarrollo en el portal para desarrolladores.

Compruebe que se aplican las personalizaciones

Dev Box aplica las personalizaciones como fase final del proceso de creación. Dev Box le envía un correo electrónico cuando el equipo de desarrollo está listo. A continuación, puede comprobar que se aplican las personalizaciones.

1. Espere a que se cree el cuadro de desarrollo.

2. En el portal para desarrolladores, en el icono del equipo de desarrollo, seleccione Acciones>Personalizaciones.

   

3. En el panel Detalles de personalización, confirme las personalizaciones que se aplicaron al equipo de desarrollo.

   

Limpieza de recursos

1. Inicie sesión en el portal para desarrolladores.

2. Seleccione Eliminar en el menú Acciones del equipo de desarrollo que quiere eliminar.

   

3. Para confirmar la eliminación, seleccione Eliminar.

   

Contenido relacionado

• Personalizaciones de Microsoft Dev Box
• Escritura de un archivo de personalización para un equipo de desarrollo