準備

私の環境は Windows 10 Proで Docker Desktop for Windows を使用しました。使用にあたっては Hyper-VとWindowsコンテナ機能の有効化が必要になります。

Dockerを稼働するとタスクトレイにクジラのアイコンが現れます。Dockerは標準でLinuxコンテナになっているので、Windowsコンテナへ切り替えます。アイコンを右クリックして「Switch to Windows containers..」をクリックして切り替えます。

Windowsイメージの選択

Windows コンテナーの基本イメージ | Microsoft Learn

コンテナ内でバッチファイルを実行する時は注意が必要。同じwindowsでも%date%の出力がwin10(2024/01/04)とserver(Thu 01/04/2024)で異なる、といった微妙な差異があるためです。

PowerShellの利用を検討しましょう。PowerShell込のイメージもあります。私はこちらを使いました。Invoke-WebRequest や Expand-Archive といったコマンドが標準で使えるのでコンテナビルドが捗ります。

Dockerfileは下記のように書き始めます。

FROM mcr.microsoft.com/powershell:lts-nanoserver-1809

ARGとENV

Dockerfile 内での変数的なものとしてARGとENVがあります。ARGで定義した変数はビルド時のみ環境変数として参照できます。ENVで定義した変数はビルド中だけでなくコンテナ起動後も環境変数となります。

変数を参照するときは Docker内の処理であれば ${変数名} で。一方、RUNコマンドはPowerShellでの処理になるので環境変数と同様に ${env:変数名} で参照します。以下サンプルです。

FROM mcr.microsoft.com/powershell:lts-nanoserver-1809

SHELL ["pwsh.exe", "-command"]

ARG name="usagi"
ENV name2="minako"
ARG msg="Moon=${name}, Venus=${name2}."
ENV msg2="Tsukino ${name}, Aino ${name2}."
RUN Write-Output ${env:msg} | Out-File -FilePath "c:\msg.txt"
RUN Write-Output ${env:msg2} | Out-File -FilePath "c:\msg.txt" -Append

実際にコンテナを起動して各変数を見てみた結果が下記です。ENVで定義した変数はコンテナ利用時に環境変数として参照できています。

PowerShell 7.2.18   
Copyright (c) Microsoft Corporation. 

https://aka.ms/powershell
Type 'help' to get help.

PS C:\> type .\msg.txt 
Moon=usagi, Venus=minako.   
Tsukino usagi, Aino minako. 
PS C:\> ${env:msg}  
PS C:\> ${env:msg2} 
Tsukino usagi, Aino minako. 
PS C:\> ${env:name} 
PS C:\> ${env:name2} 
minako   
PS C:\>

ドライブを追加したい

単純にアプリケーションから参照する先をDドライブにするのであれば volumeコマンドを使うことで解決できますが、Dドライブにアプリケーションやデータを置いた状態をコンテナ化することはできません。

動的にドライブを追加する方法としてMS-DOS時代から存在する subst.exe という任意フォルダをドライブとして扱えるようにするコマンドを使用します。

例えば、C:\D_DRIVE というフォルダをDドライブにするには、subst.exe D: C:\D_DRIVE のようにします。

このようにして作成したDドライブに対してアプリケーションやデータを置けば、実体は C:\D_DRIVE に置かれるのでコンテナ内に収めることができます。

注意点が４つあります。

一つはベースイメージに subst.exe が含まれていないことです。ローカルPCの C:\Windows\System32 にはあるはずなので Dockerfile内から COPYコマンドを使って拝借すると良いと思います。

もう一つは Dockerfile内で RUNコマンドで subst.exe を使ったとして、その効果はそのRUNコマンドの行にとどまるということです。そのためドライブ追加に関連する処理はまとめて書く必要があります。（次の RUNコマンドでDドライブを参照するとエラーになってしまう）

RUN subst d: c:\d_drive \
    && d: \
    && mkdir app \
    :

もう一つ。コンテナ起動直後はDドライブは存在しない状態です。ですのでアプリケーションを実行する前に ENTRYコマンド や CMDコマンドで実行するスクリプト内で subst.exe によりDドライブを作成する必要があります。

最後にもう一つ。substで仮想ドライブを作成したとしても、プログラム側で特定の関数を用いることで元々のパスを取得することができます（例えばpythonであれば os.path.realpath関数を使うことで実際のパスが取得可能）。
この問題は subst以外で volumeコマンドで任意のフォルダやボリュームをDドライブとして割り当てた場合でも発生します。つまり、プログラムにドライブが存在すると見せかけることができないケースがありるということです。

プロキシを経由する場合

企業などではプロキシ経由でDockerを使わざるをえないこともありますよね。プロキシに関する記事の中から私の環境でうまくいった方法を書いておきます。（Windows 10 Pro (22H2, 19045.2965)、Docker Desktop 4.29.0 (145265)）

• Docker Desktop の Setting>Resouces>use proxy for Windows Docker daemonにチェックを入れる。Port欄はランダム値が設定されるので空欄で。
• 環境変数 HTTP_PROXY と HTTPS_PROXY を設定する。
  例）SET HTTP_PROXT=http://user:pass@192.168.0.10:8080
• コマンドラインより、docker info コマンドを実行する。HTTP Proxy: http://127.0.0.1:##### や HTTP Proxy: http://127.0.0.1:##### という項目が表示されていればOK。
• これで docker pull ～ などが使えるようになってるはず。

ビルド中に認証ありプロキシを利用する

ビルド中にアプリケーションなどを外部サイトからダウンロードすることがあります。

認証ありプロキシを経由して playframework1.7.1 をダウンロードし、c:\app\bin に展開するサンプルです。PowerShell は、WebからダウンロードするコマンドやZIP解凍するコマンドが標準で使えるで便利です。