Windows10+WSL(Ubuntu)+Docker サーバサイド開発環境

WSL(Windows Subsytem for Linux)とDocker Desktopでカンタンにサーバサイド開発環境の準備をします。

内容

• WindowsにおけるLNMP(Linux+Nginx+MySQL+Python)開発環境を構築したい
• 今どきはコンテナ型仮想化だ
• だが、未だにWSLではDockerは満足に動かない
• WSLにUbuntu18.04 LTSを入れて、Docker Desktopに接続して解決する

前提

なぜWSLなのか？

WSLを使えば強力なLinux CLI環境が簡単に導入できます。
VirtualBox等のVMよりも軽く、Cygwin,MinGW等の互換レイヤーとは違ってLinuxディストリビューションを導入できる強みがあります。

なぜDockerなのか？

年代	技術
～2004年	オンプレ
2005年～	ハードウェア仮想化(Xen)
2013年～	コンテナ型仮想化(Docker-Kubernetes)

• コンテナ型仮想化 / Dockerの歴史から紐解く、コンテナ型仮想化の「今まで」と「これから」
• Docker/ さくらのナレッジ様 - Docker入門（第一回）～Dockerとは何か、何が良いのか～
• Kubernetes/ ThinkIT - いまこそ始めよう！ Kubernetes入門

なぜDocker Desktopなのか？

WSL(Ubuntu)にDockerを入れても動作しません。
WSLが提供してないカーネルサービスを要求するためです。
WindowsでDockerを使うためにはDocker Desktopが必要です。
※2019年2月時点。WSL＋Ubuntu16.04＋Docker(17系)ならば動くようですが古いのでオススメしません。

Dockerのほか、NGINX Unitもmemfd_create()未対応で動作しません。
参考: WSLのシステムコール実装/未実装を確認する

VirtualBox+Dockerで良くないか？

Docker Desktopは仮想Linuxマシン(MobyLinuxVM)を起動し、そのマシン内でDockerを実行します。

• VirtualBox＋Docker： 仮想マシン上のLinux CLI環境＋仮想マシン上のDocker
• WSL＋Docker Desktop： WSL Linux CLI環境＋仮想マシン上のDocker

CLI環境が軽いというメリットがあります。
WSLでは提供していないカーネルサービスがあるため、動作しないソフトが多くあります。そこはDockerが解決します。

Ubuntu？

• Debian系でDockerと相性がよい
• シェア
• 今後必須となるAI/BCパッケージサポートの厚さ

Macでよくね？

(･ω･)

Docker Desktop

インストール

Docker公式からインストーラーをダウンロードして実行する

設定

Docker DesktopのdockerデーモンにWSLから接続できるようにし、ホスト(Windows)ドライブとの共有設定をおこなう。

タスクアイコン→Setting

タブ	設定名
General	Expose deamon on tcp://localhost:2375 without TLS	ON
Shared Drives	共有したいドライブレター	ON
Network	DNS Server	Fixed

WSL＋Ubuntu環境の構築

WSL(Windows Subsystem for Linux)を有効にする

1. Powershellを管理者で起動する
2. WSLを有効にする

> Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

1. Microsoft StoreからUbuntu18.04をインストールする (検索⇒Ubuntu)

Wslttyをインストールする

WSLの標準コンソールは色々と制約が多いため、WSL向けMinttyのWslttyを使う

1. Wslttyをインストールする
2. スタートメニューからConfigure WSL Shortcutsを実行する
3. 作成したショートカットからWslttyを起動する
4. 右クリック→settingから最低限の設定をおこなう。

タブ	項目	設定
text	フォント	お好みで
	ロケール	ja_JP
	文字セット	UTF-8
window	スクロール行数	60000とか
	UI言語	ja
terminal	タイプ	xterm-256color

aptの初期設定

1. WslttyまたはUbuntuを起動する
2. リポジトリを国内ミラーに変更する

$ sudo perl -p -i.bak -e 's%https?://(?!security)[^ \t]+%http://ubuntutym.u-toyama.ac.jp/ubuntu/%g' /etc/apt/sources.list

cat /etc/apt/sources.list | grep "^deb"

deb http://ubuntutym.u-toyama.ac.jp/ubuntu/ bionic main restricted
deb http://ubuntutym.u-toyama.ac.jp/ubuntu/ bionic-updates main restricted
deb http://ubuntutym.u-toyama.ac.jp/ubuntu/ bionic universe
deb http://ubuntutym.u-toyama.ac.jp/ubuntu/ bionic-updates universe
deb http://ubuntutym.u-toyama.ac.jp/ubuntu/ bionic multiverse
deb http://ubuntutym.u-toyama.ac.jp/ubuntu/ bionic-updates multiverse
deb http://ubuntutym.u-toyama.ac.jp/ubuntu/ bionic-backports main restricted multiverse universe
deb http://security.ubuntu.com/ubuntu/ bionic-security main restricted
deb http://security.ubuntu.com/ubuntu/ bionic-security universe
deb http://security.ubuntu.com/ubuntu/ bionic-security multiverse

• bionicの部分はUbuntuバージョンによって適宜読み替えてください
• securityリポジトリはデフォルトのままにしておく

1. アップデート/アップグレード

$ sudo apt -y update
$ sudo apt -y upgrade

日本語環境

1. 日本語/タイムゾーン設定

$ sudo apt -y install language-pack-ja
$ sudo update-locale LANG=ja_JP.UTF-8
$ sudo timedatectl set-timezone 'Asia/Tokyo'
$ sudo apt -y install manpages-ja manpages-ja-dev

1. Ubuntu Japanese Teamリポジトリを追加する

$ wget -q https://www.ubuntulinux.jp/ubuntu-ja-archive-keyring.gpg -O- | sudo apt-key add -
$ wget -q https://www.ubuntulinux.jp/ubuntu-jp-ppa-keyring.gpg -O- | sudo apt-key add -
$ sudo wget https://www.ubuntulinux.jp/sources.list.d/$(lsb_release -cs).list -O /etc/apt/sources.list.d/ubuntu-ja.list
$ sudo apt -y update
$ sudo apt -y upgrade

Docker

WSL(Ubuntu)にDockerをインストールする

Docker公式の手順通り

1. 開発(基本)パッケージを取得する

$ sudo apt update
$ sudo apt -y install build-essential git apt-transport-https ca-certificates curl gnupg2 software-properties-common

1. Dockerリポジトリの追加

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
$ sudo apt-key fingerprint 0EBFCD88
$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
$ sudo apt update

1. Dockerのインストール

$ sudo apt install docker-ce

1. Docker Desktopのデーモンに接続するように設定を追加

$ echo "export DOCKER_HOST=tcp://localhost:2375" >> ~/.bashrc
$ echo 'alias docker="DOCKER_HOST=${DOCKER_HOST} docker"' >> ~/.bashrc
$ source ~/.bashrc

1. Hello world実行

$ docker run --rm hello-world
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

(参考) 各コンテナの起動とコンテナ間通信

Nginx、MySQL、おまけにRedisのコンテナを実行して相互通信する例です。

Dockerネットワークの作成

コンテナ間を繋ぐネットワークを作成する

$ docker network create development-network
$ docker network ls

コンテナの取得と起動

コンテナを取得して起動する。
各コンテナの説明はDockerHubを参照すること

$ docker run -d --name nginx --network development-network -p 8080:80 nginx
$ docker run -d --name mysql --network development-network -e MYSQL_ROOT_PASSWORD=hoge mysql
$ docker run -d --name redis --network development-network redis

オプション
--name	コンテナ名
--network	コンテナネットワーク名の指定
-p	ホスト側ポート:コンテナ側ポート
-d	バックグラウンド実行(detach)

Dockerネットワークを設定することで、
例えばredisコンテナからhttp://nginx:80/のような形でnginxコンテナのNGINXにコンテナ間通信できる。

(参考) ホスト(Windows)ドライブをマウント

コンテナ起動の際、-vオプションを指定してホスト(Windows)ドライブをマウントできる

$ docker run --rm -v /c/project:/project ubuntu ls /project

オプション
-v	マウントするホスト側パス:コンテナ側パス

• ホスト側パスはDocker Desktopが解釈できるパスで記述する
• WSL(Ubuntu)ディレクトリをマウントすることはできない

次の記事

ベースイメージ	用途
NGINX Unit	APIサーバ
mysql	MySQLサーバ
redis	Redisサーバ

• 上記イメージをDockerfileを記述してビルド
• Docker Composeで取りまとめる