【Spring Boot × Docker】WSL環境でWebサービスを構築するサンプル手順とコード

はじめに

Windows11 + WSL Ubuntu 24.04 上で、Spring Boot アプリケーションを Docker コンテナで起動してみた手順をまとめました。

Spring Boot アプリは公式チュートリアル「Spring Boot with Docker」を参考に作成しています。

---

環境

項目	バージョン
OS	Windows 11
WSL	Ubuntu 24.04
Java	OpenJDK 17
Spring Boot	3.x（Spring Initializr）
Docker	24.x（WSL 経由）

---

1. プロジェクト作成

Spring Initializr または curl でテンプレートを作成します。

curl https://start.spring.io/starter.tgz \
  -d dependencies=web \
  -d name=demo \
  -d packageName=hello \
  | tar -xzvf -

ディレクトリ構成（一部）

demo/
├── build.gradle
├── src/
│   └── main/
│       └── java/
│           └── hello/
│               └── Application.java

---

2. Javaファイルの中身

// src/main/java/hello/Application.java
package hello;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class Application {

  @RequestMapping("/")
  public String home() {
    return "Hello Docker World";
  }

  public static void main(String[] args) {
    SpringApplication.run(Application.class, args);
  }
}

---

3. Dockerfile の作成

プロジェクトルートに Dockerfile を作成：

# ベースイメージ
FROM eclipse-temurin:17-jdk-jammy

# 作業ディレクトリ作成
WORKDIR /app

# Jar ファイルをコピー（ビルド後のもの）
COPY target/*.jar app.jar

# ポート開放
EXPOSE 8080

# アプリケーション起動
ENTRYPOINT ["java", "-jar", "app.jar"]

---

4. build.gradle の設定

build.gradle に以下のように記述します（Maven の場合は pom.xml）。

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.0'
    id 'io.spring.dependency-management' version '1.1.0'
}

group = 'hello'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

bootJar {
    archiveFileName = 'app.jar'
}

---

5. アプリのビルドと Docker イメージ作成

./gradlew bootJar
docker build -t springboot-docker-demo .

---

6. コンテナ起動と動作確認

docker run -p 8080:8080 springboot-docker-demo

以下にアクセス：

http://localhost:8080

表示：

Hello Docker World

---

7. WSL 環境での注意点

• Docker Desktop をインストールし、「WSL2 統合」を有効にしておく。
• docker コマンドは WSL 上から直接使用可能。
• ブラウザは Windows 側のものでOK（localhostは共通）。

---

おわりに

WSL環境でも、DockerとSpring Bootを使えばローカルで簡単にWebサービスを構築できます。

今後は docker-compose でのDB連携や、ホットリロード対応の開発環境構築なども検討していきたいです。

---