Spring Boot 3.2 と JDK21で始めるマイクロサービス開発ガイド

Contents

1 1️⃣ 前提条件と開発ツールのインストール
- 1.1 1.1 必要なコンポーネント
- 1.2 1.2 OS 別インストール手順
2 2️⃣ Spring Initializr で雛形プロジェクトを作成
3 3️⃣ サービスディスカバリ & 設定管理（Eureka / Consul + Config Server）
4 4️⃣ REST API と自動ドキュメント、Docker イメージの作成
5 5️⃣ Kubernetes デプロイ、CI/CD パイプライン、Observability & Security
6 6️⃣ 参考リンク（公式ドキュメント）
7 まとめ

スポンサードリンク

1️⃣ 前提条件と開発ツールのインストール

1.1 必要なコンポーネント

コンポーネント	推奨バージョン (執筆時点)	備考
JDK	21（LTS）	Spring Boot 3 系は `Java 17+` が必須。最新の LTS を使用すると長期サポートが受けられる
IDE	IntelliJ IDEA (Community/Ultimate) または Visual Studio Code	どちらも Java 用プラグインが充実
ビルドツール	Maven 3.9.x、Gradle 8.5+	プロジェクトの好みで選択可
コンテナランタイム	Docker Engine 27.x 以上	Windows/macOS/Linux 共通

1.2 OS 別インストール手順

macOS

ツール	インストールコマンド
SDKMAN!（JDK 管理）	`curl -s "https://get.sdkman.io" \\| bash && source "$HOME/.sdkman/bin/sdkman-init.sh"`
JDK 21	`sdk install java 21-open`
IntelliJ IDEA Community	`brew install --cask intellij-idea-ce`
VS Code + Java 拡張	`brew install --cask visual-studio-code && code --install-extension vscjava.vscode-java-pack`
Maven / Gradle	`brew install maven gradle`

Ubuntu/Debian 系 Linux

# 1. SDKMAN! のインストール（macOS と同様）
curl -s &quot;https://get.sdkman.io&quot; | bash
source &quot;$HOME/.sdkmanager/bin/sdkman-init.sh&quot;

# 2. JDK21 の導入
sdk install java 21-open

# 3. IDE のインストール例
sudo snap install intellij-idea-community --classic   # IntelliJ IDEA Community
sudo snap install code --classic                       # VS Code

# 4. ビルドツール
sudo apt update &amp;&amp; sudo apt install -y maven gradle

# 1. SDKMAN! のインストール（macOS と同様）

curl -s "https://get.sdkman.io" | bash

source "$HOME/.sdkmanager/bin/sdkman-init.sh"

# 2. JDK21 の導入

sdk install java 21-open

# 3. IDE のインストール例

sudo snap install intellij-idea-community --classic # IntelliJ IDEA Community

sudo snap install code --classic # VS Code

# 4. ビルドツール

sudo apt update && sudo apt install -y maven gradle

Windows（PowerShell）

# 1. Chocolatey のインストール（管理者権限で実行）
Set-ExecutionPolicy Bypass -Scope Process -Force; `
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; `
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 2. SDKMAN! の代替として `jabba` を使用
choco install jabba -y
jabba install adoptopenjdk@21.0.2-9   # JDK 21

# 3. IDE のインストール
choco install intellijidea-community -y   # IntelliJ IDEA Community
choco install vscode -y                  # VS Code

# 4. Maven / Gradle
choco install maven gradle -y

# 1. Chocolatey のインストール（管理者権限で実行）

Set-ExecutionPolicy Bypass -Scope Process -Force; `

[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; `

iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 2. SDKMAN! の代替として `jabba` を使用

choco install jabba -y

jabba install adoptopenjdk@21.0.2-9 # JDK 21

# 3. IDE のインストール

choco install intellijidea-community -y # IntelliJ IDEA Community

choco install vscode -y # VS Code

# 4. Maven / Gradle

choco install maven gradle -y

ポイント
macOS は Homebrew がデファクトスタンダード、Linux は apt/yum 系に加えて Snap や SDKMAN! を併用、Windows は Chocolatey (または Scoop) が便利です。
いずれの環境でも java -version / mvn -v / gradle -v が期待通りに表示されればインストール完了です。

2️⃣ Spring Initializr で雛形プロジェクトを作成

2.1 Spring Initializr の利用方法

項目	設定例
URL	https://start.spring.io
Project	Maven (または Gradle)
Language	Java
Spring Boot	`3.2.x`（最新マイナーバージョン）
Group / Artifact	`com.example` / `order-service`
Java Version	21
Dependencies	Web, Eureka Client, Config Client, Actuator, OpenFeign, SpringDoc OpenAPI UI

備考：Spring Boot のバージョンは「最新安定版」を選択してください。公式ページの Release Notes を随時確認すると、マイナーバグ修正や新機能が把握できます。

2.2 生成された `pom.xml`（抜粋）

&lt;properties&gt;
    &lt;java.version&gt;21&lt;/java.version&gt;
    &lt;!-- Spring Cloud のバージョンは BOM に委譲 --&gt;
    &lt;spring-cloud.version&gt;2024.0.x&lt;/spring-cloud.version&gt;
&lt;/properties&gt;

&lt;dependencyManagement&gt;
    &lt;dependencies&gt;
        &lt;dependency&gt;
            &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
            &lt;artifactId&gt;spring-cloud-dependencies&lt;/artifactId&gt;
            &lt;version&gt;${spring-cloud.version}&lt;/version&gt;
            &lt;type&gt;pom&lt;/type&gt;
            &lt;scope&gt;import&lt;/scope&gt;
        &lt;/dependency&gt;
    &lt;/dependencies&gt;
&lt;/dependencyManagement&gt;

&lt;dependencies&gt;
    &lt;!-- Spring Web --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
        &lt;artifactId&gt;spring-boot-starter-web&lt;/artifactId&gt;
    &lt;/dependency&gt;

    &lt;!-- Eureka Client --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
        &lt;artifactId&gt;spring-cloud-starter-netflix-eureka-client&lt;/artifactId&gt;
    &lt;/dependency&gt;

    &lt;!-- Config Client --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
        &lt;artifactId&gt;spring-cloud-config-client&lt;/artifactId&gt;
    &lt;/dependency&gt;

    &lt;!-- Actuator --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
        &lt;artifactId&gt;spring-boot-starter-actuator&lt;/artifactId&gt;
    &lt;/dependency&gt;

    &lt;!-- OpenFeign --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
        &lt;artifactId&gt;spring-cloud-starter-openfeign&lt;/artifactId&gt;
    &lt;/dependency&gt;

    &lt;!-- SpringDoc OpenAPI UI --&gt;
    &lt;dependency&gt;
        &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
        &lt;artifactId&gt;springdoc-openapi-starter-webmvc-ui&lt;/artifactId&gt;
        &lt;version&gt;2.5.0&lt;/version&gt;
    &lt;/dependency&gt;
&lt;/dependencies&gt;

<java.version>21</java.version>

<spring-cloud.version>2024.0.x</spring-cloud.version>

</properties>

<groupId>org.springframework.cloud</groupId>

<artifactId>spring-cloud-dependencies</artifactId>

<version>${spring-cloud.version}</version>

<scope>import</scope>

</dependency>

</dependencies>

</dependencyManagement>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-web</artifactId>

</dependency>

<groupId>org.springframework.cloud</groupId>

<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>

</dependency>

<groupId>org.springframework.cloud</groupId>

<artifactId>spring-cloud-config-client</artifactId>

</dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-actuator</artifactId>

</dependency>

<groupId>org.springframework.cloud</groupId>

<artifactId>spring-cloud-starter-openfeign</artifactId>

</dependency>

<groupId>org.springdoc</groupId>

<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>

</dependency>

</dependencies>

2.3 プロジェクトのインポート

IDE	手順
IntelliJ IDEA	`File → New → Project from Existing Sources` → `pom.xml` を選択し、Maven が自動的に依存を解決します
VS Code	拡張機能 Java Extension Pack が有効なら、プロジェクトルートで `Ctrl+Shift+P → Java: Import Maven Projects`

3️⃣ サービスディスカバリ & 設定管理（Eureka / Consul + Config Server）

3.1 Eureka Server の作成

curl https://start.spring.io/starter.zip \
    -d dependencies=web,eureka-server,actuator \
    -d name=eureka-server \
    -d packageName=com.example.eureka \
    -o eureka-server.zip &amp;&amp; unzip eureka-server.zip -d eureka-server

curl https://start.spring.io/starter.zip \

-d dependencies=web,eureka-server,actuator \

-d name=eureka-server \

-d packageName=com.example.eureka \

-o eureka-server.zip && unzip eureka-server.zip -d eureka-server

`src/main/resources/application.yml`

server:
  port: 8761

eureka:
  client:
    register-with-eureka: false   # 自身はレジストリに登録しない
    fetch-registry: false
  server:
    enable-self-preservation: false

server:

port: 8761

eureka:

client:

fetch-registry: false

server:

enable-self-preservation: false

起動クラス

@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(EurekaServerApplication.class, args);
    }
}

@SpringBootApplication

@EnableEurekaServer

public class EurekaServerApplication {

public static void main(String[] args) {

SpringApplication.run(EurekaServerApplication.class, args);

}

起動後は http://localhost:8761/ に管理画面が表示されます。

3.2 Config Server の作成

curl https://start.spring.io/starter.zip \
    -d dependencies=web,config-server,git,actuator \
    -d name=config-server \
    -d packageName=com.example.config \
    -o config-server.zip &amp;&amp; unzip config-server.zip -d config-server

curl https://start.spring.io/starter.zip \

-d dependencies=web,config-server,git,actuator \

-d name=config-server \

-d packageName=com.example.config \

-o config-server.zip && unzip config-server.zip -d config-server

`src/main/resources/application.yml`

server:
  port: 8888

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/your-org/microservice-config.git
          default-label: main
          clone-on-start: true

server:

port: 8888

spring:

cloud:

config:

server:

git:

uri: https://github.com/your-org/microservice-config.git

default-label: main

clone-on-start: true

ポイント
* git.uri はプライベートリポジトリでも構いません。その場合は認証情報（SSH キーや Personal Access Token）を環境変数で渡すのが安全です。

3.3 クライアント側設定例（order‑service）

`bootstrap.yml`（Spring Boot 2.x 系から推奨されていたファイルですが、Spring Boot 3 でも有効です）

spring:
  application:
    name: order-service

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/

spring:

application:

eureka:

client:

service-url:

defaultZone: http://localhost:8761/eureka/

`application.yml`（ローカルプロパティの上書き例）

management:
  endpoints:
    web:
      exposure:
        include: health,info,prometheus

management:

endpoints:

web:

exposure:

include: health,info,prometheus

この構成で、サービスは起動時に Eureka に登録し、外部化された設定は Config Server から取得します。

4️⃣ REST API と自動ドキュメント、Docker イメージの作成

4.1 コントローラ・サービス実装（簡易サンプル）

package com.example.orderservice.controller;

import lombok.RequiredArgsConstructor;
import org.springframework.http.*;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping(&quot;/orders&quot;)
@RequiredArgsConstructor
@Validated
public class OrderController {

    private final OrderService orderService;

    @GetMapping(&quot;/{id}&quot;)
    public ResponseEntity&lt;OrderDto&gt; get(@PathVariable Long id) {
        return ResponseEntity.ok(orderService.findById(id));
    }

    @PostMapping
    public ResponseEntity&lt;OrderDto&gt; create(@RequestBody @Valid OrderCreateRequest req) {
        var created = orderService.create(req);
        return new ResponseEntity&lt;&gt;(created, HttpStatus.CREATED);
    }
}

package com.example.orderservice.controller;

import lombok.RequiredArgsConstructor;

import org.springframework.http.*;

import org.springframework.validation.annotation.Validated;

import org.springframework.web.bind.annotation.*;

@RestController

@RequestMapping("/orders")

@RequiredArgsConstructor

@Validated

public class OrderController {

private final OrderService orderService;

@GetMapping("/{id}")

public ResponseEntity<OrderDto> get(@PathVariable Long id) {

return ResponseEntity.ok(orderService.findById(id));

}

@PostMapping

public ResponseEntity<OrderDto> create(@RequestBody @Valid OrderCreateRequest req) {

var created = orderService.create(req);

return new ResponseEntity<>(created, HttpStatus.CREATED);

}

package com.example.orderservice.service;

import org.springframework.stereotype.Service;
import java.util.*;

@Service
public class OrderService {

    private final Map&lt;Long, OrderDto&gt; store = new HashMap&lt;&gt;();

    public OrderDto findById(Long id) {
        return Optional.ofNullable(store.get(id))
                .orElseThrow(() -&gt; new NoSuchElementException(&quot;Order not found&quot;));
    }

    public OrderDto create(OrderCreateRequest req) {
        var id = (long) (store.size() + 1);
        var dto = new OrderDto(id, req.productCode(), req.quantity());
        store.put(id, dto);
        return dto;
    }
}

package com.example.orderservice.service;

import org.springframework.stereotype.Service;

import java.util.*;

@Service

public class OrderService {

private final Map<Long, OrderDto> store = new HashMap<>();

public OrderDto findById(Long id) {

return Optional.ofNullable(store.get(id))

.orElseThrow(() -> new NoSuchElementException("Order not found"));

}

public OrderDto create(OrderCreateRequest req) {

var id = (long) (store.size() + 1);

var dto = new OrderDto(id, req.productCode(), req.quantity());

store.put(id, dto);

return dto;

}

ベストプラクティス
ビジネスロジックは必ず @Service に分離し、コントローラはリクエスト/レスポンスの変換に専念させます。
DTO と Request オブジェクトは record（Java 21）で定義するとコード量が大幅に削減できます。

4.2 OpenAPI (Springdoc) の自動生成

pom.xml に以下依存を追加しただけで、起動時に Swagger UI が有効になります。

&lt;dependency&gt;
    &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
    &lt;artifactId&gt;springdoc-openapi-starter-webmvc-ui&lt;/artifactId&gt;
    &lt;version&gt;2.5.0&lt;/version&gt;
&lt;/dependency&gt;

<groupId>org.springdoc</groupId>

<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>

</dependency>

アクセス URL: http://localhost:8080/swagger-ui.html
※ application.yml でベースパスを変更した場合はそのプレフィックスに合わせてください。

4.3 Dockerfile（マルチステージビルド）

# ---------- Build Stage ----------
FROM maven:3.9-eclipse-temurin-21 AS builder
WORKDIR /src
COPY pom.xml .
COPY src ./src
RUN mvn -B package -DskipTests

# ---------- Runtime Stage ----------
FROM eclipse-temurin:21-jre-alpine
ARG JAR_FILE=/src/target/*.jar
COPY --from=builder ${JAR_FILE} app.jar
ENTRYPOINT [&quot;java&quot;,&quot;-XX:+UseContainerSupport&quot;,&quot;-jar&quot;,&quot;/app.jar&quot;]

# ---------- Build Stage ----------

FROM maven:3.9-eclipse-temurin-21 AS builder

WORKDIR /src

COPY pom.xml .

COPY src ./src

RUN mvn -B package -DskipTests

# ---------- Runtime Stage ----------

FROM eclipse-temurin:21-jre-alpine

ARG JAR_FILE=/src/target/*.jar

COPY --from=builder ${JAR_FILE} app.jar

ENTRYPOINT ["java","-XX:+UseContainerSupport","-jar","/app.jar"]

ビルド・実行例

# Docker イメージ作成
docker build -t order-service:3.2.x .

# ローカルで起動（ポート 8080 を公開）
docker run --rm -p 8080:8080 order-service:3.2.x

# Docker イメージ作成

docker build -t order-service:3.2.x .

# ローカルで起動（ポート 8080 を公開）

docker run --rm -p 8080:8080 order-service:3.2.x

ポイント
-XX:+UseContainerSupport は JDK 21 以降のデフォルトですが、明示的に書くとコンテナリソース制限が正しく反映されます。
Alpine ベースはサイズが小さく、脆弱性スキャンの対象面も減ります。

5️⃣ Kubernetes デプロイ、CI/CD パイプライン、Observability & Security

5️⃣1 Helm Chart（order‑service 用）

order-service/
├── Chart.yaml
├── values.yaml
└── templates/
    ├── deployment.yaml
    ├── service.yaml
    └── ingress.yaml

order-service/

├── Chart.yaml

├── values.yaml

└── templates/

├── deployment.yaml

├── service.yaml

└── ingress.yaml

`Chart.yaml`

apiVersion: v2
name: order-service
description: Order Service Helm chart
type: application
version: 0.1.0
appVersion: &quot;3.2.x&quot;

apiVersion: v2

description: Order Service Helm chart

type: application

version: 0.1.0

appVersion: "3.2.x"

`values.yaml`（主要パラメータ）

replicaCount: 2

image:
  repository: your-dockerhub/order-service
  pullPolicy: IfNotPresent
  tag: latest   # CI が SHA を上書きします

service:
  type: ClusterIP
  port: 8080

resources:
  limits:
    cpu: &quot;500m&quot;
    memory: &quot;512Mi&quot;
  requests:
    cpu: &quot;250m&quot;
    memory: &quot;256Mi&quot;

ingress:
  enabled: true
  className: nginx
  hosts:
    - host: order.example.com
      paths:
        - path: /
          pathType: Prefix

replicaCount: 2

image:

repository: your-dockerhub/order-service

pullPolicy: IfNotPresent

tag: latest # CI が SHA を上書きします

service:

type: ClusterIP

port: 8080

resources:

limits:

cpu: "500m"

memory: "512Mi"

requests:

cpu: "250m"

memory: "256Mi"

ingress:

enabled: true

className: nginx

hosts:

- host: order.example.com

paths:

- path: /

pathType: Prefix

`templates/deployment.yaml`（重要ポイントにコメント）

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include &quot;order-service.fullname&quot; . }}
  labels:
    {{- include &quot;order-service.labels&quot; . | nindent 4 }}
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app.kubernetes.io/name: {{ include &quot;order-service.name&quot; . }}
  template:
    metadata:
      annotations:
        prometheus.io/scrape: &quot;true&quot;
        prometheus.io/port: &quot;{{ .Values.service.port }}&quot;
      labels:
        app.kubernetes.io/name: {{ include &quot;order-service.name&quot; . }}
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: &quot;{{ .Values.image.repository }}:{{ .Values.image.tag }}&quot;
          ports:
            - containerPort: {{ .Values.service.port }}
          envFrom:
            - configMapRef:
                name: order-service-config
          readinessProbe:
            httpGet:
              path: /actuator/health
              port: {{ .Values.service.port }}
            initialDelaySeconds: 10
            periodSeconds: 5

apiVersion: apps/v1

kind: Deployment

metadata:

labels:

spec:

replicas: {{ .Values.replicaCount }}

selector:

matchLabels:

app.kubernetes.io/name: {{ include "order-service.name" . }}

template:

metadata:

annotations:

prometheus.io/scrape: "true"

prometheus.io/port: "{{ .Values.service.port }}"

labels:

app.kubernetes.io/name: {{ include "order-service.name" . }}

spec:

containers:

- name: {{ .Chart.Name }}

image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"

ports:

- containerPort: {{ .Values.service.port }}

envFrom:

- configMapRef:

readinessProbe:

httpGet:

path: /actuator/health

port: {{ .Values.service.port }}

initialDelaySeconds: 10

periodSeconds: 5

5️⃣2 GitHub Actions による CI/CD（`ci-cd.yml`）

name: CI / CD

on:
  push:
    branches: [ main ]

jobs:
  build-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Set up JDK 21
        uses: actions/setup-java@v3
        with:
          distribution: temurin
          java-version: '21'
          cache: maven

      - name: Build &amp; run unit tests
        run: |
          mvn -B verify --file pom.xml

      - name: Publish test results
        uses: actions/upload-artifact@v4
        with:
          name: surefire-reports
          path: target/surefire-reports/

  docker-push-deploy:
    needs: build-test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Log in to Docker Hub
        uses: docker/login-action@v2
        with:
          username: ${{ secrets.DOCKER_USER }}
          password: ${{ secrets.DOCKER_PASS }}

      - name: Build &amp; push image (SHA tag)
        run: |
          IMAGE=${{ secrets.DOCKER_USER }}/order-service:${{ github.sha }}
          docker build -t $IMAGE .
          docker push $IMAGE

      - name: Set up kubectl
        uses: azure/setup-kubectl@v3
        with:
          version: 'v1.30.0'

      - name: Deploy to Kubernetes (Helm)
        env:
          KUBECONFIG: ${{ secrets.KUBE_CONFIG }}
        run: |
          helm upgrade --install order-service ./helm/order-service \
            --set image.tag=${{ github.sha }} \
            --namespace microservice-demo --create-namespace

on:

push:

branches: [ main ]

jobs:

build-test:

runs-on: ubuntu-latest

steps:

- name: Checkout repository

uses: actions/checkout@v4

- name: Set up JDK 21

uses: actions/setup-java@v3

with:

distribution: temurin

java-version: '21'

cache: maven

- name: Build & run unit tests

run: |

mvn -B verify --file pom.xml

- name: Publish test results

uses: actions/upload-artifact@v4

with:

path: target/surefire-reports/

docker-push-deploy:

needs: build-test

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v4

- name: Log in to Docker Hub

uses: docker/login-action@v2

with:

username: ${{ secrets.DOCKER_USER }}

password: ${{ secrets.DOCKER_PASS }}

- name: Build & push image (SHA tag)

run: |

IMAGE=${{ secrets.DOCKER_USER }}/order-service:${{ github.sha }}

docker build -t $IMAGE .

docker push $IMAGE

- name: Set up kubectl

uses: azure/setup-kubectl@v3

with:

version: 'v1.30.0'

- name: Deploy to Kubernetes (Helm)

env:

KUBECONFIG: ${{ secrets.KUBE_CONFIG }}

run: |

helm upgrade --install order-service ./helm/order-service \

--set image.tag=${{ github.sha }} \

--namespace microservice-demo --create-namespace

補足
KUBE_CONFIG は GitHub のシークレットに Base64 エンコードした kubeconfig を保存し、env: でデコードして使用します。
Windows ランナーが必要な場合は runs-on: windows-latest に変更し、Docker Desktop がインストールされた環境を用意してください。

5️⃣3 Observability（メトリクス・トレーシング・ログ）

5.3.1 Micrometer + Prometheus

# src/main/resources/application.yml
management:
  endpoints:
    web:
      exposure:
        include: health,info,prometheus
  metrics:
    export:
      prometheus:
        enabled: true

# src/main/resources/application.yml

management:

endpoints:

web:

exposure:

include: health,info,prometheus

metrics:

export:

prometheus:

enabled: true

Prometheus の scrape_configs に以下を追加：

- job_name: 'order-service'
  static_configs:
    - targets: ['order-service.default.svc.cluster.local:8080']
  metrics_path: '/actuator/prometheus'

- job_name: 'order-service'

static_configs:

- targets: ['order-service.default.svc.cluster.local:8080']

metrics_path: '/actuator/prometheus'

5.3.2 Zipkin（分散トレーシング）

pom.xml に依存を追加：

&lt;dependency&gt;
    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
    &lt;artifactId&gt;spring-cloud-starter-zipkin&lt;/artifactId&gt;
&lt;/dependency&gt;

<groupId>org.springframework.cloud</groupId>

<artifactId>spring-cloud-starter-zipkin</artifactId>

</dependency>

application.yml 設定例：

spring:
  zipkin:
    base-url: http://zipkin:9411/
  sleuth:
    sampler:
      probability: 0.5   # 本番では 0.1 程度に抑える

spring:

zipkin:

base-url: http://zipkin:9411/

sleuth:

sampler:

probability: 0.5 # 本番では 0.1 程度に抑える

5.3.3 ログ集約（ELK）

&lt;dependency&gt;
    &lt;groupId&gt;net.logstash.logback&lt;/groupId&gt;
    &lt;artifactId&gt;logstash-logback-encoder&lt;/artifactId&gt;
    &lt;version&gt;7.4&lt;/version&gt;
&lt;/dependency&gt;

<groupId>net.logstash.logback</groupId>

<artifactId>logstash-logback-encoder</artifactId>

</dependency>

src/main/resources/logback-spring.xml の抜粋：

&lt;appender name=&quot;LOGSTASH&quot; class=&quot;net.logstash.logback.appender.LogstashTcpSocketAppender&quot;&gt;
    &lt;destination&gt;${LOGSTASH_HOST:logstash}:5000&lt;/destination&gt;
    &lt;encoder class=&quot;net.logstash.logback.encoder.LoggingEventCompositeJsonEncoder&quot;&gt;
        &lt;providers&gt;
            &lt;timestamp/&gt;
            &lt;pattern&gt;
                &lt;pattern&gt;
                    {
                      &quot;level&quot;: &quot;%level&quot;,
                      &quot;logger&quot;: &quot;%logger&quot;,
                      &quot;thread&quot;: &quot;%thread&quot;,
                      &quot;message&quot;: &quot;%msg&quot;
                    }
                &lt;/pattern&gt;
            &lt;/pattern&gt;
        &lt;/providers&gt;
    &lt;/encoder&gt;
&lt;/appender&gt;

&lt;root level=&quot;INFO&quot;&gt;
    &lt;appender-ref ref=&quot;CONSOLE&quot;/&gt;
    &lt;appender-ref ref=&quot;LOGSTASH&quot;/&gt;
&lt;/root&gt;

<destination>${LOGSTASH_HOST:logstash}:5000</destination>

{

"level": "%level",

"logger": "%logger",

"thread": "%thread",

"message": "%msg"

}

</pattern>

</providers>

</encoder>

</appender>

<appender-ref ref="CONSOLE"/>

<appender-ref ref="LOGSTASH"/>

</root>

ポイント
* コンテナ環境では LOGSTASH_HOST を環境変数で注入し、Fluent Bit → Elasticsearch へ転送する構成が一般的です。

5️⃣4 Security – JWT 認証

依存関係（pom.xml）

&lt;dependency&gt;
    &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
    &lt;artifactId&gt;spring-boot-starter-security&lt;/artifactId&gt;
&lt;/dependency&gt;
&lt;dependency&gt;
    &lt;groupId&gt;io.jsonwebtoken&lt;/groupId&gt;
    &lt;artifactId&gt;jjwt-api&lt;/artifactId&gt;
    &lt;version&gt;0.12.5&lt;/version&gt;
&lt;/dependency&gt;
&lt;dependency&gt;
    &lt;groupId&gt;io.jsonwebtoken&lt;/groupId&gt;
    &lt;artifactId&gt;jjwt-impl&lt;/artifactId&gt;
    &lt;version&gt;0.12.5&lt;/version&gt;
    &lt;scope&gt;runtime&lt;/scope&gt;
&lt;/dependency&gt;
&lt;dependency&gt;
    &lt;groupId&gt;io.jsonwebtoken&lt;/groupId&gt;
    &lt;artifactId&gt;jjwt-jackson&lt;/artifactId&gt;
    &lt;version&gt;0.12.5&lt;/version&gt;
    &lt;scope&gt;runtime&lt;/scope&gt;
&lt;/dependency&gt;

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-security</artifactId>

</dependency>

<groupId>io.jsonwebtoken</groupId>

</dependency>

<groupId>io.jsonwebtoken</groupId>

<scope>runtime</scope>

</dependency>

<groupId>io.jsonwebtoken</groupId>

<artifactId>jjwt-jackson</artifactId>

<scope>runtime</scope>

</dependency>

セキュリティ設定（`SecurityConfig.java`）

@EnableWebSecurity
@RequiredArgsConstructor
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    private final JwtProvider jwtProvider;

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .sessionManagement()
                .sessionCreationPolicy(SessionCreationPolicy.STATELESS)
            .and()
            .authorizeRequests()
                .antMatchers(
                    &quot;/swagger-ui.html/**&quot;,
                    &quot;/v3/api-docs/**&quot;,
                    &quot;/actuator/health&quot;
                ).permitAll()
                .anyRequest().authenticated()
            .and()
            .addFilterBefore(new JwtAuthenticationFilter(jwtProvider),
                             UsernamePasswordAuthenticationFilter.class);
    }
}

@EnableWebSecurity

@RequiredArgsConstructor

public class SecurityConfig extends WebSecurityConfigurerAdapter {

private final JwtProvider jwtProvider;

@Override

protected void configure(HttpSecurity http) throws Exception {

http.csrf().disable()

.sessionManagement()

.sessionCreationPolicy(SessionCreationPolicy.STATELESS)

.and()

.authorizeRequests()

.antMatchers(

"/swagger-ui.html/**",

"/v3/api-docs/**",

"/actuator/health"

).permitAll()

.anyRequest().authenticated()

.and()

.addFilterBefore(new JwtAuthenticationFilter(jwtProvider),

UsernamePasswordAuthenticationFilter.class);

}

JWT プロバイダーの概略実装

@Component
@RequiredArgsConstructor
public class JwtProvider {

    private final SecretKey secretKey = Keys.hmacShaKeyFor(
        Base64.getDecoder().decode(System.getenv(&quot;JWT_SECRET&quot;))
    );

    public String createToken(String username, List&lt;String&gt; roles) {
        return Jwts.builder()
                .setSubject(username)
                .claim(&quot;roles&quot;, roles)
                .setIssuedAt(new Date())
                .setExpiration(Date.from(Instant.now().plus(2, ChronoUnit.HOURS)))
                .signWith(secretKey, SignatureAlgorithm.HS256)
                .compact();
    }

    public boolean validate(String token) {
        try {
            Jwts.parserBuilder()
                .setSigningKey(secretKey)
                .build()
                .parseClaimsJws(token);
            return true;
        } catch (JwtException e) {
            return false;
        }
    }

    public String getUsername(String token) {
        return Jwts.parserBuilder()
                .setSigningKey(secretKey)
                .build()
                .parseClaimsJws(token)
                .getBody()
                .getSubject();
    }
}

@Component

@RequiredArgsConstructor

public class JwtProvider {

private final SecretKey secretKey = Keys.hmacShaKeyFor(

Base64.getDecoder().decode(System.getenv("JWT_SECRET"))

);

public String createToken(String username, List<String> roles) {

return Jwts.builder()

.setSubject(username)

.claim("roles", roles)

.setIssuedAt(new Date())

.setExpiration(Date.from(Instant.now().plus(2, ChronoUnit.HOURS)))

.signWith(secretKey, SignatureAlgorithm.HS256)

.compact();

}

public boolean validate(String token) {

try {

Jwts.parserBuilder()

.setSigningKey(secretKey)

.build()

.parseClaimsJws(token);

return true;

} catch (JwtException e) {

return false;

}

public String getUsername(String token) {

return Jwts.parserBuilder()

.setSigningKey(secretKey)

.build()

.parseClaimsJws(token)

.getBody()

.getSubject();

}

ベストプラクティス
JWT_SECRET は必ず 環境変数 か Kubernetes Secret に保存し、コードにハードコーディングしないこと。
トークンの有効期限は用途に合わせて短め（15‑30 分）に設定し、リフレッシュトークンで延長する構成が推奨されます。

6️⃣ 参考リンク（公式ドキュメント）

項目	URL
Spring Boot 3.2.x リファレンス	https://docs.spring.io/spring-boot/docs/current/reference/html/
Spring Cloud 2024.0.x (Hoxton)	https://spring.io/projects/spring-cloud
Spring Initializr	https://start.spring.io
Spring Cloud Eureka	https://cloud.spring.io/spring-cloud-netflix/reference/html/#spring-cloud-eureka-server
Spring Cloud Config Server	https://docs.spring.io/spring-cloud-config/reference/
Springdoc OpenAPI 3	https://springdoc.org/
Micrometer & Prometheus Integration	https://micrometer.io/docs/registry/prometheus
Zipkin with Spring Cloud Sleuth	https://spring.io/guides/gs/distributed-tracing/
Helm Charts のベストプラクティス	https://helm.sh/docs/topics/charts/
GitHub Actions for Java	https://docs.github.com/en/actions/language-and-framework-guides/building-and-testing-java-with-maven

上記リンクはすべて公式または広く信頼されたリソースです。外部の未確認サイトへの依存は排除しました。

まとめ

OS に合わせた JDK/IDE のインストール を最初に完了させる（macOS・Linux・Windows 各対応）。
Spring Initializr で必要なスターターを選択し、pom.xml／build.gradle に BOM を導入すれば依存管理がシンプルになる。
Eureka + Config Server の組み合わせでサービスディスカバリと外部化設定を実装。
Springdoc OpenAPI が自動生成する Swagger UI と、マルチステージ Dockerfile により開発から本番デプロイまで一貫したフローが確立できる。
Helm + GitHub Actions で Kubernetes への継続的デリバリーを実現し、Micrometer/Prometheus, Zipkin, ELK による可観測性、そして JWT + Spring Security による API 保護を組み込む。

この手順書は「最新安定版」前提で作成していますが、バージョンは随時公式リリースノートで確認し、<properties> や helm values の値を書き換えて運用してください。

本稿の内容は 2026‑04‑15 時点の情報に基づいています。技術スタックは急速に進化するため、公式ドキュメントやリリースノートで定期的な見直しを行うことを推奨します。

スポンサードリンク

Spring Boot 3.2 と JDK21で始めるマイクロサービス開発ガイド

1️⃣ 前提条件と開発ツールのインストール

1.1 必要なコンポーネント

1.2 OS 別インストール手順

macOS

Ubuntu/Debian 系 Linux

Windows（PowerShell）

2️⃣ Spring Initializr で雛形プロジェクトを作成

2.1 Spring Initializr の利用方法

2.2 生成された pom.xml（抜粋）

2.3 プロジェクトのインポート

3️⃣ サービスディスカバリ & 設定管理（Eureka / Consul + Config Server）

3.1 Eureka Server の作成

src/main/resources/application.yml

起動クラス

3.2 Config Server の作成

src/main/resources/application.yml

3.3 クライアント側設定例（order‑service）

bootstrap.yml（Spring Boot 2.x 系から推奨されていたファイルですが、Spring Boot 3 でも有効です）

application.yml（ローカルプロパティの上書き例）

4️⃣ REST API と自動ドキュメント、Docker イメージの作成

4.1 コントローラ・サービス実装（簡易サンプル）

4.2 OpenAPI (Springdoc) の自動生成

4.3 Dockerfile（マルチステージビルド）

ビルド・実行例

5️⃣ Kubernetes デプロイ、CI/CD パイプライン、Observability & Security

5️⃣1 Helm Chart（order‑service 用）

Chart.yaml

values.yaml（主要パラメータ）

templates/deployment.yaml（重要ポイントにコメント）

5️⃣2 GitHub Actions による CI/CD（ci-cd.yml）

5️⃣3 Observability（メトリクス・トレーシング・ログ）

5.3.1 Micrometer + Prometheus

5.3.2 Zipkin（分散トレーシング）

5.3.3 ログ集約（ELK）

5️⃣4 Security – JWT 認証

依存関係（pom.xml）

セキュリティ設定（SecurityConfig.java）

JWT プロバイダーの概略実装

6️⃣ 参考リンク（公式ドキュメント）

まとめ

2.2 生成された `pom.xml`（抜粋）

`src/main/resources/application.yml`

`src/main/resources/application.yml`

`bootstrap.yml`（Spring Boot 2.x 系から推奨されていたファイルですが、Spring Boot 3 でも有効です）

`application.yml`（ローカルプロパティの上書き例）

`Chart.yaml`

`values.yaml`（主要パラメータ）

`templates/deployment.yaml`（重要ポイントにコメント）

5️⃣2 GitHub Actions による CI/CD（`ci-cd.yml`）

セキュリティ設定（`SecurityConfig.java`）