いまアーキテクチャ図を draw.io で管理しているなら、代替ツールを探し始めるきっかけになる瞬間に心当たりがあるはずです。図はあるのに、どのコピーが最新なのか誰にも確信がない、という瞬間です。この記事では、アーキテクチャ図という観点に絞って draw.io(diagrams.net)と Archboard を比較し、チームが共有された最新のマップ 1 つに移ると何が変わるのかを紹介します。
要点
- draw.io は汎用のファイルベースの作図エディタです。汎用の図形を描き、
.drawioファイルを普段ファイルを置いている場所に保存します。 - Archboard はアーキテクチャのためのワークスペースです。ポート付きの型付きノード、図ごとに 1 本のリンク、自動保存とリビジョン履歴があり、ファイルを受け渡す必要はありません。
チームが運用しているシステムを図で表し、それを複数人で管理しているなら、Archboard はまさにその仕事のために作られています。
ファイルベースの図が摩擦を生むところ
draw.io は図を 1 つずつファイルとして保存します。ちょっとした図ならそれで十分ですが、チーム全体で 1 つのアーキテクチャマップを何か月も管理し始めると、問題が出てきます。
- コピーが増えていく。 誰かが設計ドキュメントに PNG を貼り、誰かがブランチで
.drawioファイルを編集し、3 つ目のコピーが共有ドライブに残っています。本番環境を表しているのはどれでしょうか。 - 図形の意味は慣習頼み。 Kubernetes のアイコンが付いた汎用の図形は正しく見えますが、それが Service なのか Deployment なのかは、ラベルとチームの習慣の中にしかありません。
- アクセス権はストレージ次第。 誰が編集できるかは、図ではなくフォルダやリポジトリの権限で決まります。
- 履歴は誰かほかの人の仕事。 Git、Google Drive、Dropbox、Confluence ならバージョンが残りますが、ノート PC や共有ドライブ上のファイルには残りません。そのため、何がいつ変わったのかは、ファイルの置き場所次第です。
Archboard の違い
Archboard はホスト型のアーキテクチャワークスペースです。保存したり受け渡したりするファイルはありません。Google か GitHub でサインインすると、最初のサインインでアカウントと組織が作成されます。クレジットカードは不要です。
- ドメイン別のノードパック。 Kubernetes、Cloud、Network、C4 Model、Data、DevOps、Security、Sequence、BPMN など、223 種類のノードを含む 27 の組み込みパックがあります。ノードは汎用の図形ではなくポートを持つ正式なノードで、ばらばらの線を引く代わりにポート同士をつなぎます。
- 図ごとに 1 本のリンク。 公開リンクを共有するか(Free ではブランド表示付き)、Pro と Enterprise ではライブの図をドキュメントサイトに埋め込めます。ドキュメントには常に最新版が表示されます。
- 自動保存とリビジョンのスナップショット。 すべての変更が保存されます。Free では直近 5 件、Pro では 1 年分のリビジョン履歴が残り、Enterprise では期間の制限なく残ります。
- 組織、ワークスペース、ロール。 アクセス権はワークスペースの一部で、Pro と Enterprise ではロールを使えます。
- キャンバス上の Markdown とコードブロック。 ランブックの抜粋や設定例を、それが説明するコンポーネントのすぐ横に置けます。
- 同じキャンバスでブレインストーミング。 付箋、ステッカー、マインドマップがアーキテクチャのパックと並んでいます。
- 構造化 JSON のインポートとエクスポート。 すべてのプランで SVG と PNG、Pro では JPEG、PDF、アニメーション GIF/WebM も使えます。
draw.io と Archboard の比較表
| draw.io / diagrams.net | Archboard | |
|---|---|---|
| 想定用途 | 汎用の作図 | アーキテクチャ図とインフラ図 |
| 構成要素 | 汎用の図形とアイコンライブラリ | 27 のドメインノードパック、ポート付きの 223 種類のノード |
| 図の置き場所 | 自分で保存・共有するファイル | Archboard のワークスペース。図ごとに 1 本のリンク |
| 最新版 | どこかにある最新のファイルコピー | 常にライブの図 |
| アクセス制御 | フォルダやリポジトリの権限 | Google/GitHub サインイン、組織、ワークスペース、ロール |
| 履歴 | ファイルの置き場所次第 | 自動保存とリビジョンのスナップショット |
| 共有 | ファイル、エクスポート、または公開ファイルへのパブリッシュリンクや埋め込みリンク | 共有リンク。Pro と Enterprise ではライブ埋め込み |
| ブレインストーミング | 図形とテキスト | アーキテクチャのパックと並ぶ付箋、ステッカー、マインドマップ |
詳しい比較は /compare/drawio、プランの詳細は /pricing をご覧ください。
Archboard が特に合うケース
Archboard は、ファイル管理に手間をかけずに、共有された最新のアーキテクチャマップを 1 つ持ちたいチームに向いています。代表的なケースは次のとおりです。
- クラスターとサービスのマップを管理するプラットフォームチーム。アカウントごとに Cloud パックの Kubernetes Cluster ノードと、その Kubernetes の
Namespaceフレームを置き、そしてポートでつながったDeployment、Service、Ingressのノードを配置します。 - 境界の中に
Person、Software System、Container、Databaseのノードを置いて、C4 のビューを最新に保つアーキテクチャグループ。 - 新しいメンバーに、正しいエクスポートを探させるのではなく 1 本のリンクを開いてほしいエンジニアリングマネージャー。
自動保存とリビジョンのスナップショットが「どのファイルが最新か」という問いに代わり、共有リンクや埋め込みが貼り付けた PNG に代わります。
ダイアグラムの内容
- prod account · eu-central-1
- prod-eks
- storefront
- payments
- Customers
- web
- psp-api-key
- payments-db (RDS)
- Payment provider
- HTTPS
- /
- payments.payments.svc
- SQL :5432
- envFrom
draw.io からの移行は午後のうちに
移行はプロジェクトではなく、大掃除だと考えましょう。
- いちばんよく使われている図から始めます。 オンボーディングのドキュメントやインシデントのランブックからリンクされている図です。
- /examples のギャラリーで似た図を開き、その構成を自分のキャンバスの参考にします。
- 型付きノードで描き直します。 破線の長方形の代わりに Namespace フレーム、ラベル付きの箱の代わりに Service ノードを使い、ポートをつなぎます。
- ファイルではなくリンクを置き換えます。 ドキュメントからは共有リンクを参照し(Pro なら埋め込みも可能)、古い
.drawioファイルはアーカイブします。
Free プランならすべてのパックで試せます。本番環境の完全なマップには、図とノードが無制限になる Pro が向いています。
よくある質問
Archboard は無料で使える draw.io の代替ツールですか? Archboard の Free プランには、1 シート、3 つのダイアグラム、すべての組み込みパック、図ごとに 15 ノード+メモ・テキスト・ステッカー・マインドマップのトピック 150 件が含まれ、実際の図で試すには十分です。一緒に編集するチームは、チームメイト用のシート、図とノードの無制限化、ロール、埋め込みのために Pro に移行します。
.drawio ファイルをインポートできますか? 直接はできません。Archboard は独自の構造化 JSON に加えて Kubernetes YAML と Docker Compose のファイルもインポートするので、残す価値のある .drawio の図を描き直すか、クラスターマップをマニフェストから作り始めます。型付きノードとポートを使えば作業は速く進み、元の図よりもすっきり仕上がります。
Archboard はオフラインで使ったり、セルフホストしたりできますか? セルフホスト版はありません。Archboard は、どのブラウザからでも開けるホスト型のワークスペースです。接続が切れても、開いているタブで作業を続けてください。変更は再接続したときに同期されます。
Archboard にはクラウドベンダーの公式アイコンセットが含まれていますか? Archboard の Cloud ノードは、公式のアイコンセットではなく、型付きでベンダーに依存しないノードです。ロゴが欲しいときは、挿入検索のブランドアイコンでプロバイダーのロゴを追加できます。各ノードにサービス名でラベルを付ければ、どのクラウドでも図が分かりやすく一貫したものになります。