最近公司在讨论做一个ERP运维问答的论坛系统,看了很多开源系统,觉得discourse功能比较完善,灵活、可配置性非常好,部署方便,瀑布流的主题布局模式也很符合未来论坛的趋势,于是在 ucloud 上租用了云主机,成功安装了discourse 的论坛系统,期间遇到一些小困难,在很多热心朋友的的指点下都克服了,这里表示特别感谢!把安装过程整理给各位想使用discourse的朋友做些参考。
Ucloud 云主机 discourse 安装部署过程记录:
1. 环境介绍
云主机的选择了ucloud 没什么理由,算是国内比较领先的厂商之一吧,技术支持还行,晚上安装时碰到问题也有值班工程师解答;
新版本的docker的安装要求操作系统必须是64位的,我用的ubuntu14.04 64位操作系统。
安装云主机碰到的一个问题是安装完ubuntu系统后外网防火墙80端口的绑定,要使用外网IP打开主机的网站,需要绑定外网IP地址,绑定时开始没有绑定外网防火墙80端口,造成浏览器输入外网IP地址,是无法打开的。
2. 安装docker
网上有不少安装docker的教程和文章,大多都是几年前的文章,作者写的都很认真,不过已经完全不适用了,自己也走了弯路所以建议安装docker 按照安装手册里面的官方文档。ubuntu的不同版本(12.04/14.04/15.10/16.04)略有区别,手册里也说的比较清晰,针对14.04版本,没遇到什么问题,需要命令权限的命令前加sudo过程如下:
现在是2016年4月份,如果您看到这篇文章在1年以后,注意不要被我误导了,看看最新官方文档比较好。
(1)首先检查linux内核版本,ubuntu14.04 内核版本,内核版本要求3.10以上;
$ sudo uname -r
(2) 安装ca证书;为什么安装ca?
$ apt-get update
$ sudo apt-get install apt-transport-https ca-certificates
(3)追加新的Key;注意是apt-key不是apt-get
$ sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
(3)添加deb包安装源;
使用管理员权限打开(没有的话新创建这个文件)/etc/apt/sources.list.d/docker.list,添加下面内容到文件里;不同的ubuntu版本添加源有所不同,注意参照官方文档;
deb https://apt.dockerproject.org/repo ubuntu-trusty main
添加完安装源,保存文档,注意具有管理员权限才能保存;
(4)更新deb安装包索引文件,删除已经有的旧的docker(如果有),验证安装文件信息正确与否;
$ apt-get update
$ apt-get purge lxc-docker
$ apt-cache policy docker-engine
(5)安装镜像扩展文件;
$ apt-get update
$ sudo apt-get install linux-image-extra-$(uname -r)
(6)安装apparmorLinux系统安全应用程序 参考:Apparmor
$ sudo apt-get install apparmor
(7)可以安装docker了!
$ sudo apt-get update
$ sudo apt-get install docker-engine
(8)确认安装成功?
$ sudo service docker start
$ sudo docker run hello-world
3. 安装discourse
安装完docker你会觉得安装discourse是很简单的参安装文档只需要几个步骤:
mkdir /var/discourse
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
cp samples/standalone.yml containers/app.yml
说明:
*首先是创建一个目录/var/discourse;
*克隆discourse镜像到刚创建的目录;
*进入目录/var/discourse;
*复制配置文件到当前目录下的containers/
4. app.yml的配置
说到重点了,安装discourse过程中,比较容易出错的就是配置文件内容的修改;这里把
要修改的部分分别说明一下(你会用到的命令操作 nano app.yml;ctrl+x 超级啰嗦哈):
templates:
- "templates/postgres.template.yml"
- "templates/redis.template.yml"
- "templates/sshd.template.yml"
- "templates/web.template.yml"
- "templates/web.china.template.yml"
配置文件的这个部分,需要添加- "templates/web.china.template.yml";否则在./launcher bootstrap app初始化时会报错RuntimeError: ...,原因得问GWF。
## on initial signup example'user1@example.com,user2@example.com'
DISCOURSE_DEVELOPER_EMAILS: 'henry@outlook.com'
这里是开发者邮箱的设置,用于接收discoures论坛的官方邮件,只针对开发运营这个论坛的开发者。
## TODO: The domain name this Discourse instance will respond to
DISCOURSE_HOSTNAME: 'weifuwu.ren'
域名设置没设么可说的,没有的话,用绑定的外网IP地址访问discourse也可以,购买了域名可以按照指南到域名管理界面,进行设置;
DISCOURSE_SMTP_ADDRESS:smtp.mxchina.com
DISCOURSE_SMTP_PORT:25
DISCOURSE_SMTP_USER_NAME: info@weifuwu.ren
DISCOURSE_SMTP_PASSWORD: xxxxxxx
DISCOURSE_SMTP_ENABLE_START_TLS: true
DISCOURSE_SMTP_AUTHENTICATION: login
DISCOURSE_SMTP_OPENSSL_VERIFY_MODE: none
重点是在邮箱设置,我申请的阿里云邮箱
DISCOURSE_SMTP_PASSWORD: xxxxxxx设置的就是邮箱密码;
DISCOURSE_SMTP_PORT:端口设置25,
DISCOURSE_SMTP_ADDRESS:Host是smtp.mxchina.com,
DISCOURSE_SMTP_USER_NAME: 这里的设置最最重要的,这个邮箱又叫notification email 被用于发送所有重要系统邮件的邮箱地址。指定的域名必须正确设置 SPF、DKIM 和反向 PTR 记录以发送邮件。一般和域名绑定在一起,比如info@weifuwu.com 或者 admin@weifuwu.com 都行,这样收到邮件的发帖人或回复人感觉比较正式,使用这个邮箱也是最频繁的。关于SPF、DKIM设置有篇文章可参考
如果您使用的阿里云的企业邮箱,域名解析后可以不用设置 SPF、DKIM 了已经设置好了,注意阿里云这里设置DISCOURSE_SMTP_ADDRESS:smtp.mxhichina.com
5. 初始化
修改完app.yml配置文件,按照安装文档就可以进行初始化了,(耐心等待一段时间,我的云主机大概5分钟吧):
./launcher bootstrap app
启动discourse服务,就OK了!
./launcher start app
如果再次修改了配置文件也可以用:
./launcher rebuild app
试过了,这两个命令不会删除数据,放心用就行;docker的数据和容器是分离的,这是docker的优点吧。
现在应该可以登陆网站了,使用设置的域名或外网Ip地址;如果发现没有收到管理员激活邮件,也可以手动建立一个管理员账户:
./launcher enter app
rake admin:create
exit
按照提示输入邮箱和密码,exit退出容器。
最后特别提示下:管理员邮箱,也就是用rake admin:create 创建的邮箱一般用于设置论坛;DISCOURSE_SMTP_USER_NAME 邮箱用于论坛接收、发送信息给(创建主题、发帖、回复等等)使用者;DISCOURSE_DEVELOPER_EMAILS开发者邮箱用于论坛给开发运营论坛的人的官方邮件;三个邮箱作用不同,可以设置三个不同邮箱,也可以相同,开始时我真被搅的一头雾水,后来得到learnce.com 陈总指点才明白,这里再次感谢了!
以上是整个安装过程,已经成功安装。记录的时候也许会有用词不准确或者没考虑到的地方还请各位指正,再次感谢版主和热心朋友!