你的位置:首页 > ASP.net教程

[ASP.net教程]使用coding、daocloud和docker打造markdown纯静态博客


说起独立博客的技术演变,从数据库到纯文本放git是一大进步,从HTML到markdown又是一大进步。

解析技术有没有进步呢?既然markdown是纯文本了,再用PHP/Python/Ruby去实时解析,多么多此一举啊(比如github用的Jekyll),还需要配置服务器环境。如果用shell把markdown转换成HTML,生成纯静态博客多么愉快,无需服务器,直接放到云存储CDN上,飞快!

先看疗效!openwrt.io就是这么一个纯静态网站,网址:http://openwrt.io/,代码在coding上:https://coding.net/u/openwrtio/p/portal/git。

openwrt.io

打造这么一个酷炫的博客需要几步?

只需要两步,比把大象放进冰箱里还要简单^_^

第一步:把代码提交coding

注册登录 coding.net,fork或创建一个项目,比如blog,代码:https://coding.net/u/openwrtio/p/portal/git/tree/1.0.0/,修改其中的docs/index.md即为博客首页,然后提交,打tag(比如0.1.0),push。指令如下:

git clone xxxcd xxxwget -O blog.zip https://coding.net/u/openwrtio/p/portal/git/archive/1.0.0unzip blog.ziprm blog.zipecho "Hello! 树先生" > docs/index.mdgit add .git commit -m 'first commit'git push origin mastergit tag -a 0.1.0 -m 'first commit'git push --tags

 

第二步:使用daocloud自动构建和部署

打开daocloud.io,创建一个项目,“设置代码源”为刚才提交coding的项目即可,将触发自动构建。等待构建完成,即生成了一个debian系统镜像,点“查看镜像”——》“部署”——》“基础设置”——》“立即部署”,即可。daocloud会赠送一个子域名,访问即可看到博客已经跑起来了。建议购买一个自己的域名,CNAME绑定即可,比如dnspod域名注册服务。

daocloud build-flows newdaocloud build-flows success openwrtio-portaldaocloud runtimes-app

构建的过程为什么这么漫长?

请看这个文件: https://coding.net/u/openwrtio/p/portal/git/blob/1.0.0/Dockerfile

FROM nginxMAINTAINER sinkcup <sinkcup@163.com>RUN apt-get update -qqRUN apt-get upgrade -yRUN apt-get install -y python-pipRUN pip install mkdocsRUN mkdir -p /usr/share/nginx/html/portalADD . /usr/share/nginx/html/portal/RUN cd /usr/share/nginx/html/portal/ && \ mkdocs build RUN rm -f /etc/nginx/conf.d/* ADD nginx/conf.d /etc/nginx/conf.d/

 

可以看到每次构建都需要apt-get升级、安装环境、安装mkdocs,最后用mkdocs生成HTML。前面几个步骤每次都一样,那就想办法重用即可。

Dockerfile改成两个,一个是每次都不变的服务器环境:

FROM nginxMAINTAINER sinkcup <sinkcup@163.com>RUN apt-get update -qqRUN apt-get upgrade -yRUN apt-get install -y python-pipRUN pip install mkdocsRUN cd /usr/share/nginx/html/ && \ mkdocs new demoRUN cd /usr/share/nginx/html/demo && \ mkdocs buildRUN rm -f /etc/nginx/conf.d/*ADD nginx/conf.d /etc/nginx/conf.d/

 

我把它提交到了github(https://github.com/sinkcup/docker-library-nginx-mkdocs),然后注册登录docker.com,创建一个项目,选择来自github的代码(https://registry.hub.docker.com/u/sinkcup/nginx-mkdocs/),构建成功,生成的镜像是 sinkcup/nginx-mkdocs:0.1.0

daocloud的Dockerfile里直接使用这个docker镜像即可,从此构建飞快!代码如下:

FROM sinkcup/nginx-mkdocs:0.1.0MAINTAINER sinkcup <sinkcup@163.com>ADD . /usr/share/nginx/html/portalRUN cd /usr/share/nginx/html/portal/ && \ mkdocs build RUN rm -f /etc/nginx/conf.d/* ADD nginx/conf.d /etc/nginx/conf.d/

 

完整代码在 https://coding.net/u/openwrtio/p/portal/git/tree/1.1.0/,这是一个开源项目,欢迎fork一起协作。

mkdocs文档在:http://www.mkdocs.org/