码厩技术博客

#185 Nginx 连接处理方法

Syntax: use method;
Default: —
Context: events

Specifies the connection processing method to use. There is normally no need to specify it explicitly, because nginx will by default use the most efficient method.

Nginx 默认会自动选择当前平台最高效的方法。

• epoll Linux 平台上的最佳选择
• kqueue BSD 家族（包括 MacOS）的最佳选择
• poll 第一备选
• select 第二备选
• eventport Solaris 提供的机制，但是 Nginx 文档上建议使用 /dev/poll
• /dev/poll

我们接触多的是 Linux 服务器，所以知道是 epoll 就行了。
除非你非常知道自己在做什么，不要调整 use 参数。

以下参数可以控制相关模块的引入：

--with-poll_module
--without-poll_module
--with-select_module
--without-select_module

#184 勇敢者的游戏

1. 勇敢者的游戏 Jumanji
2. 勇敢者的游戏 2：太空飞行棋
3. 勇敢者游戏：决战丛林
4. 勇敢者游戏 2：再战巅峰

Jumanji

莎拉 展翅飞得高，白天看不到，晚上来追杀，赶紧把命逃
     # 吸血蝙蝠
艾伦 身陷丛林难回家，色子要等五或八
朱迪 它个子最小，咬一下起个包，能让你昏迷发高烧
     # 大蚊子
皮特 这段任务很艰难，红毛长尾阻你向前
     # 猴子
皮特 头大体胖牙齿尖，用你来个大会餐，腿短胆小命难保
     # 狮子

莎拉 长得又快又急促，小心别让它抓住
     # 食人花
艾伦 野蛮猎人一出现，鲁莽射击不留人
     # 范培特
朱迪 打雷没什么，不要被迷惑，按兵不动，必成大祸
     # 动物大迁徙
皮特 游戏规则被破坏，往后倒退一大块
     # 皮特作弊变猴子

莎拉 每月一逢台风到，大雨滂沱起浪潮
     # 暴雨
艾伦 陷阱就在你脚下，地板瞬间变流沙
     # 流沙
朱迪 有个教训宜记取，后退一步有转机
     # 流沙消失，地板凝固
皮特 除了具有山核桃，我们还有八只手
     # 蜘蛛

莎拉 紧要关头目标近，地牛翻身陷困境
     # 地震
艾伦 Jumanji （赢了，游戏结束）

#183 Supervisor 进程守护

子命令

• help
• help <action>
• add <name> […]
• remove <name> […]
• update
• update all
• update <gname> […]
• clear <name>
• clear <name> <name>
• clear all
• fg <process>
• pid
• pid <name>
• pid all
• reload
• reread
• restart <name> 不会重新加载配置文件
• 如果配置有更新，应该 reread 一下
• 如果有 section 增删，还应该 update 一下
• restart <gname>:*
• restart <name> <name>
• restart all
• signal
• start <name>
• start <gname>:*
• start <name> <name>
• start all
• status
• status <name>
• status <name> <name>
• stop <name>
• stop <gname>:*
• stop <name> <name>
• stop all
• tail [-f] <name> [stdout|stderr] (default stdout)

#182 Werkzeug WSGI 框架

• PyPI：https://pypi.org/project/Werkzeug/
• 文档：https://werkzeug.palletsprojects.com/en/latest/
• 代码：https://github.com/pallets/werkzeug/

示例

from werkzeug.wrappers import Request, Response
from werkzeug.routing import Map, Rule

class Application:
    def __init__(self):
        self.url_map = Map([
            Rule('/', endpoint='hello')
        ])

    def hello(self, request):
        text = 'Hello, World!'
        response = Response(text, content_type='text/plain')
        return response

    @Request.application
    def __call__(self, request):
        adapter = self.url_map.bind_to_environ(request.environ)
        endpoint, values = adapter.match()

        handler = getattr(self, endpoint)
        return handler(request, **values)

if __name__ == '__main__':
    from werkzeug.serving import run_simple
    app = Application()
    run_simple('localhost', 5000, app)

Werkzeug 与协程（async/await）

Werkzeug 1.x 开始已经提供了对协程的支持。
PS：WSGI 规范是基于同步的设计，没有较好的适配异步编程，所以后面一些更年轻的框架选择了 ASGI（Async Server Gateway Interface）。
PS：2014/03/01, WSGI
PS：2021/11/06, 体验 ASGI

import asyncio
from werkzeug.wrappers import Request, Response
from werkzeug.routing import Map, Rule

class Application:
    def __init__(self):
        self.url_map = Map([
            Rule('/', endpoint='hello')
        ])

    async def hello(self, request):
        text = 'Hello, World!'
        response = Response(text, content_type='text/plain')
        return response

    @Request.application
    async def __call__(self, request):
        adapter = self.url_map.bind_to_environ(request.environ)
        endpoint, values = adapter.match()

        handler = getattr(self, endpoint)
        response = await handler(request, **values)
        return response

if __name__ == '__main__':
    from werkzeug.serving import run_simple
    app = Application()
    run_simple('localhost', 5000, app)

附：版本历史

#181 The Pallets Projects

这个组织下的每个项目单拿出来都是响当当的存在：

• Click — Beautiful, composable command line interface creation kit.
• Flask — a flexible and popular web development framework
• ItsDangerous — Safely pass trusted data to untrusted environments and back.
• Jinja — a full featured template engine for Python
• MarkupSafe — Safely add untrusted strings to HTML/XML markup.
• Quart — an async reimplementation of flask
• Werkzeug — The comprehensive WSGI web application library.

• Click 命令行工具
• Flask 轻量级 Web 框架
• ItsDangerous
• Jinja 知名模板库
• MackupSafe
• Quart
• Werkzeug Web 工具箱（WSGI），Flask 的底层

#180 不加 sudo 执行 Docker 命令

因为公司组织培训 Docker，为了更好参与课程，我提前一周开始预习 Docker 技术。

安装 Docker 之后，首次执行 docker info 时接到错误信息：“Cannot connect to the Docker daemon. Is the docker daemon running on this host?”。
当时，我再三确认了 Docker 服务运行状态，确实没有任何问题，傻眼了。
之后，加上 sudo 试试才运行正确。

#179 计量单位

国际单位制

基本单位

国际单位制词头

时间单位

• 天 d day
• 小时 h hour
• 分 m minute
• 秒 s second
• 毫秒 ms millisecond
• 微妙 us microsecond
• 纳秒 ns nanosecond

长度单位

长度的基本单位是米，标准是光在真空中 $1 / 299792458$ 秒内运动的距离。

市制

毫厘分寸尺丈

依据民国 18 年（1929 年）《度量衡法》。
1959 年《统一公制计量单位中文名称方案》基本沿用《度量衡法》，只是单位前面加一个 市 字，另外没有列出引、毫。

 1 米   = 3 尺
10 米   = 3 丈
 1 公里 = 2 里

1 里 =  15 引 = 150       丈 = 500 米
1 引 =  10 丈 =  33.333   米
1 丈 =  10 尺 =   3.333   米
1 尺 =  10 寸 =   0.333   米
1 寸 =  10 分 =   0.333 分米
1 分 =  10 厘 =   0.333 厘米
1 厘 =  10 毫 =   0.333 毫米
         1 毫 =   0.033 微米 = 33.333 微米

天文单位

我知道的四个不属于国际单位制的天文学常用单位：

1. 光秒, Light Second, ls, 299792458 m, 约等于 30 万公里
   PS: 换算成公制单位，1 ls ≈ 0.3 Gm (吉米)
2. 光年, Light Year, ly, 大约等于 $9.46 × 10^{18}$ km (9.46 千亿公里)
   $$
   365.25 × 86400 = 31557600 \
   × 299792458 = 9460730472580800
   $$

3. 天文单位, Astronomical Unit, au, 日地平均距离（地球和太阳之间距离的平均值）
   2012 年国际天文学大会 IAU 将其固定为 149,597,870,700 m, 也就是 1 AU ≈ 1.5 亿公里 ($10^{9}$)。
   PS: 换算成公制单位，1 au ≈ 149.6 Gm (吉米)
   PS: 1 au ≈ 499 ls，也就说光从太阳到地球大概需要 499 秒左右（8 分多钟）。
   PS: 作为参考: 月地距离 $3.844 × 10^{5}$ km 约等于 2.57 ‰ au; 太阳半径 $6.955 × 10^{5}$ km 约等于 4.65 ‰ au (太阳半径 = 1.81 月地距离)

4. 秒差距, Parsec, pc, 通过时差来表示天文距离
   如果地球和太阳的连线，地球和另一个天体的连线，成 89 度角，那么太阳和这个天体之间的距离为 1 pc
   PS: 视察越大距离越近，视察越小距离越远

示例图（非等比例绘制）：

根据三角函数的计算，

$$
1 pc = \frac {1 au} {tan 1}
= \frac {1 au} {\frac {1} {360} × \frac {π} {180}}
= \frac {648000} {π} au
$$

约等于 206265 au, 或者 3.26 ly，或者 $3 × 10^{13}$ km (三万亿公里)。

英制

暂无更多信息。

面积单位

平方十米 $dam^{2}$, 平方百米 $hm^{2}$, 平方千米 $km^{2}$ ...
平方米 $m^{2}$，平方分米 $dm^{2}$，平方厘米 $cm^{2}$ ...

市制

毫厘分亩顷

1 顷 = 100 亩 = 600000 平方尺 = 66666.666 平方米
1 亩 =  10 分 =   6000 平方尺 =   666.666 平方米
1 分 =  10 厘 =    600 平方尺 =    66.666 平方米
1 厘 =  10 毫 =     60 平方尺 =     6.666 平方米
         1 毫 =      6 平方尺 =     0.666 平方米

公顷

1 平方米 =     9 平方尺
1 公顷   =    15 亩
         = 90000 平方尺
         = 10000 平方米
1 平方尺 =   100 平方寸
         =   1/9 平方米

英制

暂无更多信息。

体积单位

立方厘米，立方米...

不属于国际单位制的体积单位是：

1. 升, liter, L, $\frac {1} {1000} m^3$

市制

重量单位

物理学上，叫做质量。

1. 吨 = 1000 kg
2. 千克，公斤，kilogram
3. 克，gram

市制

1 担 = 100 斤 = 50   公斤
1 斤 =  10 两 =  0.5 公斤
1 两 =  10 钱
1 钱 =  10 分
1 分 =  10 厘

PS: 29 年的《度量衡法》中 1 斤 = 16 两，而 59 年的《统一公制计量单位中文名称方案》则是 1 斤 = 10 两。

英制

暂无更多信息。

信息计量单位

这里需要特别说明的是国际单位制是十进制的，而 IT 界一般遵循二进制的计量方式（IEC 60027-2）。

#178 Shell 重定向

command >output.txt         # 把标准输出重定向到一个文件中
command >> output.txt           # 把标准输出重定向到一个文件中(追加)

command 1>output.txt        # 把标准输出重定向到一个文件中
command 1>>output.txt        # 把标准输出重定向到一个文件中(追加)

command 2>output.txt        # 把标准错误重定向到一个文件中
command 2>>output.txt           # 把标准错误重定向到一个文件中(追加)

command >output.txt 2>&1    # 把标准输出和标准错误一起重定向到一个文件中
command >>output.txt 2>&1       # 把标准输出和标准错误一起重定向到一个文件中(追加)

command <input.txt              # command命令以output.txt文件作为标准输入
command <input.txt >output.txt  # command命令以output.txt文件作为标准输入, 以 output.txt 文件作为标准输出

# 从标准输出中读入，直至遇到delimiter分界符（不能与已存在的文件重名）
command << delimiter

command <&m  把文件描述符m作为标准输出
command >&m  把标准输出重定向到文件描述符m中
command <&-  关闭标准输入

#177 Linux date 命令

示例

# %c 表示当前 locale 的日期和时间
$ date +%c
2017年01月02日 星期一 12时00分00秒

# 获取当前时间戳
$ date +%s
1483329600
# -d 表示使用指定时间，而非默认的当前时间
# 获取指定时间的时间戳 (时间字符串 -> 时间戳)
$ date +%s -d "2017/01/01 00:00:00"
1483200000
# @ 表示时间戳
# 时间戳 -> 时间字符串
$ date -d @1483200000  # 等于: date --date="@1483200000"
2017年 01月 01日 星期日 00:00:00 CST
$ date -d @1483200000 +%c
2017年01月01日 星期日 00时00分00秒

# -u 表示使用 UTC 时间
$ date -u
2017年01月02日 星期一 14时00分00秒 UTC
$ date -d @1483200000 -u
2016年 12月 31日 星期六 16:00:00 UTC

$ date +%Y%m%d%H%M%S
20170102120000

# -R, --rfc-email, RFC 5322 格式
$ date -R
Mon, 02 Jan 2017 12:00:00 +0800

$ date --rfc-3339=date     # 可以缩写成 d
2017-01-02
$ date --rfc-3339=seconds  # 可以缩写成 s
2017-01-02 12:00:00+08:00
$ date --rfc-3339=ns       # 可以缩写成 n
2017-01-02 12:00:00.000000000+08:00

常见日期格式占位符

• Y 年，4 位数字
• m 月，2 位数字
• d 日，2 位数字
• H 时，2 位数字
• M 分，2 位数字
• S 秒，2 位数字
• F 完整日期, 等于 %Y-%m-%d
• T 完整时间, 等于 %H:%M:%S
• R 等于 %H:%M

#176 大冲撞（Collision）