Intégrations

Architecto s’intègre aux outils de votre équipe.

Gestion de versions

GitHub

Importez les dépôts et générez l’architecture quand le code change.

Configuration :

1. Intégrations → GitHub.
2. Cliquez sur Connecter GitHub.
3. Autorisez Architecto à accéder aux dépôts.
4. Choisissez certains dépôts ou tous.

Usages :

• Importer Terraform en diagrammes.
• Actualiser l’architecture avec l’IaC.
• Créer depuis le code des dépôts.
• Relier les diagrammes aux demandes de modification.

Actions :

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

GitLab

Comparable à GitHub (bientôt).

• Import de dépôts.
• Intégration GitLab CI/CD.
• Synchronisation avec les demandes de fusion.

Infrastructure comme code

Terraform

Interprétez Terraform et générez des diagrammes.

Fonctionnement :

1. Envoyez un fichier .tf ou connectez GitHub.
2. Architecto interprète les ressources fournisseur.
3. Génère la topologie depuis les définitions.
4. Crée un nœud par ressource.
5. Relie selon les dépendances.

Exemple : envoyer ce fichier :

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"
}

Produit VPC → répartiteur → instances EC2 → RDS.

CloudFormation

Importez les modèles AWS CloudFormation.

• Interprétation YAML/JSON.
• Topologie depuis les piles.
• Toutes les ressources AWS.

Bicep

Langage d’infrastructure Azure (bientôt).

CDK : infrastructure comme code

Prise en charge d’AWS CDK (bientôt).

Collaboration

Discord

Partagez les architectures et recevez les notifications.

Configuration :

1. Intégrations → Discord.
2. Cliquez sur Ajouter à Discord.
3. Choisissez l’espace et autorisez.
4. Choisissez le canal.

Fonctions :

• Partage dans les canaux.
• Notifications de :
  • Partages reçus.
  • Commentaires sur les diagrammes.
  • Invitations d’équipe.
• Recherche d’architectures dans Discord.
• Aperçu enrichi des liens.

Exemple :

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

Jira

Reliez architectures et tickets, puis créez des tickets depuis les constats.

Configuration :

1. Intégrations → Jira.
2. Saisissez l’ID Jira Cloud.
3. Générez et collez un jeton d’API.

Fonctions :

• Lien vers épopées et récits Jira.
• Tickets pour :
  • Optimisation des coûts.
  • Montée en charge.
  • Protections de sécurité.
  • Conformité.
• Diagrammes en pièces jointes.
• Statut mis à jour depuis Architecto.

Communications

E-mail

Envoyez architectures et rapports.

• Partagez hors de l’équipe.
• Envoyez les analyses.
• Planifiez des récapitulatifs des nouvelles architectures.
• Exportez et joignez les résultats.

Teams (bientôt)

Intégration Microsoft Teams.

• Partage dans les canaux.
• Notifications.
• Diagrammes intégrés aux discussions.

Analytique et supervision

Datadog (bientôt)

Supervisez les déploiements.

New Relic (bientôt)

Suivez les performances.

Grafana (bientôt)

Visualisez métriques et journaux.

Fournisseurs cloud

AWS

Intégration native AWS, déjà incluse.

• Icônes de plus de 200 services.
• Tarification intégrée.
• VPC et groupes de sécurité.

Google Cloud Platform

Intégration GCP, déjà incluse.

• Icônes des services.
• Tarification.
• VPC.

Microsoft Azure

Intégration Azure, déjà incluse.

• Icônes de plus de 100 services.
• Tarification.
• Réseaux virtuels.

Kubernetes

Kubernetes et orchestration, déjà inclus.

• Icônes de pods, déploiements et services.
• Plusieurs clusters.
• Visualisation des charts Helm, bientôt.

Tests d’API

Postman

Testez les API et intégrations.

• Collection Postman
• Importez pour tester tous les points d’accès.
• Authentification préconfigurée.

IA et automatisation (bientôt)

GitHub Actions

Automatisez les processus d’architecture.

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

Zapier

Connectez plus de 1000 applications.

• Déclenchez avec les événements Zapier.
• Envoyez les architectures aux applications connectées.

Intégrations personnalisées

Webhooks

Créez vos intégrations par webhooks.

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

API

Créez vos solutions avec l’API REST.

• Référence complète
• SDK Python, Node.js, Go, Ruby et Java.
• GraphQL, bientôt.

Bonnes pratiques de configuration

1. Moindre privilège : seulement les portées nécessaires.
2. Secrets sécurisés : clés dans les variables d’environnement.
3. Tests d’abord : utilisez la préproduction.
4. Supervision : santé et taux d’erreurs.
5. Documentation : gardez les références à jour.

Dépannage

Intégration introuvable ?

• Consultez la page des intégrations.
• Demandez une fonction sur GitHub.
• Écrivez à support@architecto.dev.

Intégration en panne ?

• Vérifiez l’expiration de la clé.
• Vérifiez l’accès à l’URL du webhook.
• Consultez les erreurs dans les paramètres.
• Contactez support@architecto.dev.

Étapes suivantes :

• Référence de l’API
• Exemples de processus