60以上のプロダクトを持つ組織における開発者体験向上への取り組み - チームAPIとBackstageで構築する組織の可視化基盤 - / sre next 2025 Efforts to Improve Developer Experience in an Organization with Over 60 Products

SRE NEXT 2025.7.11
アンケート満足度 Average 4.75 (max 5点) いただきました。

---
組織が大きくなるにつれて、「誰が何をしているのかわからない」「困ったとき誰に連絡すればいいのかわからない」という問題が増えてきます。マネーフォワードでは60を超えるプロダクトを持つ組織として、この複雑性に日々向き合っています。特に互いのチームが連携して開発している組織では、チーム間のコミュニケーションフローが複雑化し、情報の分断が顕著になってきました。
本発表では、SREチームが取り組んだチームAPIとBackstageを活用した組織の可視化基盤構築について紹介します。弊社では、このBackstageはインシデント発生時に責任者や関係性を素早く理解するためにもともと導入されていたものです。
今回私たちが特に注力したのは、このBackstageにおける情報登録障壁の軽減と、チームAPIを使った他チームに公開すべき情報の整理です。
多くの開発者にとってYAML編集は煩雑で、レイアウトやパラメータの把握だけでも意外に時間がかかります。そのチームの情報は登録されなければ効果を発揮しないため、まずはそのハードルを下げるためにBackstageテンプレートを実装しました。この実装によって開発者がYAMLを書かなくても必要な情報を登録できる環境を整えることで、実際に使われやすい仕組みへと進化させました。
その結果、チームとシステムの関係を1:Nで表現できるようになり、組織の複雑な関係を理解が容易になりました。
この発表では、チームトポロジーのチームAPIに触れつつ、Backstageテンプレートの実装における技術的なTipsや、チームAPIをどのように利用したかという具体的な知見を共有します。
組織の複雑化に悩むマネージャー、開発者、SREの方々。また、今後複雑化することが予見される方々に向けて、今からできることはなにか？についてもお話します。
「誰が何の責任を持っているのかわからなくなってきた」という課題解決の第一歩として、実際に使われる仕組みづくりのヒントを持ち帰っていただけると幸いです。

Transcript

1. 60Ҏ্ͷϓϩμΫτΛ࣋ͭ૊৫ʹ͓͚Δ ։ൃऀମݧ޲্΁ͷऔΓ૊Έ - νʔϜAPIͱBackstageͰߏங͢Δ૊৫ͷՄࢹԽج൫ - Money Foward, Inc - Platform and Reliability Engineering ຊ෦ VTRyo SRE NEXT 2025
2. 2021೥10݄ʹϚωʔϑΥϫʔυೖࣾ ੿ஶ ”ITΤϯδχΞͷͨΊͷ ɹɹ ۮવ͔Β࢝ΊΔΩϟϦΞϓϥϯ” - SRE NEXT͸ॳճ͔Βࢀઓ - SRE NEXT2022 ONLINEͰॳొஃ - “Ұਓ͔Β࢝ΊΔϓϩμΫτSRE” - Road to SRE NEXT@໊ݹ԰ - “Ұମ͍͔ͭΒSRE NEXT͕SRE͚ͩͷΧϯϑΝϨϯε ͩͱࡨ͍֮ͯͨ͠ʁ” - ͦͷଞ SREؔ࿈ͷొஃ - SRE Kaigi 2025 - “Ұਓ͔Β࢝ΊͨSREνʔϜ3೥ؒͷาΈ" VTRyo
3. ࣮͸α΢φ೤೾ࢣࢿ֨΋͍࣋ͬͯΔΒ͍͠ - ࠓճ͸೦ئͷεϙϯαʔϒʔεઃஔ ! ͋ͦͼʹ͖ͯͶ ʢ͜Ε͸εϙϯαʔηογϣϯͰ͸͋Γ·ͤΜʣ - झຯ - ΫϥϑτϏʔϧͷ৹ࠪһࢿ֨औಘ🍺 - ࠷ۙ͸Πϕϯτ΍ؒआΓͰεύΠεΧϨʔमߦத🍛 VTRyo
4. େ͖ͳ૊৫ʹ͓͚Δ৘ใ෼அͷղܾࡦͱͯ͠ͷɺνʔϜAPIͱ Backstageͷ࣮ફత׆༻๏ ࠓ͔Β࢝ΊΒΕΔࢪࡦͱͯ͠ ᶃνʔϜؒ࿈ܞʹඞཁͳ৘ใͷఆٛํ๏ ᶄBackstageςϯϓϨʔτͷ࣮૷ςΫχοΫ ᶅ૊৫ͷن໛ʹؔΘΒͣԠ༻Ͱ͖ΔऔΓ૊Έ ࠓ೔࣋ͪؼΕΔ͜ͱ ૊৫ͷෳࡶੑʹཱͪ޲͔͏ώϯτ
5. ϚωʔϑΥϫʔυͷ૊৫Λந৅Խͨ͠ਤ
6. ৘ใͷ෼அͱ୳ࡧίετͷ૿େ νʔϜ͝ͱʹҟͳΔπʔϧͰ৘ใ؅ཧ Google DocɺGitHub Wiki౳ͷπʔϧ෼ࢄ ٕज़ελοΫ΋όϥόϥɻͲͷνʔϜ͕ԿΛ࢖͍ͬͯΔ͔ෆ໌ ੹೚ͷॴࡏ͕ෆ໌֬ ʮ͜ͷAPIʹ໰୊͕ൃੜͨ͠৔߹ɺ୭ʹ࿈བྷ͢Ε͹͍͍ͷ͔ʯ جຊతͳ৘ใͷ೺Ѳ͕ࠔ೉ എܠͱ՝୊
7. ؔ܎ੑͷՄࢹԽͷ೉͠͞ දܭࢉιϑτͰදݱ͢Δ৔߹ɺνʔϜͱϦιʔεͷෳࡶͳؔ܎ ੑΛදݱ͢Δʹ͸ݶք͕͋Δ ԾʹͦΕͰ؅ཧ͢Δͱɺ৘ใ؅ཧऀ͕தԝूݖԽ͢ΔϦεΫ ඇޮ཰ͳΦϯϘʔσΟϯά ৽͍͠νʔϜʹࢀՃͨ͠ࡍɺͦͷνʔϜ͕ॴ༗͢ΔϦιʔε΍ ϓϩδΣΫτΛ೺Ѳ͢Δ·Ͱͷίετ ޓ͍ʹڠௐ͍ͯ͠ΔαʔϏεʹ͍ͭͯɺ͋ͪͪ͜ͷ৘ใʹΞΫ ηε͢Δඞཁ͕͋Δ എܠͱ՝୊
8. ͦ͜ͰSpotify੡OSS "Backstage"
9. > “Backstage͸Spotifyͷඞཁੑ͔Βੜ·Ε·ͨ͠ɻ ࣄۀ͕੒௕͢ΔʹͭΕͯɺΠϯϑϥ͕அยԽ͠ɺΤϯδχΞͷੜ࢈ ੑ͕௿Լ͍ͯ͠Δ͜ͱʹؾ͖ͮ·ͨ͠ɻ νʔϜ͸ίʔυͷߏஙͱςετΛߦ͏୅ΘΓʹɺ࡞ۀ։࢝ʹඞཁͳ ৘ใΛ୳͢͜ͱʹଟ͘ͷ࣌ؒΛඅ΍͍ͯ͠·ͨ͠ɻ" Backstageͱ͸ ࢀর: https://backstage.io/docs/overview/background
10. αʔϏεɺιϑτ΢ΣΞɺπʔϧɺςετΛBackstageͰ؅ཧ ͲͷαʔϏεͰͲͷΑ͏ͳٕज़ελοΫ͕࢖ΘΕ͍ͯΔͷ͔ ͋ΔαʔϏεʹ͓͍ͯɺ୭͕Φʔφʔͳͷ͔ αʔϏεͷར༻ऀͱͯ͠ɺର৅ͷαʔϏεͷར༻ํ๏ Etc… Backstageͱ͸ ࢀর: https://backstage.io/docs/overview/background
11. BackstageΛ։ൃऀϙʔλϧͱͯ͠ར༻ ৘ใΛՄࢹԽ͢Δ
12. ࣮͸͢Ͱʹಋೖ͞Ε͍ͯͨBackstage
13. ΋ͱ΋ͱͷӡ༻ঢ়گ Πϯγσϯτൃੜ࣌ͷ੹೚ऀ΍ؔ܎ੑ೺Ѳ͕໨త ֤ϦϙδτϦʹαʔϏε৘ใͱΦʔφʔ໊Λొ࿥ͨ͠ ͨͩ͠ӡ༻ʹ͸՝୊͕͋ͬͨ Φʔφʔ৘ใ͕ෆ଍͍ͯ͠Δʢ࿈བྷઌͳ͠ɺϝϯόʔෆ໌ͳͲʣ YAMLฤू͕ଟ͘ͷ։ൃऀʹͱͬͯෛՙ ԿΛॻ͍͍͍ͯͷ͔ෆ໌ ࣮͸͢Ͱʹಋೖ͞Ε͍ͯͨBackstage
14. BackstageͰ͸ ςϯϓϨʔτΛ࡞੒Ͱ͖Δ
15. ͜ΕΛ࢖ͬͯ ొ࿥ͷϋʔυϧΛԼ͛Δ
16. Backstage Software Templates
17. Backstage Software Templates ※ϦϙδτϦςϯϓϨʔτͱͯ͠࢖͏έʔε͕ଟ͍ ৘ใΛೖྗ͢Δͱඞཁͳ৘ใΛ౥ࡌͯ͠ϦϙδτϦ࡞੒͞ΕΔ ʮXX repoΛίϐϖͯ͘͠Δͱ͍͍ΑʯͷΞϨ
18. Backstage Software Templates ࠓճ͸ʮYAML͠ΜͲ͍ʯʮԿΛॻ͔͘ෆ໌ʯͷղܾࡦͱͯ͠ར༻ Web UI্Ͱඞཁࣄ߲Λೖྗ͢Δ͚ͩͰYAMLࣗಈੜ੒ ϨΠΞ΢τ΍ύϥϝʔλͷ೺Ѳʹ࣌ؒΛऔΒΕΔ͜ͱͳ͘ɺ։ ൃऀ͕؆୯ʹ৘ใΛొ࿥Ͱ͖Δ ඞཁͳ৘ใΛఏࣔͰ͖Δ ೖྗ৘ใΛςϯϓϨʔτΤϯδϯͰಈతʹม׵Ͱ͖Δ
19. AI͕ॻ͚͹ྑ͘ͳ͍ʁ ͱࢥͬͨΈͳ͞Μ
20. ͜ͷऔΓ૊Έ౰࣌ɺAI agent͕ࣾ಺ʹීٴ͍ͯ͠ͳ͔ͬͨ AI agentར༻Λલఏͱͨ͠৔߹ɺͦͷηοτΞοϓ͔Β։࢝ʹͳ Δϋʔυϧ͕͋ͬͨ TemplatesΛ࢖ΘͣɺAI agentΛ࢖ͬͯੜ੒͢Δ͜ͱ͸໰୊ͳ͍ ʢத਎͸ͨͩͷYAMLͳͷͰʣ ඞཁͳ৘ใΛ࣮֬ʹੜ੒ͯ͠΋Β͑͹OK ൃද͍ͯ͠Δؒʹ৘ใ͕ݹ͘ͳΔڪΖ͍࣌͠୅ͩ…… ※͏·͘ӡ༻Ͱ͖ΔͳΒྑ͍ͱࢥ͍·͢
21. ৘ใͷू໿ઌ͸ܾ·ͬͨ Ͱ͸ԿΛొ࿥͢Δ΂͖͔ʁ
22. ʮΦʔφʔ͸୭͔ʯ໰୊Λಛఆ͢ΔͨΊʹ ͲͷνʔϜ͕ͲͷγεςϜ΍αʔϏεʹ੹೚Λ͍࣋ͬͯΔͷ͔ ͦͷνʔϜ͸ͲͷଞνʔϜͱؔ࿈͕͋Δͷ͔ ͦͷαʔϏεͷυΩϡϝϯτ͸Ͳ͜ʹ͋Δͷ͔ Etc… ԿΛొ࿥͢Δ΂͖͔ʁ
23. νʔϜτϙϩδʔͷߟ͑ํΛ ࠾༻
24. > “Ձ஋͋Διϑτ΢ΣΞΛૉૣ͘ಧ͚ΔదԠܕ૊৫ઃܭ” > “ݱ୅ʹ͓͚Δ૊৫ઃܭͱ͸ɺސ٬ͷ੠ʹԠ͑Δ΂͘ίϥϘϨʔ γϣϯ͢ΔͨΊͷٕज़Λઃܭ͢Δ͜ͱͰ͋Δ” νʔϜτϙϩδʔͱ͸ ࢀর: νʔϜτϙϩδʔ Ձ஋͋Διϑτ΢ΣΞΛ͢͹΍͘ಧ͚ΔదԠܕ૊৫ઃܭ ɹɹ φΦϛɾελϯϑΥʔυʰGuide to Organization Designʱ
25. ίϯ΢ΣΠͷ๏ଇʹج͍ͮͯ”ҙࣝతʹ”νʔϜߏ଄ͱΞʔΩςΫ νϟΛઃܭ͢Δ͜ͱ ͱʹ͔͘ૉૣ͘ϦϦʔε͢ΔͨΊʹνʔϜΛઃܭ͢Δ ೝ஌ෛՙΛ؅ཧ͢Δ͜ͱ νʔϜΛ͏·͘૬ޓ࡞༻ͤ͞Δ ڥքΛ໌֬ʹ͢Δ͜ͱͰ੹೚΋໌֬ʹ͢Δ νʔϜτϙϩδʔͱ͸
26. νʔϜ͕ιϑτ΢ΣΞͷΦʔφʔͱͳΔ ιϑτ΢ΣΞͷڥքαΠζΛνʔϜͷೝ஌ෛՙʹ߹ΘͤΔ ద੾ͳڥք͕ೝ஌ෛՙΛԼ͛Δ ੹೚ൣғΛ߹Θ੍ͤͯݶ͢Δ νʔϜτϙϩδʔʹ͓͚ΔνʔϜϑΝʔετࢥߟ ࢀর: νʔϜτϙϩδʔ Ձ஋͋Διϑτ΢ΣΞΛ͢͹΍͘ಧ͚ΔదԠܕ૊৫ઃܭ
27. νʔϜಉ࢜ͷ΍ΓͱΓʹAPIͷΞΠσΞΛ֦ுͨ͠΋ͷ ίʔυɺόʔδϣϯ؅ཧɺυΩϡϝϯςʔγϣϯɺϓϥΫςΟ εɺίϛϡχέʔγϣϯɺؔ࿈৘ใ νʔϜͷ੹೚ൣғɺఏڙαʔϏεɺ࿈བྷํ๏Λ໌֬Խ ଞνʔϜ͔Βར༻͞ΕΔલఏͰఆٛ͢Δ ૬ख͸͙͢ʹཧղͰ͖Δ͔ɻ͙͢ʹཉ͍͠৘ใʹ౸ୡͰ͖Δ͔ νʔϜAPIͱ͸ ࢀর: νʔϜτϙϩδʔ Ձ஋͋Διϑτ΢ΣΞΛ͢͹΍͘ಧ͚ΔదԠܕ૊৫ઃܭ
28. νʔϜAPIͱͯ͠ ৘ใΛఆٛͯ͠ΈΔ
29. CODEOWNERSʹඥ໊ͮ͘લ Slackάϧʔϓϝϯγϣϯ໊ͱϝϯγϣϯID Slackνϟϯωϧ໊ͱϦϯΫ ϓϩδΣΫτ؅ཧπʔϧ΁ͷϦϯΫ αϒνʔϜ໊ νʔϜϝϯόʔϦετ νʔϜλΠϓʢEnablingɺstream-alignedͳͲʣ ྡਓʢར༻ऀɾඇར༻ऀʣͷνʔϜ໊ νʔϜAPIͱͯ͠ఆٛͨ͜͠ͱ GitHub͸ݸਓ·ͨ͸TeamΛ ϦϙδτϦͷ੹೚ऀʹࢦఆͰ͖Δ
30. Backstage × νʔϜAPI
31. αʔϏε৘ใΛҰݩ؅ཧ͢ΔϨΠϠʔͱͯ͠ͷBackstage ͦ͜ʹνʔϜ৘ใ΋ొ࿥͞ΕΔ͜ͱͷϝϦοτ ௐࠪ࣌ؒͷ୹ॖ ΦϯϘʔσΟϯά࣌ؒͷ୹ॖ ίϥϘϨʔγϣϯ࣌ͷ࿈བྷ Backstage × νʔϜAPI
32. Backstage × νʔϜAPI
33. Backstage × νʔϜAPI
34. Backstage Software Templates Tips
35. ొ৔ਓ෺ 1. Backstage ϦϙδτϦ Backstageͦͷ΋ͷ 2. ೚ҙͷϦϙδτϦʢTemplatesίϯςϯπΛஔ͘৔ॴʣ template.yaml catalog-info.yaml(template༻) 3. ϓϩμΫτͷϦϙδτϦʢαʔϏε͝ͱʹஔ͘ʣ catalog-info.yaml Tips ϑϩϯτΤϯυ΍ϓϥάΠϯͷ֦ ு͸BackstageʹมߋΛՃ͑Δ
36. Ͳ͏΍ͬͯTemplatesΛͭ͘Δͷ͔ Backstage Software Templates ࣗମ͸ YAML 😨 ެࣜͷExample Λͥͻɻࠓͷ࣌୅ͳΒVibe coding Ұ୒ https://github.com/backstage/software-templates ςϯϓϨʔτΤϯδϯ Nunjucks Λ࢖ͬͯೖྗ஋Λૠೖ͢Δ ݕূʹ͸ Nunjucks ͷ PlaygroundΛ࢖͓͏ https://nunjucks.r0b.io/ Tips: ೚ҙͷϦϙδτϦ
37. Templates ίϯςϯπͷσΟϨΫτϦߏ੒ └── team-api └── group ᵓ── content │ └── catalog-info.yaml └── template.yaml Tips: ೚ҙͷϦϙδτϦ BackstageͰೖྗ͞ΕΔ templateϑΝΠϧ NunjucksΛ࢖ͬͨϑΝΠϧ system, component ͱ͍ͬͨผͷΧςΰϦ͕Ͱ͖Δ͔΋͠Εͳ͍ͷͰ "groupϦιʔε"ͱ໋໊ͯ͠
38. Tips: ೚ҙͷϦϙδτϦ template.yaml
39. content഑Լͷcatalog-info.yamlʹ஋Λ୅ೖ͍ͯ͠Δ Tips: ೚ҙͷϦϙδτϦcatalog-info.yaml
40. Array TagsͷΑ͏ʹ͍͔ͭ͋͘Δલఏͷ΋ͷ Arrayͷதʹ͞Βʹ߲໨Λ௥ՃͰ͖Δ ui:field PickerΛ͔ͭͬͨೖྗิॿ Tips: ೚ҙͷϦϙδτϦ template.yaml
41. templatesঢ়ଶͷcatalog-info.yaml Array͸ forͰϧʔϓ If෼ذͰඞਢͰͳ͍߲໨Λ੍ޚ Templatesͷ੔ܗ͸Nunjucks PlaygroundͰ Tips: template༻ͷcatalog-info.yaml
42. ϓϩμΫτϦϙδτϦͷσΟϨΫτϦߏ੒ team_api └── group └── catalog-info.yaml Tips: ϓϩμΫτͷϦϙδτϦ ৘ใ͕୅ೖ͞ΕͨϑΝΠϧ
43. ࣮ࡍͷϖʔδ Tips
44. ࣮ࡍͷϖʔδ Tips
45. LinksͳͲͷ΢ΟδΣοτɺϓϥάΠϯʹ͍ͭͯ Backstage͸OSSͷͨΊɺࣗ਎ͰΧελϜՄೳ දࣔ͢Δɾ͠ͳ͍΋ࣗ༝ CoreϥΠϒϥϦɾϓϥάΠϯ͸ReactͰ࣮૷ ๛෋ͳϓϥάΠϯ༗ ࣗ෼ͨͪͰ࣮૷Մೳ Tips
46. ݱ࣌఺Ͱͷ੒ՌϙΠϯτ
47. ؔ܎ੑͷՄࢹԽ νʔϜͱγεςϜͷ1:Nؔ܎ͷදݱ Ұཡද͚ࣔͩͰ͸ͳཱ͍ମతͳ৘ใߏ଄ ৘ใؒͷؔ࿈ੑΛΑΓҰ૚୳ࡧ͕Մೳ ͜ͷνʔϜ͸ͲͷϦιʔεΛ୲౰͍ͯ͠Δ͔ݟ͑Δ ৘ใొ࿥ͷϋʔυϧ ٕज़తͳ஌͕ࣝͳͯ͘΋νʔϜ৘ใΛొ࿥Ͱ͖Δ ݱ࣌఺Ͱ࣮ݱͰ͖͍ͯΔϙΠϯτ
48. ࠓޙ΍͍ͬͯ͘΂͖͜ͱ
49. ଞνʔϜ΁ͷਁಁ ࣗ෼͕؅׋͍ͯ͠ΔνʔϜҎ֎΋ొ࿥͢Δ ొ࿥ɾߋ৽࣌ɺΑΓͻͱͷख͕͔͔Βͳ͍Α͏ʹ͢Δ࢓૊Έ ΦϯϘʔσΟϯά΁ͷ׆༻ େ࿮Λ೺Ѳ͠ͳ͕Βɺࣗ਎Ͱ৘ใΛ୳ࡧͰ͖ΔΑ͏ʹͳΔ ͞ΒͳΔࣗಈԽ ྫ: YAMLϑΝΠϧ͕ࣗಈతʹGitHubʹPush͞ΕΔ etc… ߋ৽৘ใΛͲ͏΍ͬͯऩू͢Δ͔ ׬੒΋ͳ͘ɺ௕͘ബ͘ɺऔΓ૊Έଓ͚Δඞཁ͕͋Δ
50. ࠓ͔ΒऔΓ૊ΊΔ͜ͱ
51. ೝ஌ෛՙΛ౿·͑ͨڥքઢΛݕ౼ʢνʔϜτϙϩδʔࢀরʣ ʢ੹೚ͷڥքઢ͕Ͱ͖ͨΒʣνʔϜAPIͷఆٛ ଞνʔϜʹެ։͢΂͖৘ใΛ໌֬ʹఆٛ͠ɺڞ௨ೝࣝΛ࡞Γ· ͢ɻ͜Ε͸νʔϜ਺͕গͳ͚Ε͹ಋೖ͕༰қ ΦʔφʔͱϦιʔεؔ܎ΛදݱͰ͖Δ࢓૊ΈΛಋೖ ϦϙδτϦʹରͯ͠ɺ࡞੒ॳظ͔ΒνʔϜ৘ใͱϦιʔε৘ใ Λೖྗ͢ΔΑ͏ͳ࢓૊ΈΛಋೖ͓ͯ͘͠ɻ͋ͱͰ਺ඦͷϦϙδ τϦʹ͍ΕΔίετ΍࿙ΕΛ๷ࢭͰ͖Δ ࠓ͔ΒऔΓ૊ΊΔ͜ͱ
52. ·ͱΊ
53. BackstageʹΑΔ৘ใͷҰݩ؅ཧ 1:Nؔ܎ͷՄࢹԽ νʔϜτϙϩδʔ: νʔϜAPIͷΞΠσΞΛར༻ͨ͠৘ใެ։ ৘ใొ࿥͸ͳΔ΂͔͘ΜͨΜʹ ෳࡶԽ͢ΔલʹઃܭΛ! ։ൃऀͷೝ஌ෛՙܰݮͷͨΊʹ