今回、アプリケーション制作するために、初めてDockerを使ってみて仮想環境構築したので、
自分用の備忘録として、手順を残しておこうと思います。
あくまで環境構築の手順を示したもので、しっかりした内容のものであれば他の記事を参考にされた方が良いかと思われます。
とにかく、早く環境構築したい、と思った方向けの記事です。
なぜVagrantを使うのか
仮想環境構築を共有しやすい
Windowsだと、Windowsの環境、MacではMacの環境といって環境依存されやすいというdockerの弱みを
vagrantを使って仮想マシンを構築することによって、環境に左右されない環境ができます。
うまくいかなくなっても環境をすぐぶっ壊せる
Vagrantは一度環境構築してもvagrant destroy
で仮想環境を破棄することが可能です。
何かあってもテストしやすい環境なので、とても便利です。
## 今回、参考にさせていただいたサイト
なかなかvagrantとdockerを組み合わせて使う環境構築が比較的早く済む方法が見つからず苦戦しまくりました。
やっと見つけたサイトでとても参考にさせていただいたサイトがあったためリンクを貼っておきます。
ほぼ、設定は同じですが、一部エラーが出たり、サイトがきちんと表示されずエラーとなってしまう不具合もあったため
設定を変える必要があったため、こちらの記事にどういった状況でエラーが出たのか、エラーを解決する方法を記載しました。
準備
事前知識
- ターミナル操作の基礎知識
インストール
それぞれインストール
なくてもいいがあったら便利なもの
Vagrantのプラグインインストール
ターミナルを開きコマンドを入力
vagrant plugin install vagrant-vbguest
vagrant plugin install vagrant-docker-compose
vagrant plugin list
でプラグインをインストールされているかどうか確認します
vagrant-vbguest (0.30.0, global)
vagrant-docker-compose (1.5.1, global)
作業フォルダを作成
作業したい場所に、適宜フォルダとファイルを作成します
今回は以下のように設定しました
> tree
├── vagrant
│ ├── docker-compose.yml
│ ├── Dockerfile
├___├── Vagrantfile
作成したファイルは以下のように記述して保存します。
Dockerfile
FROM python
RUN apt -y update
RUN apt install -y postgresql libpq-dev
RUN pip install psycopg2
RUN apt install -y python3-django
RUN pip install django
docker-compose.yml
version: "3"
services:
app:
build: .
image: app-img
container_name: app
ports:
- 80:80
volumes:
- /vagrant/test:/test
working_dir: /test
command: python manage.py runserver 0.0.0.0:80
restart: always
depends_on:
- db
db:
image: postgres
container_name: db
ports:
- 5432:5432
volumes:
- db-vol:/var/lib/postgresql/data
environment:
POSTGRES_USER: vagrant
POSTGRES_PASSWORD: vagrant
POSTGRES_DB: test_db
restart: always
volumes:
db-vol:
Vagrantfile
Djangoでlocalhost
接続ができないため、今回仮想環境にアクセスするためのipアドレスを設定しています
# -*- mode: ruby -*-
# vi: set ft=ruby :
# All Vagrant configuration is done below. The "2" in Vagrant.configure
# configures the configuration version (we support older styles for
# backwards compatibility). Please don't change it unless you know what
# you're doing.
Vagrant.configure("2") do |config|
# The most common configuration options are documented and commented below.
# For a complete reference, please see the online documentation at
# https://docs.vagrantup.com.
# Every Vagrant development environment requires a box. You can search for
# boxes at https://vagrantcloud.com/search.
# 軽さ優先でUbuntuにしたが、centosで実行したいなら下記に変更
# config.vm.box = "centos/7"
config.vm.box = "ubuntu/focal64"
# Disable automatic box update checking. If you disable this, then
# boxes will only be checked for updates when the user runs
# `vagrant box outdated`. This is not recommended.
# config.vm.box_check_update = false
# Create a forwarded port mapping which allows access to a specific port
# within the machine from a port on the host machine. In the example below,
# accessing "localhost:8080" will access port 80 on the guest machine.
# NOTE: This will enable public access to the opened port
# config.vm.network "forwarded_port", guest: 80, host: 8080
# Create a forwarded port mapping which allows access to a specific port
# within the machine from a port on the host machine and only allow access
# via 127.0.0.1 to disable public access
# config.vm.network "forwarded_port", guest: 80, host: 8080, host_ip: "127.0.0.1"
# Create a private network, which allows host-only access to the machine
# using a specific IP.
# localhostだとうまく作動していなかっため、IP指定
config.vm.network "private_network", ip: "192.168.33.10"
# 共有フォルダの設定
config.vm.synced_folder ".", "/vagrant", type:"virtualbox"
# 仮想マシン内のサーバーにアクセスするための設定
config.vm.network "forwarded_port", guest: 80, host: 80, host_ip: "127.0.0.1"
config.vm.network "forwarded_port", guest: 5432, host: 5432
# dockerを使えるようにする
config.vm.provision :docker
config.vm.provision :docker_compose, yml: "/vagrant/docker-compose.yml", run: "always"
# Create a public network, which generally matched to bridged network.
# Bridged networks make the machine appear as another physical device on
# your network.
# config.vm.network "public_network"
# Share an additional folder to the guest VM. The first argument is
# the path on the host to the actual folder. The second argument is
# the path on the guest to mount the folder. And the optional third
# argument is a set of non-required options.
# config.vm.synced_folder "../data", "/vagrant_data"
# Provider-specific configuration so you can fine-tune various
# backing providers for Vagrant. These expose provider-specific options.
# Example for VirtualBox:
#
# config.vm.provider "virtualbox" do |vb|
# # Display the VirtualBox GUI when booting the machine
# vb.gui = true
#
# # Customize the amount of memory on the VM:
# vb.memory = "1024"
# end
#
# View the documentation for the provider you are using for more
# information on available options.
# Enable provisioning with a shell script. Additional provisioners such as
# Ansible, Chef, Docker, Puppet and Salt are also available. Please see the
# documentation for more information about their specific syntax and use.
# config.vm.provision "shell", inline: <<-SHELL
# apt-get update
# apt-get install -y apache2
# SHELL
end
起動
Vagrantfileと同じカレントディレクトリでvagrant up
とターミナルに打ちます。
vagrant status
でrunning
と表示されていれば問題ありません。
続いてvagrant ssh
というコマンドをターミナルで叩きます。
パスワードが求められる場合、vagrant
と入力すれば接続可能です。
まずlinuxにアクセスできたら、共有フォルダに移動します。
そしてビルドします。
$ cd /vagrant
$ docker-compose build
きちんとインストールされたか確認します。
$ docker-compose run --rm app python --version
・・・
Python 3.9.4
$ docker-compose run --rm app pip --version
・・・
pip 21.1 from /usr/local/lib/python3.9/site-packages/pip (python 3.9)
プロジェクトを作成します。
docker-compose run --rm app django-admin startproject sample_app
ここで、おかしな点が出てきます。
原因がよくわかっておりません。
> tree
├── vagrant
│ ├── docker-compose.yml
│ ├── Dockerfile
├___├── Vagrantfile
├___├── test
├___├── ├── sample_api
├___├── ├── ├── sample_api
├___├── ├── ├── manage.py
testの下にsample_apiが二つできています。
このsample_apiを下記のようにディレクトリを調整します。
ターミナルでコマンド操作してもいけますが、共有フォルダの設定になっているので
ホスト側の作業用フォルダからでも編集はいけます。
> tree
├── vagrant
│ ├── docker-compose.yml
│ ├── Dockerfile
├___├── Vagrantfile
├___├── test
├___├── ├── manage.py
├___├── ├── sample_api
sample_api
にある、settings.py
のDATABASESを下記のように編集します。
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql_psycopg2',
'NAME': 'test_db',
'USER': 'vagrant',
'PASSWORD': 'vagrant',
'HOST': 'db',
'PORT': '',
}
}
さらに、ALLOWED_HOSTS
を下記のように編集します。
ALLOWED_HOSTS = ['192.168.33.10']
設定が終わりましたら、マイグレーションを実行します。
※マイグレーションした後にdbの設定を書き換えるとエラーが出てしまいます。
dockerを作り直す必要が出てくるため、注意が必要です。
DjangoでPostgreSQLのパスワード認証が通らない
docker-compose run --rm app python manage.py migrate
docker-compose up -d
http://192.168.33.10
にアクセスするとDjangoの画面が表示されます。
終了する時
ssh接続を切るためにターミナルからexit
を入力してvagrant halt
とすると終了できます。