Skip to content

Latest commit

 

History

History
256 lines (184 loc) · 8.65 KB

使用docker+pelican搭建静态blog.md

File metadata and controls

256 lines (184 loc) · 8.65 KB
Raw

Title:使用docker+pelican搭建静态blog Date: 2018-01-09 10:20 Category: 工具相关 Tags: pelican,blog,docker Slug: Authors: bit4woo Summary:

为了使文章的编写和发布都更简便快捷，也为了更好得备份管理写过的东西，经过摸索，终于找到了一个自己比较满意的模式：

typora(Markdown编辑器)+github(保存备份、共享)+pelican(静态网站生成工具) +docker==》个人blog

经过一段时间的折腾，将pelican的部署和配置过程，都写到了dockerfile里，以求实现快速部署。

0x0、pelicanconf.py的配置说明

元素配置文件在这里

#!/usr/bin/env python
# -*- coding: utf-8 -*- #
from __future__ import unicode_literals

AUTHOR = u'bit4woo'
SITENAME = u"bit4woo's blog"
SITEURL = ''

PATH = 'content'

TIMEZONE = 'Asia/Shanghai'

DEFAULT_LANG = u'en'

# Feed generation is usually not desired when developing
FEED_ALL_ATOM = None
CATEGORY_FEED_ATOM = None
TRANSLATION_FEED_ATOM = None
AUTHOR_FEED_ATOM = None
AUTHOR_FEED_RSS = None

# Blogroll，友情链接
LINKS = (('re4lity', 'http://rinige.com/'),
         ('BaoBaosb', 'http://www.meijj.org/'),
         ('CF_HB', 'http://www.coffeehb.cn/'),
         ('cdxy', 'https://www.cdxy.me/'),
	 ('薇拉vera', 'http://www.zuozuovera.cn/'),
	 ('bsmali4', 'http://www.codersec.net/'),
	 ('廖新喜','http://xxlegend.com/'),
	 ('PHITHON','https://www.leavesongs.com/'),
	 ('勾陈安全','http://www.polaris-lab.com/'),
	 ('threathunter','https://threathunter.org/'),)

# Social widget，个人的一些链接和联系方式
SOCIAL = (('github', 'https://github.com/bit4woo'),
          ('email', 'mailto:[email protected]'),)
#文章列表是否分页
DEFAULT_PAGINATION = False

# Uncomment following line if you want document-relative URLs when developing
# RELATIVE_URLS = True
#主题文件路径
THEME ='./pelican-themes/bootstrap2-dark'
#插件文件路径
PLUGIN_PATHS = [u"./pelican-plugins"]
#插件名称
PLUGINS = ["sitemap"]

## 配置sitemap 插件
SITEMAP = {
    "format": "xml",
    "priorities": {
        "articles": 1,
        "indexes": 0.5,
        "pages": 0.5,
    },
    "changefreqs": {
        "articles": "monthly",
        "indexes": "daily",
        "pages": "monthly",
    }
}
#文章中静态文件的路径
STATIC_PATHS = [u"img"]

#GOOGLE_ANALYTICS的编号，这个需要自己通过google帐号去开通申请，用于收集网站的访问统计之类的信息。 
GOOGLE_ANALYTICS = 'UA-111997857-1'

0x1、dockerfile的解析说明

原始dockerfile在这里，如下是对其中的一些点进行注释说明。

FROM ubuntu:16.04

RUN sed -i 's/archive.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list
RUN apt-get update -y 

#resolve chinese coding issue
RUN apt-get install -y locales locales-all
RUN locale-gen zh_CN.UTF-8 &&\
  DEBIAN_FRONTEND=noninteractive dpkg-reconfigure locales
RUN locale-gen zh_CN.UTF-8
ENV LANG zh_CN.UTF-8
ENV LANGUAGE zh_CN:zh
ENV LC_ALL zh_CN.UTF-8

#install nginx and config web root path
RUN apt-get install -y nginx
RUN sed -i 's/\/var\/www\/html;/\/blog\/output;/g' /etc/nginx/sites-enabled/default
RUN service nginx start

RUN apt-get install -y python && apt-get install python-pip -y && apt-get install git -y
RUN pip install pelican markdown
RUN mkdir blog
WORKDIR /blog
RUN git clone https://github.com/bit4woo/code2sec.com
RUN cp /blog/code2sec.com/build/pelicanconf.py /blog/pelicanconf.py


#themes，I use bootstrap2-dark
RUN git clone https://github.com/getpelican/pelican-themes
WORKDIR /blog/pelican-themes
#RUN git submodule update --init bootstrap2-dark

#sitemap plugin
WORKDIR /blog
RUN git clone git://github.com/getpelican/pelican-plugins.git
RUN pelican code2sec.com

RUN mkdir output/theme/images -p
RUN cp /blog/code2sec.com/build/favicon.ico /blog/output/theme/images/

WORKDIR /blog/output
RUN cp /blog/code2sec.com/build/start.sh start.sh
RUN chmod +x ./start.sh
CMD ["./start.sh"]

EXPOSE 80

之前用SimpleHTTPServer、pelican.server做web容器，但是这2个服务都不够强大，容易假死。所以现在改成了nginx

0x2、快速部署

在Linux服务上快速部署的操作命令大致如下：

mkdir blog
wget https://github.com/bit4woo/code2sec.com/raw/master/build/dockerfile
docker build .
#docker build . --cache-from
docker tag b18b00c9828c bit4/blog
docker run -d -it -p 80:80 bit4/blog
#可以加上--restart=always 或者 --restart=on-failure在必要时重启

#如果服务没有正常启动，可以连接容器检测
docker exec -it container_ID_or_name /bin/bash
bash ./start.sh

0x3、文章更新

start.sh的内容如下，主要保证每次启动docker时都从github拉取最新的内容，tail -f /var/log/nginx/error.log的目的是为了保证一个前台进程阻塞IO，避免docker自动退出

#!/bin/bash
cd /blog/code2sec.com
git pull
cd ..
pelican code2sec.com
service nginx start
tail -f /var/log/nginx/error.log

0x4、关于docker的一些注意点

关于dockerfile中的cmd和start.sh的一些坑：

  • CMD ["echo","hello world"]这种格式（也就是字符串数组的格式）的实质是通过exec执行的，CMD echo hello word 这种格式的实质是 /bin/sh -c "echo hello world"执行的。

  • start.sh必须是Unix格式回车和换行符，而且shell脚本中不能少了#!/bin/bash否则会报standard_init_linux.go:195: exec user process caused "exec format error"的错误，window下可以通过notepad++来编辑start.sh并且在底部选择Unix的换行回车符。

    cmd_sh

  • 启动时的自动退出----“如果没有阻塞住stdout ，docker容器会自动退出”。启动时的自动退出的现象就是：docker run没有报错；docker ps -a 看到的状态是Exited (0)，即正常退出；通过docker logs xxx也看不到任何错误信息。

    遇到这种情况有2种解决思路：一是修改start.sh 增加阻塞stdout的命令比如

#!/bin/bash
python -m SimpleHTTPServer 80 &
#以上的写法就是错误的，&让程序在后台运行，即未阻塞stdout，正确的写法需要去掉&符号。感谢皓烟洎铭师傅的指导。

#!/bin/bash
python -m SimpleHTTPServer 80

#!/bin/bash
nohup python -m SimpleHTTPServer 80
#即以上2中方法都是可以的，不能少了“#!/bin/bash”

二是在docker run的时候，加上 -it参数和命令/bin/bash。比如 docker run -d -it bit4/test /bin/bash。加/bin/bash的作用是，在容器启动的时候运行启动一个bash，而 -it参数是在该bash下 开启标准输入和分配一个伪tty，这就相当于阻塞stdout了。（这就是为什么基础的ubuntu镜像可以正常运行而不自动退出的原因！）

 -i, --interactive                           Keep STDIN open even if not attached
 -t, --tty                                   Allocate a pseudo-TTY#分配一个伪tty
  • 交互时的自动退出

如果是docker run -d -it bit4/test /bin/bash 然后docker exec -it container_id_or_name /bin/bash的方式进入交互模式（会有2个bash），在其中执行了杀死相关的阻塞stdout的进程，也会立即导致容器的退出关闭；如果是docker run -it bit4/test /bin/bash直接入交互模式（只有一个bash），退出容器的同时容器将自动关闭，即使是加了&符合让命令在后台执行。有2个方式解决： 1.不退出容器，直接关闭宿主机的shell（SSH远程链接） 2.使用nohup + cmd +& 的格式来运行命令来阻塞stdout，然后退出容器（推荐使用这种方式）。

#在容器的交互模式中执行以下命令：
#退出容器时进程将会结束
python -m SimpleHTTPServer 80 &

#退出容器时，进程不会结束，将继续运行。在交互模式中应该这样使用。
nohup python -m SimpleHTTPServer 80 &
nohup tail -f /var/log/nginx/error.log &
  • docker启动失败的排查方法：
docker ps -a

docke logs container_id
#查看启动识别的错误信息

service docker restart
#另外，如果新安装的docker遇到端口不通，端口映射失败等问题，重启一下服务吧，遇到好几次了。

参考：

http://docs.getpelican.com/en/stable/quickstart.html#installation

http://csparpa.github.io/blog/2014/11/setup-static-blog-with-pelican.html

https://www.linuxzen.com/shi-yong-pelicanda-zao-jing-tai-bo-ke.html

https://www.cnblogs.com/cciejh/archive/2016/02/04/blog_building.html