Arquitectura de la plataforma de autoservicio del Desarrollador
Una experiencia de autoservicio para desarrolladores se basa en una combinación de conceptos, patrones y herramientas, que abarcan tecnologías personalizadas, integradas y de código abierto. El objetivo es capacitar a los desarrolladores con la ejecución y el aprovisionamiento de tareas reguladas, a la vez que se mantiene la visibilidad centralizada. El enfoque principal debe estar en tareas que sean tediosas o demasiado complejas para que los desarrolladores controlen de forma independiente.
Componentes de la plataforma de autoservicio para desarrolladores
Una base de autoservicio para desarrolladores consta de varios componentes clave que funcionan juntos para simplificar y automatizar los flujos de trabajo de desarrollador. Estos componentes incluyen la Developer Platform API, el Developer Platform Graph, el Developer Platform Orchestrator, los Developer Platform Providers, y el User Profile and Team Metadata.
Developer Platform API actúa como el punto central de interacción, que actúa como una interfaz contractual entre las experiencias de usuario y otros sistemas. Una API de plataforma para desarrolladores debe habilitar el acceso a datos y impulsar las acciones de aprovisionamiento a través de varias interfaces de usuario. Actúa como la capa principal de autenticación y seguridad, lo que restringe el acceso a las API subyacentes y sin procesar junto con los datos y las operaciones correspondientes. La API administra los perfiles de usuario, los roles dentro de la plataforma y los identificadores del proveedor de identidades principal para garantizar el control de acceso adecuado.
Para complementar la API de la Plataforma para Desarrolladores está el Developer Platform Graph, una estructura de datos segura y administrada que facilita la detección y asociación de entidades y plantillas dentro de la plataforma. Las entidades agregan datos de varios orígenes, mientras que las plantillas guían las entradas de usuario para la automatización.
Developer Platform Graph permite asociar entidades y plantillas de varios proveedores a una estructura que permite búsquedas. Aunque los datos de estas entidades no necesitan almacenarse directamente en una base de datos de grafos, las interacciones con proveedores se pueden almacenar en caché junto con los metadatos necesarios. Este gráfico resulta especialmente útil cuando se trabaja con entidades comunes que contribuyen varios proveedores. Por ejemplo, las API pueden provenir del Centro de API de Azure, mientras que las implementaciones y entornos se pueden extraer de los sistemas de implementación continua. El gráfico impulsa las experiencias del usuario a través de una API común, lo que permite la detección, la búsqueda y la gobernanza.
Para ejecutar acciones basadas en plantillas, Developer Platform Orchestrator enruta y realiza un seguimiento de las solicitudes, coordinando con proveedores especializados de plataformas para desarrolladores que se integran con sistemas de bajada. El orquestador permite a los desarrolladores o sistemas solicitar acciones mediante plantillas, sin realizar las acciones directamente. Coordina con un motor de tareas, un motor de flujo de trabajo u otro orquestador para ejecutar las acciones. Este componente es esencial para habilitar el autoservicio, ya que permite a los desarrolladores desencadenar acciones sin necesidad de permisos directos. A diferencia de CI/CD, estas acciones no se limitan al código fuente de la aplicación. Los motores de flujo de trabajo como Acciones de GitHub o Azure Pipelines pueden servir como orquestadores, pero la abstracción puede ser útil para admitir diferentes motores a lo largo del tiempo. Esta flexibilidad permite la migración del motor, admite pasos manuales para procesos que posteriormente se pueden automatizar y admite acciones destinadas a roles que no son de desarrollo (por ejemplo, cuentas pagaderas). Además, las tareas más sencillas se pueden controlar a través de solicitudes HTTP, lo que evita la necesidad de motores complejos.
Los proveedores de plataformas para desarrolladores administran la lógica de las operaciones Crear, Leer, Actualizar y Eliminar (CRUD) en entidades y la ejecución de solicitudes de acción, que admiten diversos flujos de trabajo y servicios. Los proveedores introducen funcionalidad en la API a través de un modelo de proveedor extensible, lo que permite características clave como la automatización y la agregación de datos. Este modelo promueve el acoplamiento flexible, lo que permite la integración incremental de nuevas funcionalidades y mejora el mantenimiento. Al fomentar una mentalidad de origen interno, la funcionalidad de la plataforma se puede aportar y mantener mediante diferentes equipos, lo que minimiza la carga de mantenimiento en los equipos centrales. Aunque es esencial revisar el código del proveedor y administrar el acceso cuidadosamente, este enfoque conectable ayuda a escalar el esfuerzo de desarrollo en toda la organización.
La base también incluye funcionalidades para administrar el perfil de usuario y los metadatos de equipo, que vinculan información individual y de equipo a las cuentas hospedadas por un proveedor de identidades, como el identificador de Microsoft Entra. Estos metadatos se usan para agrupar y controlar el acceso dentro de la API de la plataforma para desarrolladores. Aunque sería posible almacenar esta información en el grafo de la plataforma para desarrolladores, separarla garantiza la claridad.
Una base de autoservicio para desarrolladores es accesible a través de una interfaz de usuario o experiencia de usuario centralizada (UI/UX). Ofrecer un punto de acceso unificado simplifica las interacciones para los desarrolladores, lo que facilita el uso de flujos de trabajo y recursos de una manera perfecta e intuitiva.
No es necesario crear completamente una base de autoservicio para desarrolladores desde el principio. En su lugar, sirve como guía conceptual para las funcionalidades para que apunte a lo largo del tiempo. Las implementaciones iniciales se pueden simplificar mediante herramientas, interfaces o clases existentes para abordar las prioridades más urgentes identificadas a través de los comentarios de los clientes. Al iniciar pequeñas e iteraciones, la base puede evolucionar para satisfacer eficazmente nuevas demandas.
Conceptos clave del proveedor de la plataforma para desarrolladores
En una plataforma para desarrolladores, la administración y orquestación eficaces de los recursos se basa en el uso de entidades junto con sus propiedades y plantillas. Estos conceptos clave proporcionan estructura y automatización, lo que permite la integración sin problemas entre distintos proveedores y facilita flujos de trabajo y gobernanza coherentes.
Entidades
Las entidades son los objetos clave que un desarrollador o sistema necesita para realizar un seguimiento, actualizar, presentar o actuar dentro de la plataforma de desarrollador interna. Estas entidades pueden tener relaciones entre sí, formando un grafo que proporciona información fundamental sobre la plataforma. Los proveedores de plataformas de desarrollador pueden generar entidades para admitir diversas funcionalidades básicas, como detectar recursos externos, realizar análisis de dependencias o exponer información de propiedad y mantenimiento. Una interfaz de proveedor bien definida simplifica la integración, las pruebas y la implementación, al tiempo que permite que los equipos de desarrolladores funcionen de forma independiente.
Propiedades comunes
Para administrar entidades de forma eficaz, resulta útil definir un conjunto de propiedades comunes. Algunas propiedades sugeridas incluyen un identificador único, un nombre, un proveedor de origen y asociaciones opcionales para usuarios, equipos u otras entidades. Estas propiedades son importantes para el control de acceso basado en rol (RBAC), la detección y la agregación de datos. La implementación de RBAC desde el principio es fundamental para la seguridad y el escalado de la plataforma a lo largo del tiempo. Las asociaciones de usuario y equipo son especialmente valiosas, ya que ayudan con la detección y la colaboración, lo que permite una reutilización, soporte técnico e interno eficientes dentro de la plataforma.
Entidades comunes y específicas del proveedor
También debe definir un conjunto de entidades normalizadas comunes y normalizadas que pueden generar varios proveedores. Pueden incluir entornos, recursos, API, repositorios, componentes y herramientas. Estas entidades deben ser conceptuales, centrándose en la categorización amplia (por ejemplo, los entornos) en lugar de los detalles técnicos pormenorizados (por ejemplo, la infraestructura interna). Esta vista de alto nivel facilita la detección, lo que permite la agregación de datos a lo largo del tiempo mientras apunta a detalles de nivel inferior fuera del sistema. Además, a medida que evoluciona la plataforma, es posible que tenga que adaptarse a un conjunto creciente de tipos de entidad específicos del proveedor para satisfacer diversos casos de uso.
Templates (Plantillas [C++])
Las plantillas están diseñadas para impulsar acciones como el aprovisionamiento de infraestructura, la creación de repositorios u otros procesos de ejecución prolongada. Estas plantillas están disponibles a través de proveedores de plataformas de desarrollador e incluyen propiedades comunes, como asociaciones de entidad y entradas necesarias (por ejemplo, nombres de recursos). Las plantillas pueden representar varios formatos, incluidas plantillas de infraestructura como código (IaC), plantillas de aplicación o scripts con parámetros. A menudo son específicos del proveedor, con diferentes representaciones en función de la tecnología en uso. Algunos ejemplos de estas representaciones incluyen plantillas de Terraform o Bicep, gráficos de Helm, flujos de trabajo de Acciones de GitHub con parámetros, Azure Pipelines, scripts simples o formatos personalizados adaptados a ecosistemas de proveedores específicos.
Aunque no es necesario almacenar plantillas de forma centralizada, deben ser accesibles a través de un proveedor para garantizar un acceso coherente en toda la plataforma. Pueden existir en repositorios, registros o catálogos diferentes en función del caso de uso. Por ejemplo, los repositorios de plantillas de GitHub se pueden usar para las plantillas de aplicación, mientras que las plantillas de IaC podrían residir en un repositorio de catálogo restringido al que los desarrolladores acceden indirectamente a través de herramientas como Azure Deployment Environments. Otras plantillas de IaC se pueden almacenar en un registro de artefactos de Open Container Initiative (OCI), como gráficos de Helm. En algunos casos, una plantilla podría simplemente hacer referencia a un punto de conexión HTTP con parámetros.
Los ingenieros de plataforma o especialistas en dominios suelen crear estas plantillas y compartirlas con los equipos de desarrollo para su reutilización. La centralización del uso de plantillas dentro de un sistema facilita su acceso a la vez que aplica las directivas y estándares de la organización. Este proceso ayuda a mantener el control y el cumplimiento en toda la plataforma, al tiempo que permite a los desarrolladores trabajar de forma más eficaz.
Acciones de GitHub como proveedores de plataforma
Para ilustrar cómo funciona un proveedor, consideremos Acciones de GitHub y Azure Pipelines. Cualquiera de ellas puede servir como proveedor de plataforma para desarrolladores desencadenando flujos de trabajo o canalizaciones a través de sus respectivas API, como la API de REST de Acciones de GitHub o la API de canalización de Azure DevOps. Estos flujos de trabajo o canalizaciones no deben hospedarse en repositorios de código fuente de la aplicación, lo que permite a los ingenieros de plataforma mantenerlos en repositorios privados centrales. En este modelo, los desarrolladores no tienen acceso directo a los flujos de trabajo, pero pueden usar un proveedor de plataforma para desarrolladores para interactuar con ellos. El proveedor puede administrar secretos necesarios, como credenciales o claves de API, mediante la integración con servicios como Azure Key Vault. A medida que se ejecutan flujos de trabajo, el proveedor realiza un seguimiento de su estado, mediante webhooks para Acciones de GitHub y enlaces de servicio para que Azure Pipelines supervise el progreso. Una vez completado el flujo de trabajo, los artefactos generados, como los resultados de compilación o implementación, se capturan y publican. Estos artefactos, junto con los parámetros de entrada y las referencias a los flujos de trabajo, se pueden agregar al gráfico de la plataforma para desarrolladores. Este enfoque también permite flexibilidad en el uso de CLIs arbitrarios, que admiten una amplia gama de tareas de automatización a lo largo del tiempo. Además, el uso de Acciones de GitHub o Azure Pipelines en este contexto es independiente de su rol tradicional en CI/CD, lo que proporciona una aplicabilidad más amplia para administrar varios procesos y plantillas.
Hay otros tipos de proveedores de plataformas para desarrolladores, que pueden controlar varias tareas a través de plantillas. Para las operaciones de control de código fuente, los proveedores pueden ayudar a administrar tareas de Git, como crear repositorios, enviar solicitudes de incorporación de cambios u otras operaciones de Git sin depender de motores de flujo de trabajo generales. El aprovisionamiento de infraestructura se puede simplificar a través de proveedores dedicados, como Azure Deployment Environments o Terraform Cloud, centrándose en la infraestructura como código (IaC) con seguridad y eficacia. Los proveedores de scaffolding de aplicaciones, como Azure Developer CLI, admiten la creación de árboles de origen de la aplicación y la inserción en repositorios de origen, lo que agrega flexibilidad para diferentes ecosistemas. Los procesos manuales, como la generación de solicitudes de incorporación de cambios (RP) o la automatización de flujos de trabajo para no desarrolladores, también se pueden administrar a través de proveedores basados en plantillas, lo que permite la automatización gradual. Estos ejemplos resaltan cómo la extensibilidad y la capacidad de adaptación en los proveedores de plataformas para desarrolladores pueden mejorar las funcionalidades de automatización a lo largo del tiempo.