社区微信群开通啦,扫一扫抢先加入社区官方微信群
社区微信群
本文将以docker为基础,搭建一套简单的应用案例。本文将假定读者已经有一定的Docker应用基础,如懂得用docker pull
下载image,懂得用docker run
运行一个container等。该案例的应用架构将采用redis的master-slave模式作为数据存储,以django为框架提供web访问,以haproxy作为负载均衡。其架构图如下.
其中App1和App2属于同一个Django的APP.
$ docker pull django
$ docker pull redis
$ docker pull haproxy
$ docker images
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
haproxy latest 46bc5babcc18 3 days ago 139.1 MB
redis latest 84dbf5edc313 4 days ago 184.8 MB
django latest 3b0bc67346a2 9 days ago 433.5 MB
# docker run -it redis /bin/bash
root@a3ca293915cb:/data# redis-server -v
Redis server v=3.2.0 sha=00000000:0 malloc=jemalloc-4.0.3 bits=64 build=5382f69a4e75566b
haproxy版本
# docker run -it haproxy /bin/bash
root@b11f07766c49:/# haproxy -v
HA-Proxy version 1.6.5 2016/05/10
Copyright 2000-2016 Willy Tarreau <willy@haproxy.org>
django版本
# docker run -it django /bin/bash
root@1daf8d846018:/# django-admin version
1.9.6
检查完后,可以用docker rm
把不用的containers删掉
# docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1daf8d846018 django "/bin/bash" 2 minutes ago Exited (0) 6 seconds ago sleepy_hypatia
b11f07766c49 haproxy "/docker-entrypoint.s" 3 minutes ago Exited (0) 2 minutes ago elegant_tesla
a3ca293915cb redis "docker-entrypoint.sh" 5 minutes ago Exited (0) 3 minutes ago stupefied_cray
# docker rm `docker ps -a | grep 'Exited' | awk '{print $1}'`
1daf8d846018
b11f07766c49
a3ca293915cb
从上,本文各版本采用如下:
service | version |
---|---|
haproxy | 1.6.5 |
django | 1.9.6 |
redis | 3.2.0 |
本案例中containers的有关启动配置如下:
container | image | service | ports | volumes | links |
---|---|---|---|---|---|
redis-master | redis | redis-server | - | master:/data | - |
redis-slave1 | redis | redis-server | - | slave1:/data | redis-master:master |
redis-slave2 | redis | redis-server | - | slave2:/data | redis-master:master |
app1 | django | django app | - | app:/data | redis-master:redis |
app2 | django | django app | - | app:/data | redis-master:redis |
haproxy | haproxy | haproxy | 6301:6301 | haproxy:/data | app1:app1 app2:app2 |
启动redis-master
在本地当前目录下创建子目录master
,并将master
挂载到container里的/data
目录。container名字为redis-master
。为了方便调试,这里同时启动交互式模式-it
,并同时打开bash
# mkdir master
# docker run -it --name redis-master -v `pwd`/master:/data redis /bin/bash
root@3d187b223f56:/data#
添加一个测试条目,取key为redis_app
,该测试条目将被app1跟app2查询:
root@3d187b223f56:/data# redis-cli
127.0.0.1:6379> set redis_app "Hello redis app!"
OK
127.0.0.1:6379> get redis_app
"Hello redis app!"
启动redis-slave1
本文案例中将采用两个redis的slave,这里首先启动第一个。container名字为redis-slave1
,同时为了方便的连接到redis master,这里直接用--link
将redis-master
container连接同时命名为master
。其实际效果相当于往/etc/hosts
添加一条记录,映射master
的域名到redis-master
的IP。通过这种方式,就不需要手工的添加master的IP,docker在启动的时候会自动添加。
# docker run -it --name redis-slave1 --link redis-master:master -v `pwd`/slave1:/data redis /bin/bash
root@cef73ae816be:/data# cat /etc/hosts
172.17.0.3 cef73ae816be
127.0.0.1 localhost
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
172.17.0.2 master 3d187b223f56 redis-master
可以看出,--link
实际上在/etc/hosts
下添加了一条新的映射,分别把redis-master
的别名master
、container ID以及container name映射到master的IP。
172.17.0.2 master 3d187b223f56 redis-master
如果没有错误,那么上面在master中设置的条目应该可以查询到:
root@cef73ae816be:/data# redis-cli
127.0.0.1:6379> get redis_app
"Hello redis app!"
启动redis-slave2
与redis-slave1同样的方式启动redis-slave2
# docker run -it --name redis-slave2 --link redis-master:master -v `pwd`/slave2:/data redis /bin/bash
root@1f22e9e15e8b:/data# cat /etc/hosts
172.17.0.4 1f22e9e15e8b
127.0.0.1 localhost
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
172.17.0.2 master 3d187b223f56 redis-master
如果没有错误,那么上面在master中设置的条目应该可以查询到:
root@cef73ae816be:/data# redis-cli
127.0.0.1:6379> get redis_app
"Hello redis app!"
启动app1
app1需要连接到redis服务,因此需要把redis-master
container连起来。同时为其创建app
目录,由于app1跟app2共享同一个Django项目,这里就不再单独为他们创建各自的目录。
# mkdir app
# docker run -it --name app1 --link redis-master:redis -v `pwd`/app/:/data django /bin/bash
root@7e6e49321993:/#
获取redis初始配置
本文采用的版本为3.2.0, 可通过如下方式获取
# wget https://raw.githubusercontent.com/antirez/redis/3.2.0/redis.conf
配置redis-master
拷贝redis.conf
到master
目录.
# cp redis.conf master/
编辑改配置文件。默认里面有非常多的配置选项,这里只需要关注几个,并改成如下:
bind 0.0.0.0
protected-mode yes
daemonize yes
logfile /var/log/redis.log
由于已经将./master
挂载到container的/data
目录,因此本地的改动在container里面也是可见的。
配置redis-slave1
拷贝redis.conf
到slave1
目录.
# cp redis.conf slave1/
编辑改配置文件。默认里面有非常多的配置选项,这里只需要关注几个,并改成如下:
bind 0.0.0.0
protected-mode yes
daemonize yes
logfile /var/log/redis.log
slaveof master 6379
最后一项slaveof
将slave1设置为master的slave。同样,由于已经将./slave1
挂载到container的/data
目录,因此本地的改动在container里面也是可见的。
配置redis-slave2
配置方式与redis-slave1
一致,因此,直接拷贝slave1/redis.conf
到slave2
目录.
# cp slave1/redis.conf slave2/
配置app1
首先需要创建Django项目,这需要登录到app1
系统中才能够调用Django命令来创建。
# docker attach app1
root@7e6e49321993:/# cd /data
root@7e6e49321993:/# django-admin startproject redisapp
root@4b8240acb25a:/data# ls
redisapp
root@4b8240acb25a:/data# cd redisapp/
root@4b8240acb25a:/data/redisapp# ls
manage.py redisapp
接下来需要编辑Django代码以支持本案例中一个简单的API:/query/
,此API将获取redis中的key为redis_app
的值(请注意,该值在上面启动redis的时候已经设置好了),并将结果返回给浏览器。由于container中大量的linux工具都没有,因此需要到主机上去编辑。app1
container将app
目录挂载进去了,因此在container中的创建的Django项目实际上在app
目录下也是可见的。
安卓redis client
由于django app需要访问redis数据库,因此需要先安装redis client
root@7e6e49321993:/data/redisapp# pip install redis
Collecting redis
Downloading redis-2.10.5-py2.py3-none-any.whl (60kB)
100% |████████████████████████████████| 61kB 123kB/s
Installing collected packages: redis
Successfully installed redis-2.10.5
编辑views.py
文件
# vim app/redisapp/redisapp/views.py
初始状态,views.py
文件并不存在,添加并编辑,内容如下:
from django.http import HttpResponse
import socket
import redis
def query(request):
r = redis.StrictRedis(host='redis', port=6379, db=0)
value = r.get('redis_app')
return HttpResponse('hello world from ' + socket.gethostname() + ', with value: ' + str(value))
编辑urls.py
文件
# vim app/redisapp/redisapp/views.py
编辑内容如下,只要是添加views.py
中定义的view函数跟url的对应:
from django.conf.urls import url
from django.contrib import admin
from redisapp.views import *
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^query/', query),
]
编辑settings.py
文件
# vim app/redisapp/redisapp/settings.py
主要是讲默认生成的redisapp
添加到INSTALLED_APPS
中,添加完后应该如下:
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'redisapp'
]
初始化数据库
在启动django程序之前,必须初始化数据库。默认情况下,采用的sqlite数据库。
root@2298dd360bbd:/data/redisapp# python manage.py migrate
Operations to perform:
Apply all migrations: admin, contenttypes, sessions, auth
Running migrations:
Rendering model states... DONE
Applying contenttypes.0001_initial... OK
Applying auth.0001_initial... OK
Applying admin.0001_initial... OK
Applying admin.0002_logentry_remove_auto_add... OK
Applying contenttypes.0002_remove_content_type_name... OK
Applying auth.0002_alter_permission_name_max_length... OK
Applying auth.0003_alter_user_email_max_length... OK
Applying auth.0004_alter_user_username_opts... OK
Applying auth.0005_alter_user_last_login_null... OK
Applying auth.0006_require_contenttypes_0002... OK
Applying auth.0007_alter_validators_add_error_messages... OK
Applying sessions.0001_initial... OK
至此,app1已经全部配置并初始化完毕。
配置app2
app2与app1共享同一个Django项目,因此不需要为app2做任何特别的配置。
配置haproxy
haproxy依赖于它的配置文件,在配置文件中必须把app1跟app2都加进去,这样haproxy就可以为他们做load balance了。
# vim haproxy/haproxy.cfg
编辑内容如下:
global
maxconn 50000
daemon
pidfile /var/run/haproxy.pid
log 127.0.0.1 local0
nbproc 4
#debug
defaults
mode http
balance roundrobin
maxconn 25000
option httplog
option abortonclose
option httpclose
option forwardfor
option redispatch
option redispatch
retries 3
timeout client 30s
timeout connect 30s
timeout server 30s
listen redis_proxy
bind :6301
mode http
stats enable
stats uri /stats
log 127.0.0.1 local0 debug
server app1 app1:8001 check inter 2000 rise 2 fall 5
server app2 app2:8002 check inter 2000 rise 2 fall 5
如果需要调试,可以吧global
中的debug
打开。特别注意的是关于app1跟app2的配置,必须跟他们启动的端口保持一致。因为在前面已经通过--link
将app
以及app2
连接进来,因此在写address:port
时候可以直接使用app1跟app2。
启动redis-master service
attach redis-master
container
# docker start redis-master
redis-master
# docker attach redis-master
root@3d187b223f56:/data#
启动service
root@3d187b223f56:/data# redis-server redis.conf
root@3d187b223f56:/data# redis-cli
127.0.0.1:6379> get redis_app
"Hello redis app!"
启动redis-slave1 service
attach redis-slave1
container
# docker start redis-slave1
redis-slave1
root@neil-centos1:hademo# docker attach redis-slave1
root@cef73ae816be:/data# redis-cli
启动service
root@cef73ae816be:/data# redis-server redis.conf
root@cef73ae816be:/data# redis-cli
127.0.0.1:6379> get redis_app
"Hello redis app!"
启动redis-slave2 service
与启动redis-slave1 service一样,这里不再赘述。
启动app1 service
attach app1
container
# docker start app1
app1
root@neil-centos1:hademo# docker attach app1
root@7e6e49321993:/#
启动service
root@7e6e49321993:/data# cd redisapp/
root@7e6e49321993:/data# python manage.py runserver 0.0.0.0:8001
Performing system checks...
System check identified no issues (0 silenced).
May 16, 2016 - 12:51:39
Django version 1.9.6, using settings 'redisapp.settings'
Starting development server at http://0.0.0.0:8001/
Quit the server with CONTROL-C.
启动app2 service
attach app2
container
docker start app2
app2
# docker attach app2
root@13d9f084c18b:/#
启动service
root@13d9f084c18b:/data# cd redisapp/
root@13d9f084c18b:/data/redisapp# python manage.py runserver 0.0.0.0:8002
Performing system checks...
System check identified no issues (0 silenced).
May 16, 2016 - 12:56:08
Django version 1.9.6, using settings 'redisapp.settings'
Starting development server at http://0.0.0.0:8002/
Quit the server with CONTROL-C.
attach haproxy
container
# docker start haproxy
haproxy
# docker attach haproxy
root@7e0f805cd85c:/#
启动service
root@7e0f805cd85c:/data# haproxy -f haproxy.cfg
[WARNING] 136/130034 (6) : Proxy 'redis_proxy': in multi-process mode, stats will be limited to process assigned to the current request.
root@7e0f805cd85c:/data#
至此,所有的service已经成功启动。可以通过uri http://<host ip>:6031/query/
访问本案例中web service。还可以通过http://<host ip>:6031/stats
来查询haproxy的统计信息。
本文中所涉及的配置以及代码可以在这个github repo找到: https://github.com/keysaim/demos/tree/master/docker-redis-django。此外,还可以访问博主的个人博客:https://keysaim.github.io。
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!