外面天黑了,而我正坐在电脑前发呆,努力尝试想起来某个文件的路径到底是什么。
脑袋开始混沌走神——我是怎么走到这一步的?我本来是要做什么来着?
想起来了。最初的问题,是 iCloud 空间不大够用来着。
……但是怎么变成现在这样了呢?
大概是“吾不识青天高,黄地厚;唯见月寒日暖,来煎人寿”吧。
从给 Github 库瘦身开始
iCloud 空间不大够用,我打算把不常用的文件挪到 NAS 上去。整理文件时,发现有两个文件夹异常巨大:一个是用来存放和生成 Blog 的文件夹,另一个是存放课程幻灯片的。
Blog 是用 Hugo 生成的静态网站,幻灯片是基于 impress.js 设计的一组网页和资源。这两个文件夹都有自己的 Github 仓库,而且幻灯片文件夹还作为子模块引入了 Blog 仓库。我使用 Github Pages 托管 Blog,把我的域名 yemengma.cn 指向了这个仓库,所以可以通过域名访问 Blog 和幻灯片。
因为是和 Github 同步,所以这两个文件夹下都有用来记录历史的 .git 文件夹;而因为幻灯片作为子模块引入了 Blog 仓库,所以幻灯片的历史也被完整保存在 Blog 仓库中。
这样一来,幻灯片文件夹本身的文件大概有 1G 左右,加上 .git 就有了 2G;而 Blog 仓库里存了一份幻灯片文件夹,还有相应的两份 .git 文件夹,平白多占用了 3G 空间。
本来这也不是什么大问题,几个 G 的空间也不算多……但是问题是我的 iCloud 只有 50G。让重复没用的文件占了 6%,这还能忍?
于是改吧。
所以总结一下, 情况大概是这样:
hugo-site/
├── content/
├── public/
│ └── slides/ # 幻灯片文件夹作为子模块引用
└── themes/
这种结构带来了几个问题:
- 幻灯片仓库被完整引入 Blog 仓库;
- 更新时需要同步子模块;
- 主仓库和子模块各自的 .git 文件夹都保存了完整历史;
所以解决方案也就很清晰了:
- 将幻灯片从 Blog 中完全分离;
- 重命名幻灯片仓库的主分支为 gh-pages,用 Github Pages 发布;
- 删除远程主分支,重新设置分支追踪;
- 设置域名解析,指向新的幻灯片地址;
第一步好办,删几个文件夹而已;第二步第三步也无非几个命令。
cd /path/to/slides
git branch -m main gh-pages
git push origin gh-pages
git push origin --delete main
git branch -u origin/gh-pages
删文件令人心情舒畅。修改完的结构如下:
/path/
├── hugo-site/ # Blog 内容
└── slides/ # 独立的幻灯片内容
第四步要去阿里云上设置域名解析。打开了多年没有登录的阿里云,找到域名解析,添加一条新的 CNAME 记录,把 slides.yemengma.cn 指向 mammoth2008.github.io……
然后想起来,我的这个域名一直没备案。
那就顺手备一个吧。
备案需要服务器
网站备案需要域名和服务器,而我没有服务器——Github 非常良心地提供了免费服务。
所以租了低配的阿里云服务器,有 2 核 CPU、2G 内存、3M 带宽,运行 Ubuntu 20.4,第一年租金不到 100 块。看见域名很便宜,也顺手买了个新域名 lifeplayer.club(目前备案没完成,无法访问),把 lifeplayer.club、www.lifeplayer.club、slides.lifeplayer.club 都解析到这个服务器的 IP 地址。
浪费计算资源是要遭天谴的。于是把 Blog 和幻灯片都同步到服务器上,用 Nginx 配置两个站点,这样在国内访问的速度就会快很多——毕竟 Github 在国内的访问速度比较随机。
先安装 Hugo 和 Nginx。
sudo apt Update
sudo apt install hugo
sudo apt install nginx
然后把文件复制到云服务器上:
rsync -avz /local/hugo-site/ root@IPAddress:/home/admin/hugo-site/
rsync -avz /local/slides/ root@IPAddress:/home/admin/slides/
再写个 Nginx 配置文件:
# Blog 主站配置
server {
listen 80;
server_name lifeplayer.club www.lifeplayer.club IPAdress;
root /home/admin/hugo-site/public;
index index.html;
error_page 404 /404.html;
location / {
try_files $uri $uri/ =404;
}
location /slides {
alias /home/admin/slides;
try_files $uri $uri/ =404;
}
}
# slides 子域名配置
server {
listen 80;
server_name slides.lifeplayer.club;
root /home/admin/slides;
index index.html;
error_page 404 /404.html;
location / {
try_files $uri $uri/ =404;
}
}
应用配置,重启 nginx 就行了。
sudo ln -s /etc/nginx/sites-available/hugo /etc/nginx/sites-enabled/
sudo systemctl enable nginx
sudo nginx -t
sudo systemctl restart nginx
人总是能懒则懒的
所以总结一下,现在我修改完文件后,除了要提交到 Github 上之外,还要同步到云服务器上。
嗯……所以更新一下部署脚本吧。
以前我有一个部署脚本,用来在更新文件后提交到 Github 上。现在既然要改,不妨改大一点。除了更新 Github 和云服务器上的内容外,还要考虑特殊文件的处理,以及 Blog 在服务器上的重新生成。要尽量模块化,参数化,安全性也要增强一些。
改进后的部分脚本如下:
#!/bin/bash
check_git_status() {
if [ -n "$(git status --porcelain)" ]; then
info "检测到未提交的更改"
git add .
git commit -m "Update: $(date '+%Y-%m-%d %H:%M:%S')"
fi
local_commit=$(git rev-parse HEAD)
remote_commit=$(git rev-parse @{u})
if [ "$local_commit" != "$remote_commit" ]; then
info "推送本地更改到远程仓库"
git push || error_exit "推送失败"
fi
}
sync_to_server() {
info "开始同步到服务器"
rsync -avz --exclude '.git*' \
--exclude 'config.toml' \
--exclude 'public/' \
--exclude 'layouts/partials/language-selector.html' \
./ root@IPAddress:/home/admin/hugo-site/ || error_exit "同步失败"
success "同步完成"
}
main() {
check_git_status
sync_to_server
if [[ "$0" == *"deploy-blog"* ]]; then
ssh root@IPAddress "cd /home/admin/hugo-site && hugo"
fi
}
main
重启能解决 90% 问题
这次的“小问题”最终演变成了网站架构调整。现在的方案有几个明显改进:
存储更合理了。因为删除了重复的文件和历史记录,为 Blog 和幻灯片分别建立了独立的仓库,所以 iCloud 空间节省了约 5G。仓库结构更清晰,便于维护。
访问更便捷了。国内用户通过阿里云服务器快速访问,解决了相当大的问题。另外,依然保留 GitHub Pages 作为备用入口,也通过子域名让资源组织更清晰。
部署更高效了。使用自动化脚本处理了大部分重复工作,也有了更完善的错误处理。省去了许多重复操作。
还有点意外收获。重新捡起来了一点 Ubuntu 操作系统的用法——本来都已经忘差不多了。重新考虑网站架构,未来的扩展也很容易。
Edsger W. Dijkstra(那个著名图算法的发明者)说:“简单性是可靠性的先决条件。”
所以现在我的网站结构更简单了,访问更快捷了,维护更容易了,感觉天都更蓝了!
未标明出处的配图由 FLUX-dev 生成。