Inicio rápido: Creación de un Dev Box con personalizaciones de equipo

En este inicio rápido, creará un equipo de desarrollo mediante personalizaciones de equipo. Personalizaciones de equipo usa un archivo de definición de imagen para permitirle crear equipos de desarrollo personalizados de forma coherente para el equipo de desarrollo, lo que proporciona un entorno personalizado para los proyectos.

Importante

Las personalizaciones del equipo de Dev Box se encuentran actualmente en VERSIÓN PRELIMINAR. Para obtener más información sobre el estado de la versión preliminar, vea los Términos de uso complementarios para las versiones preliminares de Microsoft Azure. El documento define los términos legales que se aplican a las características de Azure que se encuentran en versión beta, versión preliminar o aún no se han publicado en disponibilidad general.

Requisitos previos

Para completar los pasos de este artículo, debe tener un centro de desarrollo configurado con un proyecto de cuadro de desarrollo.

Permisos necesarios para configurar personalizaciones

Para realizar las acciones necesarias para crear y aplicar personalizaciones a un equipo de desarrollo, necesita determinados permisos. En la tabla siguiente, se describen las acciones y los permisos o roles que necesita para configurar las personalizaciones.

Action	Permiso / Rol
Habilitar catálogos a nivel de proyecto para un centro de desarrollo	Ingeniero de plataforma con acceso de escritura en la suscripción.
Habilitar la configuración de sincronización del catálogo para un proyecto	Ingeniero de plataforma con acceso de escritura en la suscripción.
Adjuntar un catálogo a un proyecto	Permisos de administrador o colaborador del proyecto.
Crear un archivo de personalización	Cualquier persona puede crear un archivo de personalización.
Uso del portal para desarrolladores para cargar y aplicar un archivo YAML durante la creación del equipo de desarrollo	Usuario de Dev Box
Agregar tareas a un catálogo	Permiso para agregar al repositorio que hospeda el catálogo.

Creación de la definición de una imagen

1. Descargue el archivo de personalización de YAML de ejemplo.
2. Abra el archivo y examine las tareas.
   Tenga en cuenta que el archivo de definición de imagen especifica un nombre para la definición de imagen mediante un campo name. Use este nombre para identificar la definición de imagen en el grupo de cuadros de desarrollo.

Incorporación de un catálogo al centro de desarrollo

Para agregar un catálogo, realice las tareas que se indican a continuación:

1. Bifurque el repositorio de catálogo de ejemplo en la organización de GitHub.
2. Instalación y configuración de la aplicación del Centro de desarrollo de Microsoft
3. Asigne permisos en GitHub para los repositorios.
4. 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 Bifurcación para bifurcar el repositorio en la organización de GitHub.

Instalación de la aplicación del Centro de desarrollo de Microsoft

1. Inicie sesión en Azure Portal.

2. Vaya al centro de desarrollo o al proyecto.

3. En el menú de la izquierda, en Configuración del entorno, seleccione Catálogos y, luego, elija Agregar.

4. En el panel Agregar catálogo, escriba o seleccione lo siguiente:

   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.

5. Para instalar la aplicación del Centro de desarrollo de Microsoft, seleccione Configurar los repositorios.

   

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

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

   

8. 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.

   

9. En la página Instalar Centro de desarrollo de Microsoft, seleccione Solo determinados repositorios y después el repositorio que quiera agregar como catálogo. A continuación, seleccione Instalar.

   

   Puede seleccionar varios repositorios para agregarlos como catálogos. Debe agregar cada repositorio como catálogo independiente, tal y como se describe en Agregar el repositorio como un catálogo.

10. En la página Microsoft quiere permiso para: del Centro de desarrollo de Microsoft, revise los permisos necesarios y, a continuación, seleccione Autorizar el Centro de desarrollo de Microsoft.

    

Adición del repositorio como catálogo

1. Vuelva a Azure Portal.

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

   Campo	Value
   Repo	Seleccione el repositorio que quiera agregar como catálogo.
   Rama	Seleccione la rama.
   Folder path (Ruta de acceso a la carpeta)	Seleccione la carpeta que contenga las subcarpetas con las definiciones de entorno.

   

3. En Catálogos, compruebe que aparece el catálogo. Si la conexión se realiza correctamente, el estado se muestra como Sincronización correcta.

   

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

Para que el archivo de personalización, imagedefintion.yaml, accesible al crear cuadros de desarrollo, especifíquelo como la definición de un grupo. Cuando un desarrollador selecciona ese grupo para crear un cuadro de desarrollo, se usa la definición de imagen.

Para crear un grupo de equipos de desarrollo asociado a un proyecto, haga lo siguiente:

1. Inicie sesión 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. Seleccione Grupos de equipos de desarrollo y, luego, Crear.

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

   Configuración	Value
   Nombre	Escriba un nombre para el grupo. El nombre del grupo es visible para que los desarrolladores lo seleccionen al crear equipos de desarrollo. El nombre debe ser único dentro de un proyecto.
   Definición	Seleccione la definición, como se denomina en el archivo de definición de imagen.
   Conexión de red	1. Seleccione Implementar en una red hospedada por Microsoft. 2. Seleccione la región de implementación deseada para los equipos de desarrollo. Elija una región cercana a los usuarios del cuadro de desarrollo para obtener la experiencia de usuario óptima.
   Privilegios de creador de equipo de desarrollo	Seleccione Administrador local o Usuario estándar.
   Habilitar detención automática	Sí es el valor predeterminado. Seleccione No para deshabilitar una programación de parada automática. Tras crearse el grupo se puede configurar una programación de parada automática.
   Hora de detención	Seleccione una hora para apagar todos los equipos de desarrollo del grupo. Todos los equipos de desarrollo de este grupo se apagarán diariamente a esta hora.
   Zona horaria	Seleccione la zona horaria para la hora de detención.
   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.

   

6. Seleccione Crear.

7. 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	Value
   Nombre	Escriba un nombre para el equipo de desarrollo. Los nombres de los equipos de desarrollo deben ser únicos dentro de un proyecto.
   Proyecto	Seleccione un proyecto en la lista desplegable.
   Grupo de equipos de desarrollo	Seleccione un grupo en la lista desplegable, que incluye todos los grupos de equipos de desarrollo de ese proyecto. Elija un grupo de equipos de desarrollo cerca de usted para una latencia mínima.

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

   • Cuántos equipos de desarrollo puede crear en el proyecto seleccionado, si el proyecto tiene límites configurados.
   • Indica si se admite o no la hibernación.
   • Indica si las personalizaciones están habilitadas o no.
   • Una hora de apagado si el grupo en el que está creando el equipo de desarrollo tiene una programación de apagado.
   • 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.

Comprobación de que se aplica la personalización

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

1. Espere a que se confirme por correo electrónico que se crea el cuadro de desarrollo.

2. En el portal para desarrolladores, compruebe que se aplican las personalizaciones. En el icono del equipo de desarrollo, seleccione Acciones>Personalizaciones.

   

3. En el panel Detalles de personalización, puede ver 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 del equipo de Microsoft Dev Box
• Escribir un archivo de personalización