連携

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 パイプラインとの連携
マージリクエストへ図を同期

Infrastructure as Code

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（Infrastructure as Code）

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 チャートの可視化 （近日公開）

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 にお問い合わせください

次のステップ:

連携

このページの内容