開発環境を構築する中でデータベースは必ずと言ってもいいくらい必要になります。
WSL2のディストリビューションにDockerを入れると
とても簡単に短時間で安定したデータベース利用環境を構築することができたので、
今回は以前投稿したWSL2を利用したLinux開発環境にDockerをインストールして
データベースの環境を構築した際の手順をご紹介いたします。
構築するデータベースとしてはRDBの例としてMySQL、NoSQLの例としてRedisを構築していきます。
- MySQL
- Redis
前提条件
以下の記事に従ってWSL2を利用したLinux開発環境の環境が構築されていること。
実施環境
- OS：Windows 10 Home バージョン 21H1
- ディストリビューション：Ubuntu 20.04 LTS
(推奨)作業用ターミナルとしてはWindowsターミナルの使用をお勧めします。
Dockerのインストール
Dockerのインストール手順についてはdocker docsに手順が記載されているので、
基本的にはdocsの手順に従いインストールを進めていきます。
Docker Engine インストール
リポジトリのセットアップ
1. aptパッケージの更新
sudo apt-get update
sudo apt-get install \
ca-certificates \
curl \
gnupg \
lsb-release
2. GPG 鍵の追加
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
3. 安定版（stable）リポジトリのセットアップ
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
インストール
1. aptパッケージの更新
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
Linux インストール後の作業
Docker管理のユーザ追加
ログインユーザにdockerコマンドの実行権限を付与してsodo無しでコマンド実行できるようにします。
1. dockerグループの作成
sudo groupadd docker
2. グループへのユーザ追加
sudo gpasswd -a $USER docker
※ docker docsではusermodコマンドを利用してグループ追加を行っていますが、破壊的なコマンドのため、ここではgpasswdコマンドを利用してユーザ追加を行います。
Docker自動起動設定
WSLを起動するたびにDockerを起動するのはとても煩わしいので自動起動設定を行います
serviceコマンドのsudo権限追加
visudoを使いsudoersファイルを更新してログインユーザにsudo権限を追加します。
1. visodo起動
sudo visudo
2. Dockerデーモン起動設定追記
最後の行に以下の設定を追加します。
※ XXXXXX部はユーザ名に置き換える
XXXXXX ALL=(ALL:ALL) NOPASSWD: /usr/sbin/service docker start
- 入力例
3. 保存
3.1. 編集終了
メニューに従い次のコマンドを入力して編集を終了します。
[Ctrl] + [X]
- 表示メニュー
3.2. 確認
メニューに従い次のコマンドを入力して設定を保存します。
[Y]
- 表示メニュー
3.3. 終了
ファイル名はそのままに次のコマンドを入力して保存します。
[Enter]
- 表示メニュー
Dockerデーモン起動設定
.bashrcの最後の行に以下の設定を追加します。
- .bashrcの編集
vi .bashrc
- 設定
if [ $(service docker status | awk '{print $4}') = "not" ]; then
sudo service docker start > /dev/null
fi
設定反映
コマンドプロンプトを起動して次のコマンドを入力してwslをシャットダウンします。
wsl --shutdown
再度wslにログインすることでDockerデーモンが自動で起動しsudo無しでdockerコマンドが実行可能となります。
Dockerイメージの取得
Dockerイメージを取得してデータベース環境を構築していきます。
以下の手順ではイメージはDocker Hubより取得します。
Docker Hubにはイメージ取得(Pull)の回数制限があるため、
同一IPアドレス環境内でイメージ取得が頻繁に行われている場合、
上限に達している可能性があります。
その際にはDocker Hubに登録したユーザーでログインした上で実施する必要があります。
(無料ユーザでも可)
Redis環境構築
イメージ取得
次のコマンドを実行してRedisのイメージを取得します。
docker pull redis
イメージ起動
次のコマンドを実行してRedisのイメージを起動します。
docker run -it --name redis -d -p 6379:6379 redis:latest
コンテナ自動起動設定
次のコマンドを実行することでWSLを再起動した際にコンテナが自動で起動します。
docker update --restart=always redis
Redisコマンドラインインタフェースインストール
Redisのコマンドラインインタフェースであるredis-cliをインストールします。
redis-cliインストール
次のコマンドを実行してredis-cliをインストールします。
sudo apt install redis-server
接続確認
次のコマンドを実行して接続を確認します。
redis-cli
127.0.0.1:6379に接続され対話モードでCLI実行可能となれば構築完了です。
MySQL環境構築
イメージ取得
次のコマンドを実行してMySQLのイメージを取得します。
docker pull mysql
イメージ起動
次のコマンドを実行してMySQLのイメージを起動します。
docker run -it --name mysql -e MYSQL_ROOT_PASSWORD=mysql -d -p 3306:3306 mysql:latest
コンテナ自動起動設定
次のコマンドを実行することでWSLを再起動した際にコンテナが自動で起動します。
docker update --restart=always mysql
MySQLクライアントインストール
MySQLのクライアントをインストールします。
コマンド確認
次のコマンドを実行することでMySQLクライアントのインストールを促されます。
mysql
※ 2022年2月時点では次のコマンドが表示されます。
sudo apt install mysql-client-core-8.0 # version 8.0.27-0ubuntu0.20.04.1, or
sudo apt install mariadb-client-core-10.3 # version 1:10.3.32-0ubuntu0.20.04.1
インストール
次のコマンドを実行してMySQLクライアントをインストールします。
sudo apt install mysql-client-core-8.0
接続確認
次のコマンドを実行して接続を確認します。
mysql -u root -p -h 0.0.0.0 -P 3306
接続に成功し対話モードでCLI実行可能となれば構築完了です。
参考
-
docker docs
-
docker hub