🐱 うさねこ教室

この教室について

この教室は、Python での Web 開発経験はあるが、JVM の世界や可観測性はほぼ未経験という人のために書かれています。 if 文や for 文、型ヒント、FastAPI や Flask の基本は知っている前提で、それ以外はゼロから説明します。

ゴールは、OpenTelemetry と OSS の監視スタックで可観測な Web API を構築し、JVM エコシステム（Spring Boot / Micrometer / Gradle）の設計思想も理解して、現場で技術選定に参加できるようになることです。 そのために、JVM の基礎、OpenAPI による API 設計、メトリクス・ログ・トレースの 3 本柱、そして性能とスケールの理論を順番に学びます。

学習に必要なもの

最初に必要なのは、Python 3.12 以上、パッケージマネージャーの uv、Docker Desktop、そして VS Code です。 Part 1 では JDK 21 と Gradle も使います。 インストール手順は Part 0 の環境構築 で説明します。

コード例は Python 3.12 / FastAPI 0.115 / JDK 21 / Spring Boot 3.3 で動作を確認しています。 可観測性の演習では、Prometheus・Grafana・Jaeger・Loki を Docker Compose で起動します。

すべての演習を行う場合、全体の所要時間は 30〜50 時間が目安です。 読む速さや、発展課題に取り組む時間によって前後します。

進め方

• 各章は上から順に読む前提で書かれています。迷ったら Part 0 から始めてください。
• コマンドやコードは、読むだけでなく実際に手を動かして確かめることを強くおすすめします。
• Python との対比を各所に置いています。既知の概念と対応づけながら読んでください。
• 前に出てきた用語を忘れたら、用語集から説明している章へ戻れます。

Part ごとの到達点

所要時間は、本文を読み、演習を行う場合の目安です。