Primeros pasos
¡Bienvenido! Esta guía explica lo necesario para empezar a diseñar, analizar y documentar arquitecturas de nube con Architecto.
¿Qué es Architecto?
Architecto es una plataforma con IA integrada que convierte ideas de arquitectura de nube en diseños listos para producción. Tanto para infraestructura nueva como para revisar sistemas existentes, simplifica todo el proceso: concepto inicial, revisión del equipo y documentación profesional.
Capacidades principales
Generación inmediata de arquitecturas
- Lenguaje natural: describa sus necesidades con palabras claras.
- Opciones multinube: propuestas para AWS, GCP, Azure, Kubernetes y entornos híbridos.
- Lienzo visual: edite y refine con arrastrar y soltar.
Análisis inteligente
- Costos: implicaciones económicas a distintas escalas.
- Escalabilidad: cuellos de botella antes de causar problemas.
- Seguridad: modelado automático de amenazas y evaluación de vulnerabilidades.
- Simulación: predicción de latencia y procesamiento bajo carga.
Documentación profesional
- Generación automática: RFC, ADR y manuales operativos.
- Análisis de código: archivos Terraform o CloudFormation convertidos en diagramas.
- Editor enriquecido: HyperDocs con Markdown mejorado y recursos visuales integrados.
Colaboración
- Compartir con seguridad: enlaces con token e hilos de comentarios.
- Exportaciones con marca: PPT, PDF y PNG personalizados.
- Organizaciones: roles, invitaciones y licencias.
Sus primeros pasos
1. Cree una cuenta
Visite architecto.dev y regístrese con correo, OAuth o clave de acceso.
2. Explore el panel
Acceda rápidamente a:
- Proyectos recientes: arquitecturas creadas previamente.
- Biblioteca de patrones: más de 240 arquitecturas de referencia.
- Acciones rápidas: diseñar, importar código o aprender.
3. Genere su primera arquitectura
Elija un enfoque:
Opción A: Architect AI
- Pulse Crear arquitectura → Describir con IA.
- Describa: «Plataforma de comercio electrónico para 10k usuarios simultáneos, con inventario en tiempo real, pagos y conmutación multirregión».
- Revise las opciones, normalmente 3-5.
- Seleccione la preferida.
- Ajuste componentes, grupos de seguridad y flujos en el lienzo.
Opción B: biblioteca de patrones
- Pulse Crear arquitectura → Empezar con un patrón.
- Explore microservicios, sin servidor, multiinquilino, analítica y otras categorías.
- Seleccione un patrón adecuado.
- Adapte los componentes a sus requisitos.
Opción C: importar código
- Pulse Crear arquitectura → Importar Terraform.
- Conecte GitHub mediante OAuth.
- Seleccione un repositorio.
- Elija un archivo Terraform o CloudFormation.
- Architecto genera una topología e identifica oportunidades de optimización.
4. Analice la arquitectura
Después de diseñarla:
Analice costos
- Responde: «¿Cuánto costará con 1k/10k/100k usuarios?».
- Identifica saltos de costo y límites de sostenibilidad económica.
- Sugiere optimización y reducción de costos.
Compruebe escalabilidad
- Prueba cuántos usuarios simultáneos soporta cada componente.
- Identifica cuellos de botella en bases de datos, caché o balanceadores.
- Sugiere réplicas de lectura, particionamiento y escalado horizontal.
Revise seguridad
- Analiza amenazas STRIDE: suplantación, manipulación, repudio, divulgación, denegación de servicio y elevación de privilegios.
- Traza rutas de ataque y componentes vulnerables.
- Recomienda autenticación, cifrado, límites de solicitudes, WAF y otras mitigaciones.
5. Genere documentación
Convierta la arquitectura en documentación profesional:
Cree un RFC: solicitud de comentarios
- Secciones automáticas: problema, solución, contrapartidas, costos y seguridad.
- Integra diagramas, gráficos de costos y amenazas.
- Edite las secciones con HyperDocs.
Cree un ADR: registro de decisión de arquitectura
- Explica por qué eligió esa arquitectura frente a las alternativas.
- Vincula decisiones, contrapartidas y supuestos relacionados.
- Estados como En curso, Propuesto, Aceptado u Obsoleto.
Cree un manual operativo
- Incluye despliegue, supervisión y respuesta a incidentes.
- Completa dependencias, endpoints y umbrales de alarma.
6. Comparta con el equipo
- Pulse Compartir y genere un enlace con token.
- Envíelo al equipo; funciona en navegador sin cuenta.
- Los revisores pueden:
- Consultar la topología completa.
- Añadir comentarios y observaciones.
- Ver costos, seguridad y escalabilidad.
- Comparar versiones anteriores.
- Recibirá notificaciones de nuevos comentarios.
7. Exporte para presentaciones
- Pulse Exportar y elija PNG, SVG, PDF o PPT.
- Seleccione un tema o personalice:
- Colores, fuentes y fondo.
- Posición del logotipo.
- Acentos por tipo de componente.
- Descargue los materiales listos para presentar.
Conceptos fundamentales
Topología
Representación visual de la arquitectura: nodos conectados por flujos. Cada nodo representa un componente como EC2, Lambda o RDS.
Nodo
Un componente individual. Architecto precarga iconos para más de 200 servicios AWS, GCP, Azure y genéricos.
Flujo
Conexión que muestra movimiento de datos: API síncrona, mensajería asíncrona o consultas de base de datos.
Perfil
Configuración de proveedor. Architecto incluye AWS con precios, GCP, Azure, Kubernetes y Docker.
Módulo de análisis
Herramienta para evaluar costos, seguridad, escalabilidad, rendimiento o cumplimiento.
Tema
Personalización de exportación: colores, fuentes, iconos, fondos y disposición.
Flujos habituales
Ciclo de revisión
- El diseñador crea la arquitectura inicial.
- La comparte con un enlace con token.
- Los revisores añaden sugerencias.
- El diseñador refina la topología y regenera el análisis.
- La comparación muestra los cambios.
- La aprobación final se documenta en un ADR.
Planificación de migración
- Dibuje la infraestructura local o de nube actual.
- Diseñe la arquitectura multinube de destino.
- Use Comparación de arquitecturas para planificar pasos.
- Compare los costos actuales y previstos.
- Genere un manual de migración por fases.
Respuesta a incidentes
- El SRE dibuja rápidamente la topología y sus fallos.
- La comparte con el equipo de coordinación.
- El equipo anota causas sospechadas y servicios afectados.
- Después, conviértala en un manual para prevenir recurrencias.
Rutas de aprendizaje
- Empiece con cuestionarios de fundamentos, cómputo y almacenamiento.
- Avance con tarjetas y repetición espaciada.
- Aplique lo aprendido a una arquitectura real.
- Obtenga comentarios mediante revisión del equipo.
Siguientes pasos
- Aprenda los conceptos → Conceptos fundamentales
- Explore funciones → Guía de funciones
- Revise patrones → Patrones de arquitectura
- Consulte integraciones → Integraciones
¿Preguntas? Consulte las preguntas frecuentes o entre en el Discord de la comunidad.