集成

将 Architecto 连接到你喜爱的工具与平台

Architecto 可与你的团队正在使用的工具无缝集成。

版本控制

GitHub

导入仓库，并在代码变更时触发架构生成。

设置：

前往集成 → GitHub
点击 连接 GitHub
授权 Architecto 访问仓库
选择指定仓库或全部仓库

使用场景：

将 Terraform 文件导入为图示
IaC 变化时自动更新架构
从仓库代码创建架构
将图示关联到拉取请求

操作：

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

GitLab

与 GitHub 集成相似 （即将推出）

从 GitLab 仓库导入
与 GitLab CI/CD 流水线集成
将图示同步到合并请求

基础设施即代码

Terraform

解析 Terraform 文件并生成架构图。

工作原理：

上传 .tf 文件或连接 GitHub
Architecto 解析提供商资源
从资源定义生成拓扑
为每个资源创建节点
根据依赖关系连接节点

示例： 上传以下 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"
}

将生成展示 VPC → 负载均衡器 → EC2 实例 → RDS 的图示。

CloudFormation

导入 AWS CloudFormation 模板。

解析 YAML/JSON 模板
从堆栈生成拓扑
支持所有 AWS 资源

Bicep

支持 Azure 基础设施语言 （即将推出）

CDK（基础设施即代码）

支持 AWS CDK （即将推出）

协作平台

Discord

在 Discord 中分享架构并接收通知。

设置：

前往集成 → Discord
点击 添加到 Discord
选择工作区并授权
选择通知频道

功能：

在 Discord 频道分享架构
接收以下通知：
- 有人与你分享架构
- 共享图示中新增评论
- 团队邀请
在 Discord 搜索架构
展开架构链接以预览内容

示例：

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

Jira

将架构关联到 Jira 问题，并根据发现创建工单。

设置：

前往集成 → Jira
输入 Jira Cloud ID
生成并粘贴 API 令牌

功能：

将架构关联到 Jira 史诗或用户故事
根据分析结果创建工单：
- 成本优化建议
- 可扩展性建议
- 安全缓解措施
- 合规问题
将架构图作为 Jira 附件
从 Architecto 更新问题状态

通信

邮件

通过邮件发送架构和报告。

与团队外人员分享图示
通过邮件发送分析报告
定时发送新架构摘要
导出并附加到邮件

Teams （即将推出）

Microsoft Teams 集成

分享到 Teams 频道
接收 Teams 通知
在 Teams 聊天中嵌入图示

分析与监控

Datadog （即将推出）

监控架构部署。

New Relic （即将推出）

追踪性能指标。

Grafana （即将推出）

可视化指标与日志。

云提供商

AWS

原生 AWS 集成（已包含）

200 多种 AWS 服务图标
定价数据集成
VPC 和安全组支持

Google Cloud Platform

GCP 集成（已包含）

GCP 服务图标
定价数据
VPC 支持

Microsoft Azure

Azure 集成（已包含）

100 多种 Azure 服务图标
定价数据
虚拟网络支持

Kubernetes

Kubernetes 与容器编排（已包含）

Pod、Deployment、Service 图标
多集群支持
Helm Chart 可视化 （即将推出）

API 测试

Postman

测试 API 和集成。

Postman 集合
导入后测试所有端点
预配置的身份验证

AI 与自动化（即将推出）

GitHub Actions

自动化架构工作流。

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

Zapier

通过 Zapier 连接 1000 多个应用。

通过 Zapier 事件触发操作
将架构发送至任意已连接应用

自定义集成

Webhook

使用 Webhook 构建自定义集成。

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

API

使用 REST API 构建所需功能。

完整 API 参考
Python、Node.js、Go、Ruby、Java SDK
GraphQL 支持 （即将推出）

集成设置最佳实践

最小权限 — 仅授权所需的权限范围
保护密钥 — 将 API 密钥保存在环境变量中
先测试 — 在预发布环境中测试集成
监控 — 追踪集成健康状况与错误率
记录 — 保持团队文档更新

故障排查

找不到集成？

查看集成页面
在 GitHub 提交功能请求
发邮件至 support@architecto.dev

集成无法运行？

检查 API 密钥是否过期
确认 Webhook URL 可以访问
查看集成设置中的错误日志
联系 support@architecto.dev

后续步骤：

集成

本页内容