Backstage インポート
Backstage カタログを Archyl にインポート

Backstage は稼働しているものを一覧にします。Archyl は同じカタログをたどれる C4 モデルに変えます。System はシステムに、Component と Resource はコンテナになり、API エンティティはコントラクトになって、その spec はそのまま保持され、提供側と利用側のサービスにリンクされます。Backstage はそのまま使い続けられます。オーナーシップは引き継がれず、得られるのは 2 つの C4 レベルです。

料金を見る
catalog-info.yamlBackstage
1apiVersion: backstage.io/v1alpha1
2kind: Component
3metadata:
4  name: checkout-api
5spec:
6  type: service
7  system: storefront
8  owner: payments-squad
9  providesApis: [checkout]
10  dependsOn:
11    - resource:orders-db
Reading…
app.archyl.com
Aurora Commerce/Containers
Search the architecture…K
ALMDKS
AI
インポートされるもの

すべてを Archyl へ引き継げます

インポート時もアーキテクチャモデルはそのまま保持されます。

Systems

すべての System エンティティが、説明とタグを保ったまま C4 のソフトウェアシステムになります。namespace をまたいで同名の System が 2 つある場合はマージではなくリネームされ、どれがリネームされたかはインポート結果で通知されます。

Components

Component は、それを所有する System の配下のコンテナになります。所有関係は spec.system または partOf リレーションから解決されます。spec.type もマッピングされ、service はサービス、website は Web アプリ、cronworkflow はワーカー、library はライブラリになります。

Resources

Resource もコンテナになり、型は spec.type から決まります。RDS インスタンスと Valkey クラスタはデータベースに、Kafka トピックと SQS キューはメッセージキューに、S3 バケットはファイルストレージになります。

API spec

API エンティティは Archyl の API コントラクトになります。インラインの spec.definition はそのまま保持され、HTTP、gRPC、GraphQL、async のいずれかに分類され、提供側と利用側のコンテナにリンクされます。

Relations

dependsOn、consumesApi、producesTo、consumesFrom、versionedIn は型付きのリレーションになります。Backstage はほとんどの relations を双方向に出力しますが、インポートはそのうち片方のみを保持します。consumesApi のエッジは API を経由して、実際にそれを提供しているコンテナまで解決されます。

Namespace と lifecycle

metadata.tags はそのまま引き継がれ、namespace、lifecycle、type もプレフィックス付きのタグとして加わります。Backstage で整えたグルーピングがアーキテクチャモデルでも残ります。

ステップごとに

移行は数日ではなく数分で

複雑なツールも、手作業での再入力も不要です。

1

カタログをエクスポート

Backstage の catalog API を呼び出し、レスポンスを保存してください。entities エンドポイントは、把握しているすべての System、Component、Resource、API を 1 つの JSON 配列として返します。

2

Backstage フォーマットを選択

Archyl のインポートダイアログで "Backstage" タブを選択してください。Backstage が出力した entities 配列を、加工なしでそのまま受け付けます。

3

entities.json をアップロードまたは貼り付け

ファイルをアップロードするか内容を貼り付けて、検証してください。インポートを確定する前に、Archyl が JSON のエラーを報告します。

4

インポートして、警告を読む

Archyl がモデルを構築し、作成したシステム、コンテナ、API コントラクト、リレーションの数と、リネームせざるを得なかったエンティティをすべて報告します。オーナーはインポート後に割り当ててください。Backstage の Group と User はインポートされません。

得られるもの

移行後に Archyl が加えるもの

インポートが終われば、持ち込んだモデルの上でこれらの機能が使えます。

ドリフト検出

ドキュメントが実際のコードベースをどれだけ正確に反映しているかを示す 0-100% のヘルススコアを取得。ドリフトが蓄積する前に検出します。

コンフォーマンスルール

アーキテクチャルールを定義し、自動チェックを実行して、システムが定義されたガードレール内に収まることを確保します。

DORA メトリクス

デプロイ頻度、リードタイム、変更失敗率、復旧時間をアーキテクチャの健全性と合わせて追跡します。

MCP サーバー（191 ツール）

191 の専門 MCP ツールを通じて、Claude、Cursor、Windsurf からアーキテクチャデータを照会できます。

アーキテクチャ決定記録

ADR を C4 要素に直接リンクし、すべての設計決定にトレース可能なコンテキストを持たせます。

API コントラクト

OpenAPI、AsyncAPI、GraphQL スキーマをコンテナとコンポーネントに添付。コントラクトをアーキテクチャとバージョン管理します。

乗り換え前によくいただく質問

Backstage をやめる必要がありますか？

いいえ、ほとんどのチームはやめるべきではありません。Backstage は開発者ポータルであり、Archyl はアーキテクチャモデルです。インポートはカタログのエクスポートを読み込むだけで、Backstage インスタンスには一切触れません。両方をそのまま運用できます。Archyl が答えるのは、フラットなカタログでは答えられない問いです。これらのサービスがどう組み合わさっているのか、どこがコードからドリフトしているのか、そのうち 1 つが変わるとどのコントラクトが壊れるのか。

インポートで C4 のレベルはいくつ得られますか？

2 つです。System は C4 レベル 1 に、Component と Resource はどちらもコンテナとしてレベル 2 に入ります。Backstage には Component より下のエンティティ kind が存在しないため、レベル 3 を埋める材料がありません。コンポーネントとコード要素は、あとから手で追加するか、Archyl の AI ディスカバリーをリポジトリに向けて提案を承認してください。

オーナーシップは引き継がれますか？

いいえ。User と Group のエンティティはスキップされ、ownedBy リレーションもマッピングされないため、spec.owner が Archyl のオーナーになることはありません。ここだけは計画しておく価値があります。Archyl のオーナーシップマップを使う場合は、インポート後にオーナーを割り当ててください。

OpenAPI や gRPC の spec はどうなりますか？

インラインの spec.definition を持つ API エンティティは、その spec を一字一句そのまま Archyl の API コントラクトとして保持します。spec.type から HTTP、gRPC、GraphQL、async のいずれかに分類され、提供側と利用側のコンテナにリンクされます。インライン定義のない API エンティティも、名前、説明、種別は取り込まれますが、本文はありません。

インポートがスキップするものは？

User と Group のエンティティ、およびそれらを指す ownedBy リレーション。Location と Template のエンティティ。metadata.annotations と metadata.links のブロック。つまり TechDocs へのポインタは引き継がれません。マッピング対象外の relations は無視されます。重複したエンティティとリネームされたエンティティについてはインポートが警告します。上記の kind は警告なしに破棄されるため、このページで明示しています。

カタログに自動検出された Resource が数千件あります。すべて取り込まれますか？

はい。Resource はすべてインポートされます。整えてきたデータを黙って捨てるほうが、取り込みすぎよりも悪いからです。各コンテナは Backstage の spec.type から取った種別タグを保持するのでノイズの多いカテゴリも識別できますし、エクスポート前に Backstage の filter クエリパラメータで対象を絞り込むこともできます。

カタログが変わったら再インポートできますか？

はい。エクスポートしてもう一度インポートしてください。Archyl は名前で照合し、見つかったものを更新し、新しいものを作成します。モデルはカタログから分岐せず、追従します。同じインポートは MCP サーバーの import_dsl ツールから backstage フォーマットで利用できるので、CI から実行することもできます。

ずっと無料のプラン

カタログをアーキテクチャとして見る

エクスポート 1 回、インポート 1 回。すでに整えてきたシステム、サービス、resource、API spec が、ドリフト検出、コンフォーマンスルール、MCP サーバーを備えた C4 モデルになります。Backstage はこれまでどおりの役割を続けます。

  • クレジットカード不要
  • 5 分でセットアップ
  • 閲覧者はいつでも無料
デモを予約クイックスタートを読む

BackstageカタログをArchylにインポート: BackstageからC4へ

Backstage Software CatalogをたどれるC4モデルに変換。System、Component、Resource、インラインAPI specをentities.jsonからインポート。オーナーシップはBackstageに残ります。

backstage

Backstage

Backstage インポート

Backstage カタログを Archyl にインポート

Backstage は稼働しているものを一覧にします。Archyl は同じカタログをたどれる C4 モデルに変えます。System はシステムに、Component と Resource はコンテナになり、API エンティティはコントラクトになって、その spec はそのまま保持され、提供側と利用側のサービスにリンクされます。Backstage はそのまま使い続けられます。オーナーシップは引き継がれず、得られるのは 2 つの C4 レベルです。

Backstage カタログを Archyl にインポート | Backstage から C4 へ

Backstage Software Catalog をたどれる C4 アーキテクチャモデルに変換。System、Component、Resource、インライン API spec を entities.json からインポート。オーナーシップは Backstage に残ります。

Backstage から C4, Backstage カタログ インポート, Backstage カタログ エクスポート, Backstage アーキテクチャ図, Backstage software catalog C4 モデル, Backstage アーキテクチャドキュメント

Systems

すべての System エンティティが、説明とタグを保ったまま C4 のソフトウェアシステムになります。namespace をまたいで同名の System が 2 つある場合はマージではなくリネームされ、どれがリネームされたかはインポート結果で通知されます。

Components

Component は、それを所有する System の配下のコンテナになります。所有関係は spec.system または partOf リレーションから解決されます。spec.type もマッピングされ、service はサービス、website は Web アプリ、cronworkflow はワーカー、library はライブラリになります。

Database

Resources

Resource もコンテナになり、型は spec.type から決まります。RDS インスタンスと Valkey クラスタはデータベースに、Kafka トピックと SQS キューはメッセージキューに、S3 バケットはファイルストレージになります。

FileText

API spec

API エンティティは Archyl の API コントラクトになります。インラインの spec.definition はそのまま保持され、HTTP、gRPC、GraphQL、async のいずれかに分類され、提供側と利用側のコンテナにリンクされます。

ArrowLeftRight

Relations

dependsOn、consumesApi、producesTo、consumesFrom、versionedIn は型付きのリレーションになります。Backstage はほとんどの relations を双方向に出力しますが、インポートはそのうち片方のみを保持します。consumesApi のエッジは API を経由して、実際にそれを提供しているコンテナまで解決されます。

Namespace と lifecycle

metadata.tags はそのまま引き継がれ、namespace、lifecycle、type もプレフィックス付きのタグとして加わります。Backstage で整えたグルーピングがアーキテクチャモデルでも残ります。

カタログをエクスポート

Backstage の catalog API を呼び出し、レスポンスを保存してください。entities エンドポイントは、把握しているすべての System、Component、Resource、API を 1 つの JSON 配列として返します。

FileCode

Backstage フォーマットを選択

Archyl のインポートダイアログで "Backstage" タブを選択してください。Backstage が出力した entities 配列を、加工なしでそのまま受け付けます。

entities.json をアップロードまたは貼り付け

ファイルをアップロードするか内容を貼り付けて、検証してください。インポートを確定する前に、Archyl が JSON のエラーを報告します。

インポートして、警告を読む

Archyl がモデルを構築し、作成したシステム、コンテナ、API コントラクト、リレーションの数と、リネームせざるを得なかったエンティティをすべて報告します。オーナーはインポート後に割り当ててください。Backstage の Group と User はインポートされません。

CircleCheckBig

Activity

ドキュメントが実際のコードベースをどれだけ正確に反映しているかを示す 0-100% のヘルススコアを取得。ドリフトが蓄積する前に検出します。

コンフォーマンスルール

アーキテクチャルールを定義し、自動チェックを実行して、システムが定義されたガードレール内に収まることを確保します。

ChartColumn

DORA メトリクス

デプロイ頻度、リードタイム、変更失敗率、復旧時間をアーキテクチャの健全性と合わせて追跡します。