Crear tareas para personalizaciones de equipo de Dev Box
Al crear tareas para personalizaciones de equipo de Microsoft Dev Box, puede definir acciones específicas para los cuadros de desarrollo para ayudar a garantizar un entorno de desarrollo coherente y eficaz. La creación de nuevas tareas en un catálogo permite definir componentes reutilizables adaptados a los equipos de desarrollo y agregar límites de protección en torno a las configuraciones que son posibles. Este artículo le guía a través de la creación de un catálogo para tareas de personalización, la adición de tareas y la asociación del catálogo a un centro de desarrollo o proyecto.
Importante
La característica personalizaciones del equipo de Dev Box está 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 están en versión beta, en versión preliminar o que 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 equipo de desarrollo.
- Un catálogo existente en GitHub o Azure Repos.
Permisos necesarios para configurar personalizaciones
Para realizar las acciones necesarias para crear y aplicar personalizaciones a un cuadro de desarrollo, necesita los permisos siguientes:
| Action | Permiso / Rol |
|---|---|
| Habilitación de catálogos de nivel de proyecto para un centro de desarrollo. | Ingeniero de plataforma con acceso de escritura en la suscripción. |
| Habilitación de la configuración de sincronización de catálogos 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. |
| Creación de un archivo de personalización. | No se especificó ninguno. Cualquier persona puede crear un archivo de personalización. |
| Use el portal para desarrolladores para cargar y aplicar un archivo YAML durante la creación del cuadro de desarrollo. | Usuario de Dev Box |
| Agregar tareas a un catálogo. | Permiso para agregar al repositorio que hospeda el catálogo. |
¿Qué son las tareas?
Una tarea realiza una acción específica, como instalar software. Cada tarea consta de uno o varios scripts de PowerShell, junto con un archivo task.yaml que proporciona parámetros y define cómo se ejecutan los scripts. También puede incluir un comando de PowerShell en el archivo task.yaml.
Puede almacenar una colección de tareas seleccionadas en un catálogo adjunto al centro de desarrollo, con cada tarea en una carpeta independiente. Dev Box admite el uso de un repositorio de GitHub o un repositorio de Azure Repos como catálogo. Dev Box examina una carpeta especificada del catálogo de forma recursiva para buscar definiciones de tareas.
WinGet y PowerShell están disponibles en cualquier centro de desarrollo sin necesidad de un catálogo. Si las personalizaciones solo usan WinGet o PowerShell, puede crear tareas que las usen en un archivo de personalización. Si necesita usar otras herramientas o scripts, puede crear tareas en un catálogo.
Microsoft proporciona un catálogo de inicio rápido para ayudarle a empezar a trabajar con personalizaciones. Incluye un conjunto predeterminado de tareas que definen acciones comunes:
- Instale el software mediante el administrador de paquetes WinGet.
- Implemente Desired State Configuration (DSC) mediante WinGet Configuration.
- Clone un repositorio mediante
git-clone. - Configuración de aplicaciones como la instalación de extensiones de Visual Studio.
- Ejecutar scripts de PowerShell.
Creación de tareas en un catálogo
Las tareas, como instalar software o ejecutar scripts, se organizan en un catálogo. Cree y administre tareas en un catálogo, defina nuevas tareas y adjunte el catálogo a un centro de desarrollo. Con el catálogo de inicio rápido de Microsoft, puede empezar a trabajar con tareas comunes como instalar software, implementar DSC, clonar repositorios y configurar aplicaciones.
Definición de nuevas tareas
Para crear y administrar tareas para las personalizaciones del equipo de Dev Box, siga estos pasos:
Cree un repositorio para almacenar las tareas. Opcionalmente, puede realizar una copia del catálogo de inicio rápido en su propio repositorio para usarlo como punto de partida.
Cree tareas en el repositorio modificando los scripts de PowerShell existentes o creando nuevos scripts. Para empezar a crear tareas, puede usar los ejemplos del repositorio de GitHub para ejemplos del centro de desarrollo y en la documentación de PowerShell.
Adjunte el repositorio al centro de desarrollo como catálogo.
Cree un archivo de configuración para esas tareas siguiendo los pasos descritos en Escribir un archivo de personalización.
Uso de secretos de un almacén de claves de Azure
Puede usar secretos del almacén de claves de Azure en las configuraciones de YAML para clonar repositorios privados o con cualquier tarea personalizada que cree que requiera un token de acceso.
El centro de desarrollo necesita acceso al almacén de claves. DevCenter no admite etiquetas de servicio, por lo que si el almacén de claves se mantiene privado, debe permitir que los servicios de Microsoft de confianza omitan el firewall.
Para configurar los secretos del almacén de claves para su uso en las configuraciones de YAML:
Asegúrese de que la identidad administrada del proyecto del centro de desarrollo tenga el rol Lector de Key Vault y el rol de usuario secretos de Key Vault en el almacén de claves.
Conceda el rol de usuario secretos de Key Vault para el secreto del almacén de claves a cada usuario o grupo de usuarios que pueda consumir el secreto durante la personalización de un cuadro de desarrollo. El usuario o grupo al que se concede el rol debe incluir la identidad administrada para el centro de desarrollo, su propia cuenta de usuario y cualquier usuario o grupo que necesite el secreto durante la personalización de un cuadro de desarrollo.
Para obtener más información sobre el uso de secretos del almacén de claves en un archivo de personalización, consulte Clonar un repositorio privado mediante un archivo de personalización.
Adjuntar un catálogo
Puede adjuntar un catálogo a un proyecto para que las tareas sean accesibles para el equipo de desarrolladores. Para adjuntar un catálogo a un proyecto, siga los pasos descritos en Agregar y configurar un catálogo desde GitHub o Azure Repos.