ASP.NET Coreをスクラッチでコンテナ化する際の手順のバックアップ(No.5)

バックアップ一覧
差分を表示
現在との差分を表示
ソースを表示
ASP.NET Coreをスクラッチでコンテナ化する際の手順へ行く。
- 1 (2026-05-21 (木) 15:31:31)
- 2 (2026-05-21 (木) 15:37:08)
- 3 (2026-05-22 (金) 15:00:46)
- 4 (2026-05-25 (月) 14:31:42)
- 5 (2026-05-25 (月) 21:01:32)

「.NET 開発基盤部会 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

戻る
- ASP.NET Coreをコンテナ化する際の設定ポリシー
- ASP.NET Coreをスクラッチでコンテナ化する際の手順

↑

概要 †

生成AIを活用しスクラッチでコンテナ化する際の手順をメモ

↑

詳細 †

ASP.NET Core アプリケーションのコンテナ化をツールに頼らず手動で行う。
コチラを確認すると、むしろ手動でないと問題になりそう（開発用は仕込みが多過ぎる）。

↑

Dockerファイルの作成 †

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

↑

ソース †

dockerfile# ビルドステージ
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src

# プロジェクト・ファイルをコピーして依存関係を復元
COPY ["MyApp.csproj", "."]
RUN dotnet restore "./MyApp.csproj"

# ソースコードをコピーしてビルド
COPY . .
RUN dotnet build "MyApp.csproj" -c Release -o /app/build

# 発行ステージ
FROM build AS publish
RUN dotnet publish "MyApp.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 実行ステージ（軽量イメージ）
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
WORKDIR /app
EXPOSE 8080
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyApp.dll"]

↑

解説 †

※ マルチステージ・ビルドという手法を使っている。

ステージ1: build

buildステージを初期化
各種のSDKを含む開発用の重量級イメージ
```
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
```

buildステージの「カレント・ディレクトリ」を設定
```
WORKDIR /src
```

初めに、プロジェクト・ファイルをコピーして依存関係を復元
```
COPY ["MyApp.csproj", "."]
RUN dotnet restore "./MyApp.csproj"
```

次に、ソース全体をコピーしてReleaseビルド

COPY . .
RUN dotnet build "MyApp.csproj" -c Release -o /app/build

ステージ2: publish

publishはbuildステージを引き継ぐ
```
FROM build AS publish
```

/app/publish へ本番用の成果物を生成
（/p:UseAppHost?=false は、OS依存の実行ファイルを生成しない設定）
```
RUN dotnet publish "MyApp.csproj" -c Release -o /app/publish /p:UseAppHost=false
```

ステージ3: final（実行用・軽量ステージ）

finalステージを初期化
SDKを含まないランタイム専用の軽量イメージ
```
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
```

コンテナ内の「カレント・ディレクトリ」を設定
```
WORKDIR /app
```

ポート公開
```
EXPOSE 8080
```

publishステージで作られた成果物だけを取り込む
```
COPY --from=publish /app/publish .
```

アプリ起動
```
ENTRYPOINT ["dotnet", "MyApp.dll"]
```

※ COPYコマンドのポイント

角括弧を使うと、JSON配列形式で、スペースを含むパスを正確に扱える。
- COPY My App/MyApp?.csproj .
- COPY ["My App/MyApp?.csproj", "."]

左右のオペランド
- COPY <ホスト側（コピー元）> <コンテナ側（コピー先）>
- COPY --from=前ステージ名 <前ステージ側（コピー元）> <現ステージ側（コピー先）>

↑

.dockerignoreの作成 †

↑

ソース †

**/bin/
**/obj/
**/out/
.git/
.vs/
*.user

↑

解説 †

不要なファイルをビルドコンテキストから除外。

↑

Dockerコマンドで実行 †

↑

準備 †

Dockerfileをビルドし名称付与されたイメージを生成
```
docker build -t myapp:latest .
```

使用する場合は、Dockerコンポーズを定義する。

↑

実行 †

Dockerコマンドによるコンテナ起動

docker run -d -p 8080:8080 --name myapp myapp:latest

Dockerコマンドによるコンテナ起動
```
docker compose up -d
```

ログ確認
```
docker logs myapp
```

コンテナに入る
```
docker exec -it myapp /bin/bash
```

↑

Dockerコンポーズ †

プロジェクト・ルートに docker-compose.yml を作成

↑

例１ †

最も簡潔な例

version: '3.8'

services:
  ap:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ConnectionStrings__Default=Server=db;Database=MyDb;...
    depends_on:
      - db

  db:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      - SA_PASSWORD=YourPassword123!
      - ACCEPT_EULA=Y
    ports:
      - "1433:1433"

↑

例２ †

２つのファイルを使用する場合

定義

DB側

version: '3.8'

services:
  db:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      - SA_PASSWORD=YourPassword123!
      - ACCEPT_EULA=Y
    ports:
      - "1433:1433"
    networks:
      - shared-net

networks:
  shared-net:
    name: myapp-network  # 固定名を指定（server側から参照するため）
    driver: bridge

※ 各サービスは「参加する」ネットワークを指定し、末尾で、そのネットワークの「定義」する。
※ driver: bridge は networks のデフォルト値なので、今回のケースでは書かなくても動作は同じ。

AP側

version: '3.8'

services:
  ap:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ConnectionStrings__Default=Server=db;Database=MyDb;...
    networks:
      - shared-net

networks:
  shared-net:
    name: myapp-network  # db側と同じ名前を指定する。
    external: true       # 新規作成せず、既存を使う。

※ ファイルを跨いだ depends_on は使えないため削除する。

起動・停止

起動

# 1. まずDBを起動
docker compose -f docker-compose.db.yml up -d
# 2. DBが準備できたらサーバーを起動
docker compose -f docker-compose.server.yml up -d

停止

# 停止する場合（逆順）
docker compose -f docker-compose.server.yml down
docker compose -f docker-compose.db.yml down

※ ネットワークはコマンドで作成してファイル中は全て「external: true」にすると起動順は任意になる。

docker network create --driver bridge shared-net

↑

ホストビルド方式 †

ホストビルド方式では、コンテナ内部ではなく、ホストOS（WindowsやLinux上）でビルドした生成物をコンテナに詰める方式。

↑

Dockerファイル †

# 実行ステージ（軽量イメージのみ）
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
WORKDIR /app
EXPOSE 8080
COPY ./publish .
ENTRYPOINT ["dotnet", "MyApp.dll"]

↑

ビルド＆イメージ作成の手順 †

1. ホストでビルド・発行

dotnet publish "MyApp.csproj" -c Release -o ./publish /p:UseAppHost=false

2. Dockerイメージをビルド
```
docker build -t myapp .
```

ASP.NET Coreをスクラッチでコンテナ化する際の手順 のバックアップ(No.5)

目次 †

概要 †

詳細 †

Dockerファイルの作成 †

ソース †

解説 †

.dockerignoreの作成 †

ソース †

解説 †

Dockerコマンドで実行 †

準備 †

実行 †

Dockerコンポーズ †

例１ †

例２ †

ホストビルド方式 †

Dockerファイル †

ビルド＆イメージ作成の手順 †

ASP.NET Coreをスクラッチでコンテナ化する際の手順のバックアップ(No.5)