Integrationen

Verbinden Sie Architecto mit Ihren bevorzugten Werkzeugen und Plattformen

Architecto verbindet sich mit den Werkzeugen, die Ihr Team bereits nutzt.

Versionskontrolle

GitHub

Repositorys importieren und bei Codeänderungen Architekturen generieren.

Einrichtung:

Integrationen → GitHub öffnen.
GitHub verbinden wählen.
Architecto den Repository-Zugriff erlauben.
Einzelne oder alle Repositorys auswählen.

Anwendungsfälle:

Terraform-Dateien als Diagramme importieren.
Architektur bei IaC-Änderungen aktualisieren.
Aus Repository-Code Architekturen erstellen.
Diagramme mit Pull Requests verbinden.

Aktionen:

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

GitLab

Ähnlich der GitHub-Integration (demnächst).

Repository-Import.
GitLab-CI/CD-Integration.
Diagramme mit Merge Requests synchronisieren.

Infrastructure as Code

Terraform

Terraform-Dateien parsen und Diagramme erzeugen.

Ablauf:

.tf-Datei hochladen oder GitHub verbinden.
Architecto parst Anbieterressourcen.
Topologie aus Definitionen erzeugen.
Knoten für jede Ressource erstellen.
Nach Abhängigkeiten verbinden.

Beispiel: diese Datei hochladen:

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

Das Diagramm zeigt VPC → Lastverteiler → EC2-Instanzen → RDS.

CloudFormation

AWS-CloudFormation-Vorlagen importieren.

YAML/JSON parsen.
Topologien aus Stacks erzeugen.
Alle AWS-Ressourcen unterstützen.

Bicep

Azure-Infrastruktursprache (demnächst).

CDK: Infrastructure as Code

AWS-CDK-Unterstützung (demnächst).

Zusammenarbeitsplattformen

Discord

Architekturen teilen und Benachrichtigungen erhalten.

Einrichtung:

Integrationen → Discord öffnen.
Zu Discord hinzufügen wählen.
Arbeitsbereich auswählen und autorisieren.
Benachrichtigungskanal wählen.

Funktionen:

Architekturen in Kanälen teilen.
Benachrichtigungen über:
- Freigegebene Architekturen.
- Kommentare in Diagrammen.
- Teameinladungen.
Architekturen in Discord suchen.
Architekturverweise mit Vorschau aufklappen.

Beispiel:

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

Jira

Architekturen mit Vorgängen verbinden und Tickets aus Befunden erstellen.

Einrichtung:

Integrationen → Jira öffnen.
Jira-Cloud-ID eingeben.
API-Token erzeugen und einfügen.

Funktionen:

Architekturen mit Epics und Storys verbinden.
Tickets erstellen für:
- Kostensenkung.
- Skalierbarkeit.
- Sicherheitsmaßnahmen.
- Compliance-Probleme.
Diagramme als Jira-Anhänge hinzufügen.
Status aus Architecto aktualisieren.

Kommunikation

E-Mail

Architekturen und Berichte versenden.

Mit Personen außerhalb des Teams teilen.
Analyseberichte versenden.
Zusammenfassungen neuer Architekturen planen.
Exportieren und anhängen.

Teams (demnächst)

Microsoft-Teams-Integration.

In Kanälen teilen.
Benachrichtigungen empfangen.
Diagramme in Chats einbetten.

Analyse und Überwachung

Datadog (demnächst)

Architekturbereitstellungen überwachen.

New Relic (demnächst)

Leistungsmetriken verfolgen.

Grafana (demnächst)

Metriken und Protokolle visualisieren.

Cloud-Anbieter

AWS

Native AWS-Integration, bereits enthalten.

Symbole für über 200 AWS-Dienste.
Preisdatenintegration.
VPCs und Sicherheitsgruppen.

Google Cloud Platform

GCP-Integration, bereits enthalten.

Dienstsymbole.
Preisdaten.
VPC-Unterstützung.

Microsoft Azure

Azure-Integration, bereits enthalten.

Symbole für über 100 Dienste.
Preisdaten.
Virtuelle Netzwerke.

Kubernetes

Kubernetes und Containerorchestrierung, bereits enthalten.

Pod-, Deployment- und Dienstsymbole.
Mehrere Cluster.
Helm-Chart-Visualisierung, demnächst.

API-Tests

Postman

APIs und Integrationen testen.

Postman-Sammlung
Für alle Endpunkte importieren.
Vorkonfigurierte Authentifizierung.

KI und Automatisierung (demnächst)

GitHub Actions

Architekturabläufe automatisieren.

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

Zapier

Über 1000 Anwendungen verbinden.

Aktionen bei Zapier-Ereignissen auslösen.
Architekturen an verbundene Anwendungen senden.

Eigene Integrationen

Webhooks

Eigene Integrationen mit Webhooks entwickeln.

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

API

Eigene Lösungen mit der REST-API erstellen.

Vollständige API-Referenz
SDKs für Python, Node.js, Go, Ruby und Java.
GraphQL-Unterstützung, demnächst.

Bewährte Einrichtungsverfahren

Minimale Rechte: nur nötige Berechtigungen.
Sichere Geheimnisse: Schlüssel in Umgebungsvariablen speichern.
Zuerst testen: Staging verwenden.
Überwachen: Zustand und Fehlerraten verfolgen.
Dokumentieren: Teamunterlagen aktuell halten.

Fehlerbehebung

Integration nicht gefunden?

Integrationsseite prüfen.
Funktion auf GitHub vorschlagen.
An support@architecto.dev schreiben.

Integration funktioniert nicht?

Schlüsselablauf prüfen.
Erreichbarkeit der Webhook-URL prüfen.
Fehlerprotokolle in den Einstellungen lesen.
support@architecto.dev kontaktieren.

Nächste Schritte:

Integrationen

Auf dieser Seite