AI 运维上手指南

第 5 关 · 让它跑起一个网站

买第二台服务器当生产机,让助手把一个留言板网站跑起来,接上域名和证书。

阶段 1 · 起步

第 5 关

  • 1 到 2 小时
  • 第二台服务器的月费,加一个域名的年费
  • 做完你会得到:一个别人用域名能打开、地址栏带锁的网站
过关后
在这里盖章
做完 0 / 7 步

这一关解决什么

做出一个真的在跑的网站。后面每一关都在它身上动手:给它记账、上监控、做备份、发新版本。

网站是一个留言板:能写留言,留言存在数据库里。它已经打包好了,放在起步仓库里,你不用写代码。

开始前要有: 开发机上的助手能用(第 4 关)。

为什么要第二台机器

助手在开发机上干活,网站在生产机上跑。分开的好处是:助手把开发机弄乱了,网站不受影响。

先看懂

生产机上会跑三个容器,各管一件事:

容器管什么
proxy入口。接住外面来的访问,转给 web
web留言板本体
db数据库,存留言

做完是这个样子:

开发机

/health 是网站留的一个探测地址:访问它,网站会回答自己的版本号,并真的去查一次数据库。后面的监控和自动退回都靠它。

跟着做

买第二台,照第 3 关做一遍

再买一台同样的服务器,内存 2G 就够。然后在你自己的电脑上,把第 3 关的第 2 到 6 步对这台新机器做一遍,只有一处不同:短名字起成 prod。

做完后,在你自己电脑上这两条都要能登上:

ssh dev
ssh prod

让开发机能登上生产机

助手在开发机上,它要能连到生产机。给开发机也做一把钥匙,把公钥放到生产机上。

在你自己的电脑上敲这两条:

ssh dev 'test -f ~/.ssh/id_ed25519 || ssh-keygen -q -t ed25519 -N "" -f ~/.ssh/id_ed25519'
ssh dev 'cat ~/.ssh/id_ed25519.pub' | ssh prod 'cat >> ~/.ssh/authorized_keys'

然后登上开发机,告诉它 prod 是哪台(IP 换成生产机的):

ssh dev
printf 'Host prod\n  HostName 203.0.113.20\n  User ubuntu\n' >> ~/.ssh/config
chmod 600 ~/.ssh/config
ssh prod hostname

最后一条第一次会问 yes/no,输入 yes。它打印出生产机的名字,就通了。

放开网站用的两个端口

网站用 80 和 443 两个端口。要在两个地方放开。

云厂商的防火墙: 进控制台,打开生产机的防火墙页,添加两条规则,放行 TCP 的 80 和 443,来源填全部。

机器自己的防火墙: 在开发机上敲:

ssh prod 'sudo ufw allow 80/tcp && sudo ufw allow 443/tcp'

让助手把网站跑起来

在开发机上启动助手:

cd ~ && claude

对助手说

把 下载到 ~/ops。 然后在 prod 这台机器上:装 Docker 并让 ubuntu 用户能直接用;建 /opt/shop 目录,归 ubuntu 用户;把 ~/ops/site 里的 compose.yaml、proxy、certbot、enable-https.sh 复制到 /opt/shop;在 /opt/shop/.env 里写一行 DB_PASSWORD=一个随机的 32 位字符串,文件权限设成 600;最后在 /opt/shop 里执行 docker compose up -d。 做完访问

它会问你很多次。每次读一遍再允许。它敲的命令大致是这些:

git clone https://cnb.cool/vibeapi/ai-ops-starter.git ~/ops
ssh prod 'curl -fsSL https://get.docker.com | sudo sh && sudo usermod -aG docker ubuntu'
ssh prod 'sudo mkdir -p /opt/shop && sudo chown ubuntu:ubuntu /opt/shop'
scp -r ~/ops/site/compose.yaml ~/ops/site/proxy ~/ops/site/certbot ~/ops/site/enable-https.sh prod:/opt/shop/
ssh prod 'cd /opt/shop && echo "DB_PASSWORD=$(openssl rand -hex 16)" > .env && chmod 600 .env'
ssh prod 'cd /opt/shop && docker compose up -d'

最后它给你看的结果应该是:

{"ok": true, "version": "1.0.0", "messages": 0}
卡住了?

/health 返回的是 "ok": false。 数据库还没准备好,等十秒让它再访问一次。

拉取镜像很慢或者超时。 让助手重试一次 docker compose up -d,已经拉下来的部分不会重拉。

它把 DB_PASSWORD 的值打印出来了。 这次没有大碍,这个密码只在这台机器内部用。第 9 关会让程序自动遮住这类输出。

在浏览器里打开

在你自己电脑的浏览器地址栏输入 http:// 加生产机的 IP,比如 http://203.0.113.20。

你会看到一个标题是「我的小网站跑起来了」的页面。写一条留言,点留言,它出现在下面,页面底部的数字变成「共 1 条留言」。

买一个域名,指到生产机

  1. 买域名:在腾讯云的域名注册页面搜一个喜欢的名字,选最便宜的后缀,买一年。第一次买要先做实名认证,按页面提示填,一般几分钟到一天通过。
  2. 进域名的解析页,添加一条记录:
填哪里填什么
主机记录www
记录类型A
记录值生产机的 IP

等一两分钟,在你自己电脑上验证(域名换成你的):

ping www.你的域名

输出里出现生产机的 IP,就指对了。按 Ctrl + C 停下。

卡住了?

ping 出来的不是生产机的 IP,或者找不到主机。 解析还没生效,等五分钟。还不对,回解析页检查记录值有没有填错。

装上证书

在开发机上敲(域名和邮箱换成你的,邮箱用来接收证书到期提醒):

ssh -t prod 'cd /opt/shop && sudo ./enable-https.sh www.你的域名 你的邮箱'

它做三件事:向证书机构申请一张免费证书;把入口换成带锁的版本;安排好到期前自动续上。结束时打印:

好了:https://www.你的域名

在浏览器里打开这个地址,地址栏有一把锁,留言板还在,刚才那条留言也在。

卡住了?

申请证书失败,提示连不上你的域名。 三个原因里的一个:域名没指到这台机器(回上一步);80 端口没放开(回第 3 步,两个地方都要放);网站没在跑(ssh prod docker ps 看三个容器在不在)。

提示申请太频繁。 证书机构对同一个域名每周有次数限制。先把上面三个原因排查清楚,过一小时再试,不要连续重试。

验一次

故意把留言板本体停掉,看会发生什么。在开发机上:

ssh prod 'docker stop web'

刷新浏览器,页面变成 502 Bad Gateway。入口 proxy 还在,但它后面的 web 没了,所以它报错。

再启动:

ssh prod 'docker start web'

等三秒刷新,网站回来了,留言一条没少。留言存在 db 里,停掉 web 不影响它。

你刚才是自己发现网站挂了的。第 10 关之后,这种事会由手机通知你。

过关检查

每一条都亲手验过再打勾。全部打勾,这一关盖章。

还差 4 条

常见卡点

  • 用 IP 能打开,用域名打不开。 解析没生效,或者解析填到了别的机器的 IP。
  • 手机能打开,公司电脑打不开。 有的公司网络会拦新注册的域名,换个网络试。
  • 想改留言板的样子。 第 12 关会讲怎么发新版本。现在先用它原来的样子。

生产环境里是什么样

我们的生产也是这三层:入口、应用、数据库。区别在数量和规矩:入口有好几个,分在不同的机房;应用换版本只能走一条发布命令;数据库有一个实时的备份库。

这一关你已经在用后面每一关的做法了:你说目标,助手去敲命令,你看结果。从下一阶段起,连清单和配置文件也不用你碰。

最后更新于