はじめに
ようこそ。このガイドでは、Architecto でクラウドアーキテクチャの設計、分析、文書化を始めるために必要なことを紹介します。
Architecto とは
Architecto は、クラウドアーキテクチャのアイデアを本番環境に対応する設計へ変える AI ネイティブなプラットフォームです。新しいインフラの構想から既存システムのレビューまで、初期のアイデア、チームレビュー、業務用ドキュメントの作成という一連の流れを効率化します。
主な機能
即座にアーキテクチャを生成
- 自然言語で入力 — 必要なインフラを分かりやすい言葉で説明
- マルチクラウドの選択肢 — AWS、GCP、Azure、Kubernetes、ハイブリッド環境向けの提案
- ビジュアルキャンバス — 直感的なドラッグ＆ドロップで図を編集・改善
インテリジェントな分析
- コスト分析 — 規模別の費用への影響を理解
- スケーラビリティテスト — 問題になる前にボトルネックを特定
- セキュリティレビュー — 脅威モデリングと脆弱性評価を自動化
- パフォーマンスシミュレーション — 負荷時のレイテンシーとスループットを予測
業務用ドキュメント
- 文書の自動生成 — アーキテクチャから RFC、ADR、ランブックを作成
- コード分析 — 既存の Terraform・CloudFormation を解析して図に変換
- リッチエディター — HyperDocs で図表入りの高度な Markdown を作成
チームでの共同作業
- 安全な共有 — トークン付きリンク、コメントスレッド、フィードバック
- ブランド付き出力 — テーマを指定した PPT、PDF、PNG
- 組織管理 — メンバーのロール、招待、ライセンス
最初のステップ
1. アカウントを作成
architecto.dev で、メール、OAuth、パスキーのいずれかを使って登録します。
2. ダッシュボードを見る
ダッシュボードから次にすぐアクセスできます。
- 最近のプロジェクト — 作成済みのアーキテクチャ
- パターンライブラリ — 業界標準の 240 種類以上の参照アーキテクチャ
- クイックアクション — 設計、コードのインポート、学習を始めるボタン
3. 最初のアーキテクチャを生成
方法を選びます。
選択肢 A：Architect AI を使う
- 「アーキテクチャを作成」 → 「AI に説明」 をクリックします
- 自然言語で入力します。例：「同時ユーザー 1 万人の E コマースで、在庫のリアルタイム同期、決済処理、マルチリージョンのフェイルオーバーが必要」
- 生成された案を確認します（通常 3〜5 案）
- 希望するアーキテクチャを選択します
- キャンバスでコンポーネントを調整し、セキュリティグループやデータフローを変更します
選択肢 B：パターンライブラリを使う
- 「アーキテクチャを作成」 → 「パターンから開始」 をクリックします
- マイクロサービス、サーバーレス、マルチテナント、データ分析などを閲覧します
- 用途に合うパターンを選びます
- 要件に合わせてコンポーネントを調整します
選択肢 C：コードからインポート
- 「アーキテクチャを作成」 → 「Terraform からインポート」 をクリックします
- GitHub アカウントを OAuth で接続します
- リポジトリを選択します
- Terraform・CloudFormation ファイルを選択します
- Architecto がトポロジー図を生成し、最適化の余地を特定します
4. アーキテクチャを分析
設計が終わったら、次を行います。
コスト分析を実行
- 「1,000/1 万/10 万ユーザーでいくらかかるか」に回答
- コストの急増点と金銭的な持続可能性の限界を特定
- 最適化戦略とコスト削減案を提案
スケーラビリティを確認
- 各コンポーネントが対応できる同時ユーザー数を検証
- ボトルネック（通常はデータベース、キャッシュ、ロードバランサー）を特定
- リードレプリカ、シャーディング、水平スケーリングを提案
セキュリティを確認
- STRIDE の脅威（なりすまし、改ざん、否認、情報漏えい、サービス拒否、権限昇格）を分析
- 攻撃経路と脆弱なコンポーネントを可視化
- 認証、暗号化、レート制限、WAF などの対策を提案
5. ドキュメントを生成
アーキテクチャから業務用の文書を作成します。
RFC（Request for Comments）を作成
- 課題、解決策の概要、トレードオフ、コスト分析、セキュリティの考慮事項を自動生成
- アーキテクチャ図、コストグラフ、脅威分析を埋め込み
- HyperDocs でセクションを編集可能
ADR（Architecture Decision Record）を作成
- 他の案よりこの設計を選んだ理由を記録
- 関連する判断、トレードオフ、前提にリンク
- 対応中、提案済み、承認済み、非推奨などの状態を管理
ランブックを作成
- デプロイ手順、監視設定、インシデント対応手順を記載
- 依存関係、エンドポイント情報、アラーム閾値を自動入力
6. チームに共有
- 「共有」 をクリックし、トークン付きリンクを生成します
- チームに送ります（アカウント不要、ブラウザーで利用可能）
- レビュアーは次ができます。
- トポロジー全体の閲覧
- インラインコメントとフィードバック
- 分析結果の確認（コスト、セキュリティ、スケーラビリティ）
- 以前のバージョンとの比較
- コメント追加時に通知されます
7. プレゼンテーション用に出力
- 「エクスポート」 で形式を選びます（PNG、SVG、PDF、PPT）
- テーマを選ぶか、自社ブランドを設定します。
- 色、フォント、背景スタイル
- ロゴの位置
- コンポーネントの種類ごとのアクセントカラー
- そのまま発表できる資料をダウンロードします
基本概念
トポロジー
アーキテクチャの視覚表現で、ノードをフローで接続します。各ノードは EC2、Lambda、RDS などのクラウドコンポーネントです。
ノード
アーキテクチャ内の単一コンポーネントです。Architecto は AWS、GCP、Azure、汎用サービスの 200 種類以上のアイコンを搭載しています。
フロー
データの移動を示す接続です。同期 API、非同期メッセージング、データベースクエリなどを表します。
プロファイル
クラウドプロバイダーの設定です。Architecto は AWS（料金データ付き）、GCP、Azure、Kubernetes、Docker の設定を内蔵しています。
分析モジュール
コスト、セキュリティ、スケーラビリティ、性能、準拠など、設計の一側面を評価する専用ツールです。
テーマ
出力時の見た目の設定です。色、フォント、アイコン、背景、レイアウトなどを指定します。
一般的なワークフロー
アーキテクチャのレビューサイクル
- 設計者が初期設計を作成
- トークン付きリンクでレビュアーに共有
- レビュアーがコメントと提案を追加
- 設計者がトポロジーを改善し、分析を再実行
- バージョン比較で変更点を確認
- 最終承認を ADR に記録
移行計画
- 現在のオンプレミス・クラウド構成を描く
- 移行先のマルチクラウド設計を作成
- 「アーキテクチャ差分」で移行手順を計画
- 現在と移行先のコストを比較
- 段階的な移行ランブックを生成
インシデント対応
- SRE が障害点を示すトポロジーを素早く描く
- 対応チームにリンクで共有
- 原因候補や影響サービスの注釈を追加
- 事後にランブックへ変換し、再発を防ぐ
学習パス
- 初級クイズ（クラウド基礎、コンピューティング、ストレージ）から開始
- 間隔反復のフラッシュカードに進む
- 実際のアーキテクチャ設計で学んだことを応用
- チームレビューでフィードバックを得る
次のステップ
- 基本概念を学ぶ → 基本概念 を読む
- 機能を探す → 機能ガイド を見る
- パターンを確認する → アーキテクチャパターン を探す
- 連携を確認する → 連携 を見る
ご質問はありますか？ よくある質問 をご確認いただくか、コミュニティ Discord にご参加ください。