🎭

Platform Engineeringに取り組み始めたエンジニアがBackstageを触ってみた

に公開

はじめに

本記事は、Platform Engineering を調べ始めたけど、本を読んでもピンと来ないので、手を動かして理解を深めようとした話です。
読者(Platform Engineering / Internal Developer Portal (IDP) を詳しく知らないソフトウェアエンジニア)が、
IDP の OSS である Backstage を「一度は触ってみようかな」 と思える状態になることを目指します。

Backstage overview

私はソフトウェアエンジニアとしての開発経験はある一方、
Platform Engineering / IDP は取り組み始めた段階です。

想定読者:

  • Platform Engineering / IDP を調べ始めた人です
  • ソフトウェア開発の基礎は分かっている人です

この記事で得られること:

  • Platform Engineering / IDP / Backstage の位置づけ
  • Backstage を試す入口(手を動かすための最短ルート)
  • 触って気づいた注意点

Platform Engineering と Internal Developer Portal と BackStage

Platform Engineering は、
開発者の生産性・体験を向上させるために、社内向けのプラットフォームを「プロダクト」として設計・運用する考え方・手法です。
CI/CD、テンプレート、ドキュメント、標準化された運用などを、
各チームが個別に整備するのではなく、共通の基盤として提供します。

https://www.gartner.co.jp/ja/articles/what-is-platform-engineering

また、社内開発者ポータル (IDP: Internal Developer Portal) は、
開発者がアプリケーション開発に必要な環境、ツール、プロセスなどを
統合的に提供する社内向けのプラットフォームの ポータルサイト です。
「必要な情報や作業をここに集約する」 というのがポイントです。

以下も詳しくてわかりやすいです。

https://speakerdeck.com/skitamura7446/the-future-of-platform-engineering-unveiling-the-true-value-of-containers-and-backstage

最後に、Backstage はIDP の代表的な OSS 実装です。

https://backstage.io/

以下のようなことができます。

  • ドキュメント整備 (TechDocs)
  • マイクロサービス構築のテンプレ化 (Software Templates)
  • サービス検索・所有者特定の効率化 (Catalog)

なぜ Backstage を触ってみたのか

Platform Engineering ではIDP が重要で、OSS ではBackstage が広く使われている印象です。
本や記事で雰囲気はわかったものの、まだピンときていなかったので、
手を動かして理解を深めようとして Backstage を触ってみました。

最初に抱いていた誤解

Backstage だけ動かしたら IDP が完成する と誤解していました。
実際は、他のツールと連携しないとコンテンツが何もなくて全く雰囲気をつかめません。
最低限、開発のコアとなっている GitHub/GitLab と連携する必要があります。
GitHub/GitLab はコードやドキュメントやメンバーを管理しており、開発者体験のコアだと思います。
IDP の価値は 「情報や作業の集約」 にあるので、連携先がないと 空っぽのポータルになってしまいます。

試したこと

最初、Backstage を clone しても期待通り動きませんでした。
どこから始めたらいいのかよくわからなかったので調べたところ、
以下の GitHub が docker compose でサクッと試しやすくて良さそうだったので、
試してみました。名前が良いです。

https://github.com/ap-communications/chocott-backstage

リンク先のドキュメントが丁寧なので、基本はその手順に従えば大丈夫です。

大まかな流れはこの程度で試せます。

  • リポジトリを clone
  • 環境変数を設定
  • docker compose で起動
  • Backstage にアクセスして操作(テンプレートを登録したり利用したり)

試してみた気づき

  • chocott-backstage で試せること
    • テンプレートの連携やドキュメントの管理を試せます。
    • IDP を構築するための最初の足がかりになります。
    • docker compose で提供されているので DB などはあまり気にしなくてよいです。
    • 最小構成で触るだけでも、IDP が「ハブ」として機能するイメージが掴めました。
  • 連携先は GitHub Organization がおすすめ
    • GitHub 個人アカウントで連携するか、Organization と連携するかを選ぶ必要があります。
    • 個人アカウントで連携しましたが、Backstage の良さを体験するには最初から Organization でやればよかったなと思いました。
    • Organization は自分でも作れるので、試しに作って連携するのが良さそうです。
    • Platform Engineering は社内のプラットフォームをプロダクトとして扱う概念なので、チーム体制・チーム開発の話になります。
    • 仕事でやるならOrganization 連携が前提です。
    • Organization にすることで、ユーザー管理も試せそうです。
  • テンプレートの構成が IDP の運用イメージに近い
    • chocott-backstage が準備しているテンプレートは、GitHub を SSO 的に使いつつ「ハブ」としてテンプレートやドキュメント管理しています。
    • これは IDP がやろうとしていることに近く、最初に試すにはちょうど良いように感じました。
  • 余談: GitHub が IDP のマネージドサービスを出したらそれで良いかも、とも思いました。

おわりに

Backstage を試しに使ってみることで、 IDP の利用・運用のイメージ や、
Platform Engineering を組織に組み込む感覚 が少し掴めた気がします。

まずは最小構成で触って、IDP の実感を掴むのがおすすめです。

補足

また、ポータルが必要なのは変わらないと思うけれど、
AI Agent 時代に Platform Engineering が必要かどうかを、考えたいと思っています。

以下のような記事もあって、非常に参考になりそうです。

https://www.cnia.io/pek2025/blog/ai-native-platformengineering.md/

実際に、Backstage や Red Hat が出している Backstage のマネージドサービス Developer Hub では、
MCP としての機能も提供しているようです。

参考

プラットフォームエンジニアリング

https://platformengineering.org/blog/what-is-platform-engineering

https://www.oreilly.co.jp/books/9784814401413/

https://www.gartner.co.jp/ja/articles/what-is-platform-engineering

おすすめ

https://speakerdeck.com/skitamura7446/the-future-of-platform-engineering-unveiling-the-true-value-of-containers-and-backstage

https://speakerdeck.com/oracle4engineer/platform-engineering-kotohazime

https://ascii.jp/elem/000/004/157/4157089/

https://zenn.dev/tomioka/articles/2e32df8bcce1c5

Backstage

https://backstage.io/

https://github.com/backstage/backstage

https://backstage.io/plugins

Backstage は MCP 検討中
https://github.com/backstage/backstage/issues/30218

Red Hat Developer Hub

Red Hat も出してる

https://www.redhat.com/ja/technologies/cloud-computing/developer-hub

MCP サーバーも提供してるみたい
https://docs.redhat.com/ja/documentation/red_hat_developer_hub/1.8/pdf/interacting_with_model_context_protocol_tools_for_red_hat_developer_hub/Red_Hat_Developer_Hub-1.8-Interacting_with_Model_Context_Protocol_tools_for_Red_Hat_Developer_Hub-ja-JP.pdf

Atlassian Compass

Atlassian も出してる

https://www.atlassian.com/software/compass

事例

https://zenn.dev/kiiwami/articles/f368d33cb4edefac

GitHubで編集を提案

Discussion