华为云 ECS 上从零部署一个可观测的 FastAPI 服务:踩坑与验证清单

举报
yd_256110142 发表于 2026/10/25 11:44:17 2026/10/25
【摘要】 以一台 2C4G 的华为云 ECS 为例,把 FastAPI 服务从裸机到可观测(日志、指标、健康检查)完整走一遍,并记录 systemd、安全组、反向代理三个最容易踩的坑。

为什么写这篇

很多同学把「部署」理解成「能 curl 通就行」,上线后第一周就会遇到三类问题:进程莫名其妙退出、日志找不到、监控看不到。这篇把一台华为云 ECS 从裸机到可观测的完整链路写清楚,命令都可以直接复制。

一、机器与网络

规格 2C4G,系统选 Ubuntu 22.04。开服第一件事不是装环境,而是确认安全组:只放通 22 与 443,应用端口 8000 走 Nginx 反代,不对公网暴露。这一步能省掉后面 80% 的扫描噪音。

sudo ufw allow 22/tcp
sudo ufw allow 443/tcp
sudo ufw enable

二、运行环境与依赖隔离

不要用系统 python。用 venv 把依赖钉死,保证测试环境和线上一致。

python3 -m venv /opt/app/venv
/opt/app/venv/bin/pip install -U pip
/opt/app/venv/bin/pip install fastapi "uvicorn[standard]" prometheus-fastapi-instrumentator

三、systemd 托管与自动重启

直接 nohup 起进程是最常见的坑:SSH 断开、OOM、机器重启都会让服务消失。用 systemd 托管,把重启策略和日志一起解决。

[Unit]
Description=fastapi-app
After=network.target

[Service]
User=app
WorkingDirectory=/opt/app
ExecStart=/opt/app/venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000 --workers 2
Restart=always
RestartSec=3
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

写好之后执行 systemctl daemon-reload 与 systemctl enable --now fastapi-app,再用 journalctl -u fastapi-app -f 就能实时看日志,比翻文件省事得多。

四、可观测三件套

指标用 prometheus-fastapi-instrumentator 暴露 /metrics;健康检查单独做一个 /healthz,只返回进程状态与依赖连通性,不要把内部细节吐出去;日志按 JSON 输出,方便后续采集。

from prometheus_fastapi_instrumentator import Instrumentator
Instrumentator().instrument(app).expose(app, endpoint="/metrics")

五、验证清单

  1. kill -9 主进程后 3 秒内自动拉起;
  2. 机器重启后服务自动恢复,本机 curl /healthz 返回 200;
  3. 外网访问 8000 端口应当超时,说明安全组生效;
  4. /metrics 里 http_requests_total 计数在增长;
  5. 日志能按 request_id 串起一次完整调用。

小结

部署不是把进程跑起来,而是让它在异常、重启、流量变化下都能被观测、被恢复。这套流程在 2C4G 的小机器上足够用,后面接云监控也只是把采集端换掉,应用侧不用改。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。