Integraciones

Conecte Architecto con sus herramientas y plataformas habituales

Architecto se integra con las herramientas que su equipo ya utiliza.

Control de versiones

GitHub

Importe repositorios e inicie la generación de arquitectura al cambiar el código.

Configuración:

Vaya a Integraciones → GitHub.
Haga clic en Conectar GitHub.
Autorice el acceso de Architecto a los repositorios.
Elija repositorios concretos o todos.

Casos de uso:

Importar archivos Terraform como diagramas.
Actualizar la arquitectura cuando cambia IaC.
Crear arquitecturas desde el código del repositorio.
Vincular diagramas a solicitudes de cambios.

Acciones:

- Import Terraform from GitHub
- Watch for changes in .tf files
- Create PR comments with diagram preview
- Sync architecture to GitHub discussion

GitLab

Similar a la integración GitHub (próximamente).

Importación desde repositorios GitLab.
Integración con procesos GitLab CI/CD.
Sincronización de diagramas con solicitudes de fusión.

Infraestructura como código

Terraform

Interprete archivos Terraform y genere diagramas de arquitectura.

Cómo funciona:

Cargue un archivo .tf o conecte GitHub.
Architecto interpreta los recursos del proveedor.
Genera la topología desde las definiciones.
Crea un nodo para cada recurso.
Los conecta según sus dependencias.

Ejemplo: al cargar este archivo Terraform:

resource "aws_vpc" "main" {
  cidr_block = "10.0.0.0/16"
}

resource "aws_lb" "main" {
  load_balancer_type = "application"
}

resource "aws_instance" "app" {
  instance_type = "t3.medium"
  count         = 3
}

resource "aws_rds_cluster" "db" {
  engine = "aurora-postgresql"
}

Se genera: VPC → balanceador de carga → instancias EC2 → RDS.

CloudFormation

Importe plantillas AWS CloudFormation.

Interpretación de plantillas YAML/JSON.
Generación de topologías desde pilas.
Compatibilidad con todos los recursos AWS.

Bicep

Lenguaje de infraestructura Azure (próximamente).

CDK: infraestructura como código

Compatibilidad con AWS CDK (próximamente).

Plataformas de colaboración

Discord

Comparta arquitecturas y reciba notificaciones en Discord.

Configuración:

Vaya a Integraciones → Discord.
Haga clic en Añadir a Discord.
Seleccione el espacio de trabajo y autorice.
Elija el canal de notificaciones.

Funciones:

Compartir arquitecturas en canales Discord.
Recibir notificaciones sobre:
- Arquitecturas compartidas con usted.
- Comentarios en diagramas compartidos.
- Invitaciones de equipo.
Buscar arquitecturas en Discord.
Mostrar vistas previas de enlaces de arquitectura.

Ejemplo:

/architecto share my-ecommerce-arch #team-architecture

Jira

Vincule arquitecturas a incidencias Jira y cree tickets desde los hallazgos.

Configuración:

Vaya a Integraciones → Jira.
Introduzca el ID de Jira Cloud.
Genere y pegue un token de API.

Funciones:

Vincular arquitecturas a épicas e historias Jira.
Crear tickets desde los análisis:
- Sugerencias de optimización de costos.
- Recomendaciones de escalabilidad.
- Mitigaciones de seguridad.
- Problemas de cumplimiento.
Adjuntar diagramas a Jira.
Actualizar estados desde Architecto.

Comunicaciones

Correo electrónico

Envíe arquitecturas e informes por correo.

Comparta diagramas con personas externas al equipo.
Envíe informes de análisis.
Programe resúmenes de arquitecturas nuevas.
Exporte y adjunte los resultados.

Teams (próximamente)

Integración Microsoft Teams.

Comparta en canales Teams.
Reciba notificaciones.
Incruste diagramas en chats.

Analítica y supervisión

Datadog (próximamente)

Supervise despliegues de arquitectura.

New Relic (próximamente)

Siga las métricas de rendimiento.

Grafana (próximamente)

Visualice métricas y registros.

Proveedores de nube

AWS

Integración nativa AWS, ya incluida.

Iconos de más de 200 servicios AWS.
Integración de datos de precios.
Compatibilidad con VPC y grupos de seguridad.

Google Cloud Platform

Integración GCP, ya incluida.

Iconos de servicios GCP.
Datos de precios.
Compatibilidad con VPC.

Microsoft Azure

Integración Azure, ya incluida.

Iconos de más de 100 servicios Azure.
Datos de precios.
Compatibilidad con redes virtuales.

Kubernetes

Kubernetes y orquestación de contenedores, ya incluidos.

Iconos de pods, despliegues y servicios.
Compatibilidad con varios clústeres.
Visualización de charts Helm, próximamente.

Pruebas de API

Postman

Pruebe las API y las integraciones.

Colección de Postman
Impórtela para probar todos los endpoints.
Autenticación preconfigurada.

IA y automatización (próximamente)

GitHub Actions

Automatice los flujos de arquitectura.

- name: Update Architecture
  uses: architecto/update-architecture@v1
  with:
    terraform-path: ./infrastructure
    api-key: ${{ secrets.ARCHITECTO_API_KEY }}

Zapier

Conecte más de 1000 aplicaciones con Zapier.

Inicie acciones con eventos Zapier.
Envíe arquitecturas a cualquier aplicación conectada.

Integraciones personalizadas

Webhooks

Cree integraciones propias mediante webhooks.

POST /webhooks
{
  "url": "https://your-app.com/architecto-webhook",
  "events": ["architecture.created", "analysis.completed"]
}

API

Utilice la API REST para crear sus soluciones.

Referencia completa de la API
SDK para Python, Node.js, Go, Ruby y Java.
Compatibilidad con GraphQL, próximamente.

Mejores prácticas de configuración

Mínimo privilegio: autorice solo los ámbitos necesarios.
Secretos seguros: guarde claves en variables de entorno.
Pruebas primero: pruebe la integración en preproducción.
Supervisión: siga su estado y la tasa de errores.
Documentación: mantenga actualizada la documentación del equipo.

Solución de problemas

¿No encuentra una integración?

Consulte la página de integraciones.
Solicite una función en GitHub.
Escriba a support@architecto.dev.

¿La integración no funciona?

Compruebe la caducidad de la clave.
Verifique que la URL del webhook sea accesible.
Consulte los errores en la configuración de integración.
Contacte con support@architecto.dev.

Siguientes pasos:

Integraciones

En esta página