Docker設定手順
1. 目的
本ドキュメントはFRUCtoS配布パッケージを用いて、FRUCtoSを動作させるDocker環境を構築するための手順を説明した資料です。
本ドキュメントはソフトウェアのインストール、OSの環境設定など基本的なコンピュータ管理の知識とその操作権限をもつ方を対象としています。
また、Dockerの基本的な知識があるとより望ましいです。なお、Dockerのインス トール手順は https://docs.docker.com (docker docs)という英語のサイトを参照していただくことになります。
例としてDockerを実行環境とする場合を記載しています。 他のDocker互換のコンテナ実行環境をお使いの方は、適宜読み替えてください。 設定ファイルも適宜書き換えてください。
2. FRUCtoS用Dockerを動作させるのに必要な環境
FRUCtoSをDockerで動作させるためには、LinuxベースのDockerコンテナが必要です。OSによって利用できるDockerエンジンが異なります。
https://docs.docker.com/engine/install/ (英語)を参照すると、各OS・ディストリビューション毎に説明があるので、そちらを参考にしてインストールしてください。
インストール対象のハードウェア(仮想環境の場合はVM)には2つ以上のCPU(論理数)と4GB以上のメモリが必要です。安定した動作には4つ以上のCPUと8GB以上のメモリを推奨します。
- Windowsの場合
Docker Desktop for Windowsを使用します。管理システムを利用する場合は、v4.18.0以降のDocker Desktopをインストールしてください。FRUCtoSの動作確認ができているのはWindows10(Pro/ Enterprise)バージョン20H2以降及びWindows Server 2019以降です。 - macOSの場合
Docker Desktop for Macを使用します。管理システムを利用する場合は、v4.18.0以降のDocker Desktopをインストールしてください。FRUCtoSの動作確認ができているのはmacOS 10.14以降のIntel Macのみになります。 - Linuxの場合
Docker CEのDocker Engineを使用します。代表的なLinuxディストリビューションにはDocker CEは含まれていませんので、別途Docker CEを入手し、インストールする必要があります。また、LinuxディストリビューションによってはDocker CEと競合する別のDockerコンテナが含まれている場合があります。管理システムを利用する場合は、v23.0.1以降のDockerおよびv1.28.5以降のDocker Composeをインストールしてください。Docker CE上でFRUCtoSの動作を確認できているディストリビューションは以下のとおりです。- CentOS 7
- CentOS8 Stream
- Ubuntu 18.04 LTS (Server/Desktop)
- Ubuntu 20.04.3 LTS (Server/Desktop)
3. Dockerの構築手順
OS毎の事前設定を説明します。
3.1. Windows Server
事前設定
- Hyper-Vを使用します。「Windowsの機能の有効化または無効化」より「Hyper-V」を有効にしてください。
Hyper-VのVM上にWindows Serverを構築している場合 Hyper-Vを入れ子で使用することになります。 その場合には仮想マシン停止時に管理者権限のPowerShellで以下を設定し、仮想マシン上でもHyper-Vを利用できるようにする必要があります。
Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true
(<VMName>はHyper-Vで作成したVMの名前です)
Dockerのインストール
- Docker Desktop for Windowsのインストールパッケージを https://docs.docker.com/desktop/windows/install/
よりダウンロード(Docker Desktop Installer.exe)入手し、前記URLのドキュメントに従いインストールしてください。
- インストールが成功したらcloseボタンを押しインストーラを終了し、Docker Desktopを起動します。
- WSL2モードで起動しようとして失敗しますが、「続行」を押してください。
- 右上のウィンドウを閉じるXボタンを押して、エラーダイアログを閉じます。
- DockerDesktop画面の右上にある設定ボタンを押して設定モードにして、Generalの「Use the WSL2 based Engine」
のチェックを外してApply&Restartを押してください。Hyper-V Backendモードに切り替わり再起動されます。
Docker設定
- DockerDesktop画面の右上にある設定ボタンを押して設定モードにして、Resources AdvancedでMemoryを4.00GB以上にしてください。