ASP.NET .NET Framework コンテナ化プロンプト

以下のコンテナ化設定で指定された ASP.NET (.NET Framework) プロジェクトをコンテナ化します。Windows Docker コンテナでアプリケーションを実行するために必要な変更にのみ焦点を当てます。コンテナ化はここで指定されたすべての設定を考慮する必要があります。

重要: これは .NET Core アプリケーションではなく、.NET Framework アプリケーションです。コンテナ化プロセスは .NET Core アプリケーションのものとは異なります。

コンテナ化設定

このプロンプトのセクションには、ASP.NET (.NET Framework) アプリケーションのコンテナ化に必要な特定の設定と構成が含まれています。このプロンプトを実行する前に、必要な情報を設定に入力してください。多くの場合、最初のいくつかの設定のみが必要です。後の設定がプロジェクトに適用されない場合は、デフォルト値のままにすることができます。

指定されていない設定はデフォルト値に設定されます。デフォルト値は[角括弧]で示されています。

基本プロジェクト情報

1. コンテナ化するプロジェクト:

   • [ProjectName (.csproj ファイルへのパスを指定)]

2. 使用する Windows Server SKU:

   • [Windows Server Core (デフォルト) または Windows Server Full]

3. 使用する Windows Server バージョン:

   • [2022、2019、または 2016 (デフォルト 2022)]

4. Docker イメージのビルドステージ用のカスタムベースイメージ("None" で標準 Microsoft ベースイメージを使用):

   • [ビルドステージに使用するベースイメージを指定 (デフォルト None)]

5. Docker イメージの実行ステージ用のカスタムベースイメージ("None" で標準 Microsoft ベースイメージを使用):

   • [実行ステージに使用するベースイメージを指定 (デフォルト None)]

コンテナ設定

1. コンテナイメージで公開する必要があるポート:

   • プライマリ HTTP ポート: [例: 80]
   • 追加ポート: [追加ポートのリスト、または "None"]

2. コンテナが実行するユーザーアカウント:

   • [ユーザーアカウント、またはデフォルト "ContainerUser"]

3. コンテナイメージで設定する必要がある IIS 設定:

   • [特定の IIS 設定のリスト、または "None"]

ビルド設定

1. コンテナイメージをビルドする前に実行する必要があるカスタムビルドステップ:

   • [特定のビルドステップのリスト、または "None"]

2. コンテナイメージをビルドした後に実行する必要があるカスタムビルドステップ:

   • [特定のビルドステップのリスト、または "None"]

依存関係

1. コンテナイメージの GAC に登録すべき .NET アセンブリ:

   • [アセンブリ名とバージョン、または "None"]

2. コンテナイメージにコピーしてインストールする必要がある MSI:

   • [MSI 名とバージョン、または "None"]

3. コンテナイメージに登録する必要がある COM コンポーネント:

   • [COM コンポーネント名、または "None"]

システム設定

1. コンテナイメージに追加する必要があるレジストリキーと値:

   • [レジストリパスと値、または "None"]

2. コンテナイメージで設定する必要がある環境変数:

   • [変数名と値、または "デフォルトを使用"]

3. コンテナイメージにインストールする必要がある Windows Server ロールとフィーチャー:

   • [ロール/フィーチャー名、または "None"]

ファイルシステム

1. コンテナイメージにコピーする必要があるファイル/ディレクトリ:

   • [プロジェクトルートからの相対パス、または "None"]
   • コンテナ内のターゲット場所: [コンテナパス、または "該当なし"]

2. コンテナ化から除外するファイル/ディレクトリ:

   • [除外するパス、または "None"]

.dockerignore 設定

1. .dockerignore ファイルに含めるパターン (.dockerignore には既に一般的なデフォルトが含まれています。これらは追加パターンです):
   • 追加パターン: [追加パターンのリスト、または "None"]

ヘルスチェック設定

1. ヘルスチェックエンドポイント:

   • [ヘルスチェック URL パス、または "None"]

2. ヘルスチェック間隔とタイムアウト:

   • [間隔とタイムアウト値、または "デフォルトを使用"]

その他の指示

1. プロジェクトをコンテナ化するために従う必要があるその他の指示:
   • [特定の要件、または "None"]

2.対処すべき既知の問題:

• [既知の問題の説明、または "None"]

スコープ

• ✅ アプリ設定の変更。環境変数からアプリケーション設定と接続文字列を読み取るために構成ビルダーが使用されるようにする
• ✅ ASP.NET アプリケーション用の Dockerfile の作成と構成
• ✅ Dockerfile に複数のステージを指定し、アプリケーションをビルド/発行して出力を最終イメージにコピーする
• ✅ Windows コンテナプラットフォーム互換性の構成 (Windows Server Core または Full)
• ✅ 依存関係の適切な処理 (GAC アセンブリ、MSI、COM コンポーネント)
• ❌ インフラストラクチャセットアップなし (別途処理されると想定)
• ❌ コンテナ化に必要な変更以外のコード変更なし

実行プロセス

1. 上記のコンテナ化設定を確認してコンテナ化要件を理解する
2. チェックマーク付きで変更を追跡するための progress.md ファイルを作成する
3. プロジェクトの .csproj ファイルから TargetFrameworkVersion 要素をチェックして .NET Framework バージョンを決定する
4. 以下に基づいて適切な Windows Server コンテナイメージを選択する:
   • プロジェクトから検出された .NET Framework バージョン
   • コンテナ化設定で指定された Windows Server SKU (Core または Full)
   • コンテナ化設定で指定された Windows Server バージョン (2016、2019、または 2022)
   • Windows Server Core タグは以下で確認できます: https://github.com/microsoft/dotnet-framework-docker/blob/main/README.aspnet.md#full-tag-listing
5. 必要な NuGet パッケージがインストールされていることを確認します。インストールされていない場合はインストールしないでください。 インストールされていない場合は、このプロンプトの実行を一時停止し、Visual Studio NuGet パッケージマネージャーまたは Visual Studio パッケージマネージャーコンソールを使用してパッケージをインストールするようユーザーに依頼してください。以下のパッケージが必須です:
   • Microsoft.Configuration.ConfigurationBuilders.Environment
6. web.config ファイルを変更し、環境変数からアプリケーション設定と接続文字列を読み取るための構成ビルダーセクションと設定を追加します:
   • configSections に ConfigBuilders セクションを追加
   • ルートに configBuilders セクションを追加
   • appSettings と connectionStrings の両方に EnvironmentConfigBuilder を構成
   • 例のパターン:

     <configSections>
       <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
     </configSections>
     <configBuilders>
       <builders>
         <add name="Environment" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
       </builders>
     </configBuilders>
     <appSettings configBuilders="Environment">
       <!-- 既存のアプリケーション設定 -->
     </appSettings>
     <connectionStrings configBuilders="Environment">
       <!-- 既存の接続文字列 -->
     </connectionStrings>
     

7. このプロンプトの最後の参照 LogMonitorConfig.json ファイルをコピーして、Dockerfile が作成されるフォルダーに LogMonitorConfig.json ファイルを作成します。ファイルの内容は変更してはいけません。コンテナ化設定の指示で別途指定されない限り、参照内容と完全に一致する必要があります。
   • 特に、ログするべき問題のレベルを変更しないでください。EventLog ソースに Information レベルを使用すると不要なノイズが発生します。
8. プロジェクトのルートディレクトリに Dockerfile を作成してアプリケーションをコンテナ化します
   • Dockerfile は複数のステージを使用する必要があります:
     • ビルドステージ: Windows Server Core イメージを使用してアプリケーションをビルド
       • ビルドステージは、設定ファイルでカスタムベースイメージが指定されていない限り、mcr.microsoft.com/dotnet/framework/sdk ベースイメージを使用する必須です
       • sln、csproj、packages.config ファイルを最初にコピー
       • NuGet.config が存在する場合はコピーし、プライベートフィードを構成
       • NuGet パッケージを復元
       • その後、残りのソースコードをコピーし、MSBuild を使用してアプリケーションをビルドして C:\publish に発行
     • 最終ステージ: 選択した Windows Server イメージを使用してアプリケーションを実行
       • 最終ステージは、設定ファイルでカスタムベースイメージが指定されていない限り、mcr.microsoft.com/dotnet/framework/aspnet ベースイメージを使用する必須です
       • LogMonitorConfig.json ファイルをコンテナ内のディレクトリ (例: C:\LogMonitor) にコピー
       • Microsoft リポジトリから LogMonitor.exe を同じディレクトリにダウンロード
         • 正しい LogMonitor.exe URL は: https://github.com/microsoft/windows-container-tools/releases/download/v2.1.1/LogMonitor.exe
       • 作業ディレクトリを C:\inetpub\wwwroot に設定
       • ビルドステージから発行された出力 (C:\publish) を最終イメージにコピー
       • コンテナのエントリーポイントを、LogMonitor.exe を使用して ServiceMonitor.exe で IIS サービスをモニター実行するように設定
         • ENTRYPOINT [ "C:\\LogMonitor\\LogMonitor.exe", "C:\\ServiceMonitor.exe", "w3svc" ]
   • コンテナ化設定のすべての要件を考慮してください:
     • Windows Server SKU とバージョン
     • 公開ポート
     • コンテナ用のユーザーアカウント
     • IIS 設定
     • GAC アセンブリ登録
     • MSI インストール
     • COM コンポーネント登録
     • レジストリキー
     • 環境変数
     • Windows ロールとフィーチャー
     • ファイル/ディレクトリのコピー
   • このプロンプトの最後で提供されている例に従って Dockerfile をモデル化しますが、特定のプロジェクト要件と設定に合わせてカスタマイズしてください。
   • 重要: ユーザーが設定ファイルで具体的に Full Windows Server イメージをリクエストしていない限り、Windows Server Core ベースイメージを使用してください
9. プロジェクトのルートディレクトリに .dockerignore ファイルを作成し、Docker イメージから不要なファイルを除外します。.dockerignore ファイルは、コンテナ化設定で指定された追加パターンと同様に、少なくとも以下の要素を含む必須です:
   • packages/
   • bin/
   • obj/
   • .dockerignore
   • Dockerfile
   • .git/
   • .github/
   • .vs/
   • .vscode/
   • **/node_modules/
   • *.user
   • *.suo
   • **/.DS_Store
   • **/Thumbs.db
   • コンテナ化設定で指定された追加パターン
10. 設定でヘルスチェックが指定されている場合は、ヘルスチェックを構成します:

• ヘルスチェックエンドポイントが指定されている場合は、Dockerfile に HEALTHCHECK 指示を追加

11. dockerfile をプロジェクトに追加し、プロジェクトファイルに以下の項目を追加: <None Include="Dockerfile" />
12. タスクを完了にマーク: [ ] → [✓]
13. すべてのタスクが完了し Docker ビルドが成功するまで続行

ビルドおよびランタイム検証

Docker ビルドが成功することを確認します。Dockerfile が完成したら、以下のコマンドを使用して Docker イメージをビルドします:

docker build -t aspnet-app:latest .

ビルドが失敗した場合は、エラーメッセージを確認し、Dockerfile またはプロジェクト設定に必要な調整を加えてください。成功/失敗を報告します。

進捗追跡

以下の構造で progress.md ファイルを管理します:

# コンテナ化進捗

## 環境検出
- [ ] .NET Framework バージョン検出 (バージョン: ___)
- [ ] Windows Server SKU 選択 (SKU: ___)
- [ ] Windows Server バージョン選択 (バージョン: ___)

## 設定変更
- [ ] 構成ビルダーの web.config 変更
- [ ] NuGet パッケージソース設定 (該当する場合)
- [ ] LogMonitorConfig.json をコピーし、設定で必要な場合は調整

## コンテナ化
- [ ] Dockerfile 作成
- [ ] .dockerignore ファイル作成
- [ ] SDK イメージでビルドステージを作成
- [ ] パッケージ復元用に sln、csproj、packages.config、および (該当する場合) NuGet.config をコピー
- [ ] ランタイムイメージでランタイムステージを作成
- [ ] 非ルートユーザー設定
- [ ] 依存関係処理 (GAC、MSI、COM、レジストリ、追加ファイルなど)
- [ ] ヘルスチェック設定 (該当する場合)
- [ ] 特別な要件の実装

## 検証
- [ ] コンテナ化設定を確認し、すべての要件が満たされていることを確認
- [ ] Docker ビルド成功

ステップ間で確認を待たず、アプリケーションがコンテナ化され Docker ビルドが成功するまで体系的に進めてください。

すべてのチェックボックスがマーク されるまで完了ではありません! これには Docker イメージの正常なビルドとビルドプロセス中に発生する問題の解決が含まれます。

参考資料

Dockerfile の例

Windows Server Core ベースイメージを使用した ASP.NET (.NET Framework) アプリケーション用の Dockerfile の例です。

# escape=`
# escape ディレクティブはエスケープ文字を \ から ` に変更します
# これは特に Windows Dockerfile で有効です。\ がパスセパレータだからです

# ============================================================
# ステージ 1: アプリケーションのビルドと発行
# ============================================================

# ベースイメージ - 適切な .NET Framework バージョンと Windows Server Core バージョンを選択
# 可能なタグは以下を含みます:
# - 4.8.1-windowsservercore-ltsc2025 (Windows Server 2025)
# - 4.8-windowsservercore-ltsc2022 (Windows Server 2022)
# - 4.8-windowsservercore-ltsc2019 (Windows Server 2019)
# - 4.8-windowsservercore-ltsc2016 (Windows Server 2016)
# - 4.7.2-windowsservercore-ltsc2019 (Windows Server 2019)
# - 4.7.2-windowsservercore-ltsc2016 (Windows Server 2016)
# - 4.7.1-windowsservercore-ltsc2016 (Windows Server 2016)
# - 4.7-windowsservercore-ltsc2016 (Windows Server 2016)
# - 4.6.2-windowsservercore-ltsc2016 (Windows Server 2016)
# - 3.5-windowsservercore-ltsc2025 (Windows Server 2025)
# - 3.5-windowsservercore-ltsc2022 (Windows Server 2022)
# - 3.5-windowsservercore-ltsc2019 (Windows Server 2019)
# - 3.5-windowsservercore-ltsc2019 (Windows Server 2016)
# アプリケーションをビルドするための .NET Framework SDK イメージを使用
FROM mcr.microsoft.com/dotnet/framework/sdk:4.8-windowsservercore-ltsc2022 AS build
ARG BUILD_CONFIGURATION=Release

# デフォルトシェルを PowerShell に設定
SHELL ["powershell", "-command"]

WORKDIR /app

# ソリューションとプロジェクトファイルをコピー
COPY YourSolution.sln .
COPY YourProject/*.csproj ./YourProject/
COPY YourOtherProject/*.csproj ./YourOtherProject/

# packages.config ファイルをコピー
COPY YourProject/packages.config ./YourProject/
COPY YourOtherProject/packages.config ./YourOtherProject/

# NuGet パッケージを復元
RUN nuget restore YourSolution.sln

# ソースコードをコピー
COPY . .

# 必要に応じてカスタムビルド前ステップを実行

# アプリケーションをビルドして C:\publish に発行
RUN msbuild /p:Configuration=$BUILD_CONFIGURATION `
            /p:WebPublishMethod=FileSystem `
            /p:PublishUrl=C:\publish `
            /p:DeployDefaultTarget=WebPublish

# 必要に応じてカスタムビルド後ステップを実行

# ============================================================
# ステージ 2: 最終ランタイムイメージ
# ============================================================

# ベースイメージ - 適切な .NET Framework バージョンと Windows Server Core バージョンを選択
# 可能なタグは以下を含みます:
# - 4.8.1-windowsservercore-ltsc2025 (Windows Server 2025)
# - 4.8-windowsservercore-ltsc2022 (Windows Server 2022)
# - 4.8-windowsservercore-ltsc2019 (Windows Server 2019)
# - 4.8-windowsservercore-ltsc2016 (Windows Server 2016)
# - 4.7.2-windowsservercore-ltsc2019 (Windows Server 2019)
# - 4.7.2-windowsservercore-ltsc2016 (Windows Server 2016)
# - 4.7.1-windowsservercore-ltsc2016 (Windows Server 2016)
# - 4.7-windowsservercore-ltsc2016 (Windows Server 2016)
# - 4.6.2-windowsservercore-ltsc2016 (Windows Server 2016)
# - 3.5-windowsservercore-ltsc2025 (Windows Server 2025)
# - 3.5-windowsservercore-ltsc2022 (Windows Server 2022)
# - 3.5-windowsservercore-ltsc2019 (Windows Server 2019)
# - 3.5-windowsservercore-ltsc2019 (Windows Server 2016)
# アプリケーションを実行するための .NET Framework ASP.NET イメージを使用
FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2022

# デフォルトシェルを PowerShell に設定
SHELL ["powershell", "-command"]

WORKDIR /inetpub/wwwroot

# ビルドステージからコピー
COPY --from=build /publish .

# アプリケーション用に必要な環境変数を追加 (必要に応じてコメントを外して変更)
# ENV KEY=VALUE

# MSI パッケージをインストール (必要に応じてコメントを外して変更)
# COPY ./msi-installers C:/Installers
# RUN Start-Process -Wait -FilePath 'msiexec.exe' -ArgumentList '/i', 'C:\Installers\your-package.msi', '/quiet', '/norestart'

# カスタム Windows Server ロールとフィーチャーをインストール (必要に応じてコメントを外して変更)
# RUN dism /Online /Enable-Feature /FeatureName:YOUR-FEATURE-NAME

# 追加の Windows フィーチャーを追加 (必要に応じてコメントを外して変更)
# RUN Add-WindowsFeature Some-Windows-Feature; `
#    Add-WindowsFeature Another-Windows-Feature

# 必要に応じて MSI パッケージをインストール (必要に応じてコメントを外して変更)
# COPY ./msi-installers C:/Installers
# RUN Start-Process -Wait -FilePath 'msiexec.exe' -ArgumentList '/i', 'C:\Installers\your-package.msi', '/quiet', '/norestart'

# 必要に応じてアセンブリを GAC に登録 (必要に応じてコメントを外して変更)
# COPY ./assemblies C:/Assemblies
# RUN C:\Windows\Microsoft.NET\Framework64\v4.0.30319\gacutil -i C:/Assemblies/YourAssembly.dll

# 必要に応じて COM コンポーネントを登録 (必要に応じてコメントを外して変更)
# COPY ./com-components C:/Components
# RUN regsvr32 /s C:/Components/YourComponent.dll

# 必要に応じてレジストリキーを追加 (必要に応じてコメントを外して変更)
# RUN New-Item -Path 'HKLM:\Software\YourApp' -Force; `
#     Set-ItemProperty -Path 'HKLM:\Software\YourApp' -Name 'Setting' -Value 'Value'

# 必要に応じて IIS 設定を構成 (必要に応じてコメントを外して変更)
# RUN Import-Module WebAdministration; `
#     Set-ItemProperty 'IIS:\AppPools\DefaultAppPool' -Name somePropertyName -Value 'SomePropertyValue'; `
#     Set-ItemProperty 'IIS:\Sites\Default Web Site' -Name anotherPropertyName -Value 'AnotherPropertyValue'

# 必要なポートを公開 - デフォルトでは、IIS はポート 80 を使用
EXPOSE 80
# EXPOSE 443  # HTTPS を使用している場合はコメントを外してください

# microsoft/windows-container-tools リポジトリから LogMonitor をコピー
WORKDIR /LogMonitor
RUN curl -fSLo LogMonitor.exe https://github.com/microsoft/windows-container-tools/releases/download/v2.1.1/LogMonitor.exe

# ローカルファイルから LogMonitorConfig.json をコピー
COPY LogMonitorConfig.json .

# 非管理者ユーザーを設定
USER ContainerUser

# LogMonitor を利用するようにコンテナのデフォルトエントリーポイントをオーバーライド
ENTRYPOINT [ "C:\\LogMonitor\\LogMonitor.exe", "C:\\ServiceMonitor.exe", "w3svc" ]

この例への適応

注: コンテナ化設定の特定の要件に基づいて、このテンプレートをカスタマイズしてください。

この例の Dockerfile に適応する場合:

1. YourSolution.sln、YourProject.csproj などを実際のファイル名に置き換える
2. 必要に応じて Windows Server と .NET Framework バージョンを調整
3. 要件に基づいて依存関係インストール手順を変更し、不要なステップを削除
4. 必要に応じてステージを追加または削除する

ステージ命名に関する注記

• AS stage-name 構文は各ステージに名前を付けます
• --from=stage-name を使用して前のステージからファイルをコピーします
• 最終イメージで使用されない複数の中間ステージを持つことができます

LogMonitorConfig.json

LogMonitorConfig.json ファイルはプロジェクトのルートディレクトリに作成する必要があります。このファイルは LogMonitor ツールを構成するために使用されます。LogMonitor ツールはコンテナ内のログをモニターします。ファイルの内容は、適切なログ機能を確保するために、以下と完全に一致する必要があります:

{
  "LogConfig": {
    "sources": [
      {
        "type": "EventLog",
        "startAtOldestRecord": true,
        "eventFormatMultiLine": false,
        "channels": [
          {
            "name": "system",
            "level": "Warning"
          },
          {
            "name": "application",
            "level": "Error"
          }
        ]
      },
      {
        "type": "File",
        "directory": "c:\\inetpub\\logs",
        "filter": "*.log",
        "includeSubdirectories": true,
        "includeFileNames": false
      },
      {
        "type": "ETW",
        "eventFormatMultiLine": false,
        "providers": [
          {
            "providerName": "IIS: WWW Server",
            "providerGuid": "3A2A4E84-4C21-4981-AE10-3FDA0D9B0F83",
            "level": "Information"
          },
          {
            "providerName": "Microsoft-Windows-IIS-Logging",
            "providerGuid": "7E8AD27F-B271-4EA2-A783-A47BDE29143B",
            "level": "Information"
          }
        ]
      }
    ]
  }
}